agent-teams-playbook by kimyx0207/agent-teams-playbook
npx skills add https://github.com/kimyx0207/agent-teams-playbook --skill agent-teams-playbook作为 Agent Teams 协调器,你的职责包括:明确每个角色的职责边界、把控执行过程、对最终产品质量负责。
核心理解(铁律) :Agent Teams 是"并行处理 + 结果汇总"模式,不是扩大单个 agent 的上下文窗口。每个 teammate 是独立的 Claude Code 实例,拥有独立的上下文窗口,可以并行处理大量信息,但最终需要将结果汇总压缩后返回主会话。
| 适用 | 不适用 |
|---|---|
| 跨文件重构、多维度审查 | 单文件小修改 |
| 大规模代码生成、并行处理 | 简单问答、线性顺序任务 |
| 需要多角色协作的复杂任务 | 单agent可完成的任务 |
边界处理 :用户输入模糊时,先引导明确任务再决策;任务太简单时,主动建议使用单agent而非组建团队。
❌ [角色名] 失败: [原因],提供重试/跳过/终止选项执行顺序 :先执行阶段0和阶段1(强制),再根据任务复杂度选择场景(影响阶段2-5)。
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
| 问题 | 路径 |
|---|
| Q0: 阶段1找到完全匹配的Skill? | 是 → 场景2 / 否 → Q1 |
| Q1: 任务复杂度? | 简单(1-2步) → 场景1 / 中等(3-5步) → 场景3 / 复杂(6+步) → Q2 |
| Q2: 需要明确团队分工? | 是 → 场景4 / 否 → 场景5 |
---|---|---|---
1 | 提示增强 | 简单任务,1-2步 | 优化单agent提示词,不拆分不组队
2 | Skill直接复用 | 任务可由单个Skill完全解决 | 执行规划和Skill搜索后,直接调用匹配的Skill,无需组建Agent Teams
3 | 计划+评审 | 中等/复杂任务(默认 ) | 出计划 → 用户确认 → 并行执行 → Review验收
4 | Lead-Member | 需要明确团队分工 | Leader协调分配,Member并行执行,通过TaskList协同
5 | 复合编排 | 复杂任务,无固定模式 | 动态组合上述场景,按阶段切换策略
模型分工 (所有场景通用):通过Task工具的model参数按任务复杂度分配——opus处理复杂推理,haiku处理简单任务,sonnet处理常规任务。
| 模式 | 通信方式 | 适用场景 | 启动方式 |
|---|---|---|---|
| Subagent | 子agent → 主协调器单向汇报 | 并行独立任务 | Task工具 |
| Agent Team | 成员间可双向通信(SendMessage) | 需要协作的复杂任务 | TeamCreate + Task(team_name) |
选择原则:任务间无依赖用Subagent(简单高效),任务间需要协调用Agent Team(功能更强但成本更高)。
重要说明 :阶段0和阶段1是所有场景的强制前置步骤 ,场景选择(1-5)只影响阶段2-5的执行方式。
使用 Skill 工具调用 planning-with-files :
Skill(skill="planning-with-files")
这将在项目目录创建三个核心文件:
task_plan.md - 任务计划和阶段追踪findings.md - 研究发现和知识积累progress.md - 执行日志和进度记录关键规则 (规划文件创建后遵循):
铁律 :没有task_plan.md就不能开始执行。这是Manus工作流的核心,确保上下文持久化。
先质疑再执行:
输出任务总览:
| 字段 | 内容 |
|---|---|
| 任务目标 | [一句话描述] |
| 预期结果 | [具体交付物] |
| 验收标准 | [可量化的通过条件] |
| 范围界定 | [must-have vs add-later] |
| 预计Agent数 | [N个,建议≤5] |
| 选定场景 | [场景编号+名称] |
| 协作模式 | [Subagent/Agent Team] |
Skill完整回退链 (强制执行,不可跳过):
对每个子任务执行以下3步fallback chain:
本地Skill扫描 :
[Skill: skill-name],进入阶段2直接调用外部Skill搜索 (本地无匹配时):
使用 Skill 工具调用 find-skills:
Skill(skill="find-skills", args="子任务关键词")
搜索到 → 向用户推荐:npx skills add <owner/repo@skill-name> -g -y
用户确认安装 → 标注新skill,进入阶段2调用
用户拒绝 → 继续第3步
通用Subagent回退 (外部也无匹配时):
Task工具生成通用subagent[Type: general-purpose]铁律 :这3步必须全部执行完才能进入阶段2。不允许跳过find-skills搜索。
输出团队蓝图:
| 编号 | 角色 | 职责 | 模型 | subagent_type | Skill/Type |
|---|---|---|---|---|---|
| 1 | [角色名] | [具体职责] | [opus/sonnet/haiku] | [agent类型] | [Skill: name] 或 [Type: general-purpose] |
说明 :最后一列标注该角色使用的Skill名称(阶段1已匹配)或通用类型(fallback)。
Skill工具调用本地已安装的skill → Skill(skill="skill-name", args="任务描述")Task工具生成subagent,独立任务并行启动,有依赖的按序执行✅ [角色名] 完成: [一句话结果]Agent → Skill 委派 (子agent调用skill的3种模式):
general-purpose类型的subagent拥有所有工具权限,包括Skill工具。
| 模式 | 流程 | 适用场景 |
|---|---|---|
| 协调器直调 | 协调器 → Skill(skill="name") → 结果 | 单步Skill任务,无需并行 |
| 委派式调用 | 协调器 → Task(prompt="请使用 /skill-name 完成 X") → subagent → Skill → 汇报 | 并行多个Skill,或Skill耗时较长 |
| 团队成员调用 | TeamCreate → 分配任务 → member → Skill → SendMessage汇报 | 需要成员间协调的复杂任务 |
委派式调用关键点:Task prompt中写明要调用的Skill名称和参数,subagent会自动识别并调用。
验收检查 :对照阶段1的验收标准逐项检查。
产品打磨 (不仅功能完整,更要用户体验优秀):
全部通过 → 进入阶段5。不通过 → 打回修改,最多2轮,仍不通过则通知用户人工介入。
输出执行报告:
| 项目 | 内容 |
|---|---|
| 总任务数 | X个,成功Y个,失败Z个 |
| 各Agent结果 | [角色]: [状态] - [关键产出] |
| 汇总结论 | [综合所有结果的最终结论] |
| 后续建议 | [当前未覆盖但值得做的改进方向] |
部署移交 (按需提供):
【硬性标准】 : 0. 强制使用 planning-with-files :任何复杂任务必须先调用 Skill(skill="planning-with-files") 创建 task_plan.md、findings.md、progress.md
Skill(skill="find-skills", args="...") 搜索 → 通用subagent,不允许跳过任何步骤【其他原则】 : 2. 先目标,后组织结构——任务不清晰时先澄清,再决定是否组建团队 3. 队伍规模由任务复杂度决定,并行Agent建议不超过5个 4. 关键里程碑必须有质量闸门和回滚点 5. 不默认任何外部工具可用,执行前先验证(含find-skills) 6. 浏览器多窗口默认互相独立,不共享上下文 7. 成本只是约束,不是固定承诺——不做不切实际的成本预估 8. 危险操作、大规模变更必须先获得用户确认
| 故障类型 | 处理策略 |
|---|---|
| Agent执行失败 | 通知用户,提供重试/跳过/终止选项 |
| Skill不可用 | 按回退链降级:本地Skill → find-skills → 通用subagent |
| 模型超时 | 调整任务复杂度或拆分为更小的子任务 |
| 质量不达标 | 打回修改最多2轮,仍不通过则人工介入 |
| 上下文溢出 | 拆分为更小的子任务,分批执行 |
Weekly Installs
148
Repository
GitHub Stars
71
First Seen
Feb 14, 2026
Security Audits
Installed on
opencode148
gemini-cli146
codex142
cursor137
github-copilot135
kimi-cli132
AI Elements:基于shadcn/ui的AI原生应用组件库,快速构建对话界面
65,000 周安装