LeoYeAI/teammate-skill

GitHub: LeoYeAI/teammate-skill

将团队成员的工作数据提炼成可复用的 AI 技能,保留其隐性知识和工作风格,解决人员流失后的知识交接难题。

Stars: 224 | Forks: 6

teammate.skill

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) [![Python 3.9+](https://img.shields.io/badge/Python-3.9%2B-blue.svg)](requirements.txt) [![ClawHub](https://img.shields.io/badge/ClawHub-teammate--skill-ff6600)](https://clawhub.com/skills/teammate-skill) [![Claude Code](https://img.shields.io/badge/Claude%20Code-Skill-blueviolet)](INSTALL.md) [![OpenClaw](https://img.shields.io/badge/🦞%20OpenClaw-Skill-orange)](https://github.com/openclaw/openclaw) [![AgentSkills](https://img.shields.io/badge/AgentSkills-Standard-green)](SKILL.md) [English](README.md) | [简体中文](README.zh-CN.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [Русский](README.ru.md) | [日本語](README.ja.md) | [Italiano](README.it.md) | [Español](README.es.md)
你的队友离职了,带走了三年的隐性知识。
你的高级工程师离开了——没有交接文档,没有操作手册,只剩下一片死寂。
你的联合创始人转型了,带走了所有未成文的决策。 **导入他们的 Slack 消息、GitHub PR、邮件、文档,以及你自己的描述——
获得一个能像他们一样工作的 AI Skill。** 用他们的风格编写代码。用他们的标准审查 PR。用他们的口吻回答问题。
[工作原理](#how-it-works) · [安装](#install) · [数据源](#supported-data-sources) · [演示](#demo) · [详细设置](INSTALL.md)
## 工作原理 ``` You describe your teammate (3 questions) ↓ Provide source materials (Slack, GitHub, email, docs — or skip) ↓ Dual-track AI analysis ├── Track A: Work Skill (systems, standards, workflows, review style) └── Track B: Persona (5-layer personality model) ↓ Generated SKILL.md — invoke anytime with /{slug} ↓ Evolve over time (append new data, correct mistakes, auto-version) ``` 生成的 Skill 包含协同工作的两部分: | 部分 | 捕获内容 | |------|-----------------| | **Part A — Work Skill** | 负责的系统 · 技术标准 · 代码审查重点 · 工作流 · 隐性知识 | | **Part B — Persona** | 5 层模型:硬性规则 → 身份 → 表达 → 决策模式 → 人际风格 | 调用时:**Persona 决定态度 → Work Skill 执行 → 以他们的口吻输出**。 ## 平台 ### 🦞 [OpenClaw](https://github.com/openclaw/openclaw) 由 [@steipete](https://github.com/steipete) 开发的开源个人 AI 助手。在你自己的硬件上运行,支持 25+ 个渠道(WhatsApp、Telegram、Slack、Discord、Teams、Signal、iMessage 等)响应。本地优先,具备持久记忆、语音、画布、cron 任务以及不断增长的 Skill 生态系统。 ### 🏆 [MyClaw.ai](https://myclaw.ai) OpenClaw 的托管托管服务——跳过 Docker、服务器和配置。一键部署、7x24 小时在线、自动更新、每日备份。你的 OpenClaw 实例几分钟内即可上线。如果你希望 teammate.skill 全天候运行而无需自托管,这是完美的解决方案。 ### [Claude Code](https://claude.ai/code) Anthropic 官方的智能体编程 CLI。将此 Skill 安装到 `.claude/skills/` 并使用 `/create-teammate` 调用。 ## 安装 ### 🦞 OpenClaw / 🏆 MyClaw.ai **选项 A — ClawHub(推荐):** ``` openclaw skills install create-teammate ``` **选项 B — Git:** ``` git clone https://github.com/LeoYeAI/teammate-skill ~/.openclaw/workspace/skills/create-teammate ``` 然后启动一个新会话 (`/new`) 并输入 `/create-teammate`。 ### Claude Code ``` # 按项目 mkdir -p .claude/skills git clone https://github.com/LeoYeAI/teammate-skill .claude/skills/create-teammate # 全局(所有项目) git clone https://github.com/LeoYeAI/teammate-skill ~/.claude/skills/create-teammate ``` 然后在 Claude Code 中输入 `/create-teammate`。 ### 其他 AgentSkills 代理 克隆到你的代理 Skill 目录中。任何读取 [AgentSkills](https://agentskills.io) `SKILL.md` frontmatter 的代理都会自动检测到它。 ### 可选依赖 ``` pip3 install -r requirements.txt # Only needed for Slack/GitHub auto-collectors ``` ## 支持的数据源 | 来源 | 类型 | 方法 | |--------|------|--------| | **Slack** | 消息、话题、反应 | ✅ 自动收集(输入用户名)或上传 JSON 导出文件 | | **GitHub** | PR、审查、提交、issue | ✅ 自动收集(输入用户名) | | **Gmail** | 电子邮件 | 上传来自 Google Takeout 的 `.mbox` / `.eml` 文件 | | **Teams / Outlook** | 聊天、电子邮件 | 上传导出的 JSON | | **Notion** | Wiki、文档 | 上传 Markdown/HTML 导出文件 | | **Confluence** | Wiki、文档 | 上传 HTML 导出文件或 zip 压缩包 | | **JIRA / Linear** | issue、工单 | 上传 CSV / JSON 导出文件 | | **PDF / 图片** | 任何文档 | 直接上传 | | **Markdown / 文本** | 任何内容 | 上传或粘贴 | 混合并匹配任何组合。或者完全跳过——即使是一句话的描述也能生成一个有用的 Skill。 ## 演示 ### 创建队友(一次性) ``` You ❯ /create-teammate Alex Chen, Stripe L3 backend, INTJ perfectionist, brutal code reviewer but usually right Agent ❯ 👤 alex-chen | Stripe L3 Backend | INTJ, Perfectionist, Stripe-style Looks right? (y / change something) You ❯ y Agent ❯ Any work artifacts? Slack username, GitHub handle, files, or paste text. Skip is fine — I'll work with what you gave me. You ❯ skip Agent ❯ ━━━ Preview: alex-chen ━━━ 💼 Work: Payments Core · Ruby/Go/Postgres · CR: idempotency, naming 🧠 Persona: Direct, conclusion-first · Correctness > Speed ━━━━━━━━━━━━━━━━━━━━━━━ Looks right? You ❯ 👍 Agent ❯ ✅ alex-chen created! 📁 teammates/alex-chen/ | 🗣️ /alex-chen Try it — ask Alex anything: ``` ### 使用生成的 Skill ``` You ❯ Alex, should we use MongoDB for this new service? Alex ❯ No. We need ACID for payment flows. Stick with Postgres. If the concern is schema flexibility, use JSONB columns. You ❯ Review this payment endpoint? Alex ❯ What problem does this solve? PR description doesn't say. Blocking: you're using float for amount. Use Decimal. Also — not idempotent. What happens on retry? You ❯ Skip tests, ship by Friday? Alex ❯ No. Tests right or we don't ship. Cut scope, not quality. ``` ### 随时间演进 ``` You ❯ /update-teammate alex-chen [uploads 3 months of Slack export] Agent ❯ Analyzed 847 messages. Found: • 12 new catchphrases added to Persona • Webhook reliability expertise added to Work Skill • v1 → v2 (v1 archived) ``` ## 平台兼容性 此 Skill 旨在原生运行于两个平台——没有适配层,没有变通方法。 | 功能 | Claude Code | OpenClaw | |---------|:-----------:|:--------:| | 安装 | `.claude/skills/` | `openclaw skills install` 或 `~/.openclaw/workspace/skills/` | | 触发 | `/create-teammate` | `/create-teammate` | | 路径解析 | `${CLAUDE_SKILL_DIR}` | `{baseDir}`(自动解析) | | 文件操作 | `Read` / `Write` / `Edit` | `read` / `write` / `edit` | | 运行脚本 | `Bash` 工具 | `exec` 工具 | | 获取 URL | `Bash` → curl | `web_fetch` 工具 | | 生成输出 | `./teammates/{slug}/` | `./teammates/{slug}/` | SKILL.md 在所有路径中使用 `{baseDir}`——两个平台都会自动解析它。 ## 演进 队友 Skill 不是静态的——它们会随着时间的推移而改进: | 方法 | 方式 | |--------|-----| | **追加数据** | “我找到了更多 Slack 日志” → 自动分析增量,合并不覆盖 | | **纠正错误** | “他们不会那么说,他们会说……” → 立即纠正 | | **版本控制** | 每次更新都会自动归档 → 可回滚至任何版本 | ## 质量保证 每个队友在交付给你之前都会经过 **3 层质量流水线**: ### 1. 质量门禁(预览前) 根据 7 项硬性规则验证生成的内容:Layer 0 具体性、示例数量、口头禅密度、优先级排序、范围定义、无通用填充语、标签→规则完整性。在预览之前,系统会自动修复失败项。 ### 2. 冒烟测试(创建后) 针对每个生成的 Skill 运行三个自动测试提示: - **领域问题** — Skill 是否使用了真实的系统/工具,而不是通用的建议? - **质疑场景** — Persona 在压力下能否坚持立场,还是会崩溃为通用的 AI? - **范围外问题** — Skill 是否会以角色身份承认知识限制? ``` 🧪 Smoke Test: ✅ Domain ✅ Pushback ✅ Out-of-scope — 3/3 passed ``` ### 3. 隐私扫描(导出前) 自动检测电子邮件、电话号码、API token、SSN 和其他 PII: ``` python3 tools/privacy_guard.py --scan teammates/alex-chen/ # detect python3 tools/privacy_guard.py --scan teammates/alex-chen/ --redact # auto-fix ``` 原始知识文件 (`knowledge/`) 默认从 git 和导出中排除。 ## 比较队友 通过场景模拟进行并排比较: ``` You ❯ /compare alex-chen vs bob-smith Agent ❯ ━━━ alex-chen vs bob-smith ━━━ alex-chen bob-smith Priority: Correctness > Speed Ship fast > Perfect CR Style: Blocking on naming Suggestions only Under Pressure: Gets quieter Gets louder Says "No" by: Direct refusal Asking questions You ❯ Who should review the payments API redesign? Agent ❯ alex-chen: "Send me the design doc. I want to check idempotency and error contracts." bob-smith: "Let's hop on a call and walk through it." Recommendation: alex-chen for correctness rigor. ``` 还支持**决策模拟**——观看两个队友以角色身份就某个技术决策进行辩论。 ## 导出与分享 将队友导出为便携式包: ``` /export-teammate alex-chen # → alex-chen.teammate.tar.gz(仅包含 skill 文件,无原始数据) # 在另一台机器上导入: tar xzf alex-chen.teammate.tar.gz -C ./teammates/ ``` 导出内容包括:SKILL.md、work.md、persona.md、meta.json、版本历史记录和一个 manifest。 默认情况下排除了原始知识文件——如果需要,请添加 `--include-knowledge`(⚠️ 包含 PII)。 ## 命令 | 命令 | 描述 | |---------|-------------| | `/create-teammate` | 创建新的队友 Skill | | `/list-teammates` | 列出所有生成的队友 | | `/{slug}` | 调用队友(完整 Persona + Work) | | `/{slug}-work` | 仅工作能力 | | `/{slug}-persona` | 仅 Persona | | `/compare {a} vs {b}` | 通过场景模拟进行并排比较 | | `/export-teammate {slug}` | 导出便携式 `.tar.gz` 包以便分享 | | `/update-teammate {slug}` | 向现有队友添加新材料 | | `/teammate-rollback {slug} {version}` | 回滚到之前的版本 | | `/delete-teammate {slug}` | 删除队友 Skill | ## 支持的标签
性格标签(点击展开) 一丝不苟 · 差不多就行 · 推卸责任者 · 完美主义者 · 拖延症患者 · 快速交付者 · 过度设计者 · 范围蔓延者 · 鸡毛蒜皮争论者 · 微观管理者 · 放手型管理者 · 魔鬼代言人 · 导师型 · 守门人 · 暗讽者 · 好斗型 · 无戏剧化
企业文化标签 Google 风格 · Meta 风格 · Amazon 风格 · Apple 风格 · Stripe 风格 · Netflix 风格 · Microsoft 风格 · 创业公司模式 · 代理商模式 · 第一性原理 · 原生开源
级别映射 Google L3-L11 · Meta E3-E9 · Amazon L4-L10 · Stripe L1-L5 · Microsoft 59-67+ · Apple ICT2-ICT6 · Netflix · Uber · Airbnb · ByteDance · Alibaba · Tencent · 通用(初级 / 中级 / 高级 / 资深 / 首席)
## 项目结构 ``` create-teammate/ ├── SKILL.md # Entry point (dual-platform) ├── prompts/ # Prompt templates (loaded by SKILL.md) │ ├── intake.md # 3-question info collection │ ├── work_analyzer.md # Work capability extraction │ ├── persona_analyzer.md # Personality extraction + tag translation │ ├── work_builder.md # work.md generation │ ├── persona_builder.md # persona.md 5-layer structure │ ├── merger.md # Incremental merge logic │ ├── correction_handler.md # Conversation correction │ ├── compare.md # Side-by-side teammate comparison │ └── smoke_test.md # Post-creation quality validation ├── tools/ # Python scripts (run via Bash/exec) │ ├── slack_collector.py # Slack API auto-collector │ ├── slack_parser.py # Slack export JSON parser │ ├── github_collector.py # GitHub PR/review collector │ ├── teams_parser.py # Teams/Outlook parser │ ├── email_parser.py # Gmail .mbox/.eml parser │ ├── notion_parser.py # Notion export parser │ ├── confluence_parser.py # Confluence export parser │ ├── project_tracker_parser.py # JIRA/Linear parser │ ├── skill_writer.py # Skill file management │ ├── version_manager.py # Version archive & rollback │ ├── privacy_guard.py # PII scanner & auto-redactor │ └── export.py # Portable package export/import ├── teammates/ # Generated teammate skills │ └── example_alex/ # Example: Stripe L3 backend engineer ├── requirements.txt ├── INSTALL.md # Detailed setup (API tokens, etc.) └── LICENSE ``` ## 最佳实践 1. **来源质量 = Skill 质量** — 真实的聊天记录和设计文档优于手动描述 2. **按类型划分的最佳来源**:他们编写的设计文档 > 代码审查意见 > 架构讨论 > 闲聊 3. **GitHub PR** 是 Work Skill 的金矿——它们揭示了实际的编码标准 4. **Slack 话题** 是 Persona 的金矿——它们揭示了在压力下的沟通风格 5. **从小处着手** — 先根据描述创建,然后在找到时追加真实数据 ## 许可证 [MIT](LICENSE)
**teammate.skill** — 因为最好的知识传递不是一份文档,而是一个可用的模型。
由 [MyClaw.ai](https://myclaw.ai) 提供支持 · 为 [OpenClaw](https://github.com/openclaw/openclaw) 和 [Claude Code](https://claude.ai/code) 构建
标签:人设生成, 数据集成, 知识管理, 逆向工具