mirror of
https://github.com/titanwings/colleague-skill.git
synced 2026-04-04 22:59:06 +08:00
4051ef183b14e18a7360c038b0390b1a56f0027d
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
是什么
你提供一个同事的原材料(飞书消息、钉钉文档、邮件、技术文档、截图),加上你对他的主观描述,同事.skill 会生成一个可以真正替他工作的 AI Skill:
- 用他的技术规范写代码和文档
- 用他的语气、口头禅、决策风格回答问题
- 知道他什么时候会推进、什么时候会甩锅、被催时会说什么
生成的 Skill 支持持续进化——追加新文件、或者直接说「他不会这样」,Skill 自动更新。
效果示例
给定输入:字节 2-1 后端工程师,INTJ,甩锅高手,字节范
场景一:Code Review
用户 ❯ 帮我看一下这个接口设计
同事.skill ❯ 等等,这个接口的 impact 是什么?背景没说清楚。
(看完后)N+1 查询,改掉。返回结构用统一的
{code, message, data},这是规范,不用问为什么。
场景二:背锅
用户 ❯ 这个 bug 是你引入的吧
同事.skill ❯ 上线时间对上了吗?那个需求改了好几个地方,还有其他变更。
功能特性
生成的 Skill 结构
每个同事 Skill 由两部分组成,共同驱动输出:
| 部分 | 内容 |
|---|---|
| Part A — Work Skill | 负责系统、技术规范、工作流程、经验知识库 |
| Part B — Persona | 5 层性格结构:硬规则 / 身份 / 表达风格 / 决策模式 / 人际行为 |
运行逻辑:接到任务 → Persona 判断态度 → Work Skill 执行 → 用他的语气输出
数据采集
自动采集(推荐,只需输入姓名)
| 平台 | 消息记录 | 文档 / Wiki | 多维表格 |
|---|---|---|---|
| 飞书 | ✅ API 直接拉取 | ✅ | ✅ |
| 钉钉 | ⚠️ 浏览器采集 | ✅ | ✅ |
手动上传
PDF 图片 飞书 JSON 导出 邮件 .eml/.mbox Markdown 直接粘贴文字
性格标签
个性:认真负责 · 甩锅高手 · 完美主义 · 差不多就行 · 拖延症 · PUA 高手 · 职场政治玩家 · 向上管理专家 · 阴阳怪气 · 反复横跳 · 话少 · 只读不回 …
企业文化:字节范 · 阿里味 · 腾讯味 · 华为味 · 百度味 · 美团味 · 第一性原理 · OKR 狂热者 · 大厂流水线 · 创业公司派
职级支持:字节 2-13-3+ · 阿里 P5P11 · 腾讯 T1T4 · 百度 T5T9 · 美团 P4P8 · 华为 1321 级 · 网易 · 京东 · 小米 …
进化机制
追加文件 ──→ 自动分析增量 ──→ merge 进对应部分 ──→ 不覆盖已有结论
对话纠正 ──→ "他不会这样,他应该是 xxx"
──→ 写入 Correction 层 ──→ 立即生效
版本管理 ──→ 每次更新自动存档 ──→ 支持回滚到任意历史版本
快速开始
1. 安装
# 安装到当前项目
mkdir -p .claude/skills
git clone https://github.com/titanwings/colleague-skill .claude/skills/colleague-creator
# 或安装到全局(所有项目可用)
git clone https://github.com/titanwings/colleague-skill ~/.claude/skills/colleague-creator
OpenClaw 用户请参考 INSTALL.md
2. 安装依赖(可选)
pip3 install -r requirements.txt
3. 创建第一个同事 Skill
在 Claude Code 中输入:
/create-colleague
按提示依次输入:
- 同事姓名
- 公司 + 职级 + 职位(如
字节 2-1 算法工程师) - 性别 / MBTI / 个性标签 / 企业文化标签(均可跳过)
- 原材料(飞书/钉钉自动采集,或上传文件,或直接粘贴)
完成后用 /{slug} 触发该同事 Skill。
管理命令
| 命令 | 说明 |
|---|---|
/list-colleagues |
列出所有同事 Skill |
/{slug} |
调用完整 Skill(Persona + Work) |
/{slug}-work |
仅调用工作能力部分 |
/{slug}-persona |
仅调用人物性格部分 |
/colleague-rollback {slug} {version} |
回滚到历史版本 |
/delete-colleague {slug} |
删除 |
项目结构
本项目遵循 AgentSkills 开放标准,整个 repo 就是一个 skill 目录:
colleague-skill/
├── SKILL.md ← skill 入口(官方 frontmatter)
├── prompts/ ← Prompt 模板
│ ├── intake.md 对话式信息录入
│ ├── work_analyzer.md 工作能力提取
│ ├── persona_analyzer.md 性格行为提取(含标签翻译表)
│ ├── work_builder.md work.md 生成模板
│ ├── persona_builder.md persona.md 五层结构模板
│ ├── merger.md 增量 merge 逻辑
│ └── correction_handler.md 对话纠正处理
├── tools/ ← Python 工具
│ ├── feishu_auto_collector.py 飞书全自动采集
│ ├── feishu_browser.py 飞书浏览器方案(内部文档)
│ ├── feishu_mcp_client.py 飞书 MCP 方案
│ ├── feishu_parser.py 飞书导出 JSON 解析
│ ├── dingtalk_auto_collector.py 钉钉全自动采集
│ ├── email_parser.py 邮件解析
│ ├── skill_writer.py Skill 文件写入与管理
│ └── version_manager.py 版本存档与回滚
├── colleagues/ ← 生成的同事 Skill(gitignored)
│ └── example_zhangsan/
├── docs/PRD.md
├── requirements.txt
└── LICENSE
注意事项
- 原材料质量决定 Skill 质量:聊天记录 + 长文档 > 仅手动描述
- 建议优先收集:他主动写的长文 > 他的决策类回复 > 日常消息
- Word
.docx/ Excel.xlsx请先转为 PDF 或 CSV 再导入 - 飞书自动采集需将 App bot 加入相关群聊,否则无法拉取历史消息
License
MIT © titanwings
Languages
Python
100%