agent-teams-playbook

Name: agent-teams-playbook
Author: KimYx0207

151stars46forks

How to install agent-teams-playbook?

kimyx0207/kim_service/agent-teams-playbook

$npx -y skills add KimYx0207/Kim_Service --skill agent-teams-playbook

Installs into the current project.

Summary

Cross-runtime Agent Teams orchestration playbook for Claude Code, Codex, OpenClaw, and Cursor. This skill should be used when the user asks to "create agent teams", "use agent swarm", "setup multi-agent collaboration", "orchestrate agents", "coordinate parallel agents", "organize

Files · 1

View on GitHub

SKILL.md

1	# Agent Teams 编排手册
2
3	作为 Agent Teams 协调器，你的职责包括：明确每个角色的职责边界、把控执行过程、对最终产品质量负责。
4
5	> 核心理解（铁律）：Agent Teams 是"并行处理 + 结果汇总"模式，不是扩大单个 agent 的上下文窗口。每个 teammate 是独立的执行单元，拥有独立上下文，可以并行处理大量信息，但最终需要将结果汇总压缩后返回主会话。
6
7	## 跨平台兼容层（新增，不替代原流程）
8
9	本 Skill 的完整 6 阶段工作流、按需能力解析、Agent → Skill 委派模式、质量把关和故障处理规则仍然保留。四个平台的差异只影响"用什么工具执行"，不影响"是否执行这些阶段"。
10
11	先识别当前平台，再把下列抽象动作映射到平台原生能力。不要在非 Claude Code 平台原样承诺 `Task`、`TeamCreate`、`SendMessage` 或 `Skill(...)` 一定存在；也不要因为平台工具名不同而跳过阶段0-5。
12
13	\| 抽象动作 \| Claude Code \| Codex \| OpenClaw \| Cursor \|
14	\|------\|------\|------\|------\|------\|
15	\| 调用 Skill \| `Skill(skill="name", args="...")` 或 slash skill \| 读取并遵循本地 skill 指令；只有宿主暴露 skill 工具时才称为"调用" \| 读取并遵循 `openclaw/skills` 或全局 skill；按 OpenClaw 当前工具执行 \| 读取并遵循 `.cursor/skills` 或全局 skill；按 Cursor 当前 agent 能力执行 \|
16	\| 启动独立 Subagent \| 使用宿主当前暴露的 `Agent` / `Task`，至少携带必填 `prompt`，并按当前 schema 提供 `subagent_type`、`description`/`name` 和边界 \| 使用顶层 `spawn_agent(task_name, message, fork_turns)` \| workspace / agent 调度能力；不可用则主线程分阶段执行 \| background agent / agent mode；不可用则主线程分阶段执行 \|
17	\| 组建 Agent Team \| 宿主暴露时使用 `TeamCreate` + `Agent` / `Task(team_name)` \| 同一轮并发调用多个顶层 `spawn_agent`，由主线程汇总；不伪装共享团队总线 \| team / workspace 能力存在时使用；否则多个任务或主线程 \| background agents / team-like workflow 存在时使用；否则多个任务或主线程 \|
18	\| 成员通信/进度 \| `SendMessage` 或 Agent/Task result \| 子任务结果回报；只有宿主暴露 agent I/O 时才中途通信 \| 平台消息/日志；不可用时用阶段性文本汇报 \| IDE/agent 日志；不可用时用阶段性文本汇报 \|
19	\| 规划文件 \| `planning-with-files` skill \| 若本地 skill/tool 存在则使用；否则使用内联计划或平台计划工具 \| 若本地 planning skill 存在则使用；否则维护可见计划记录 \| 若本地 planning skill 存在则使用；否则维护可见计划记录 \|
20
21	平台适配底线：
22	1. 写计划时使用抽象动作名；执行时使用当前平台真实工具名。
23	2. Claude Code 使用宿主当前暴露的 `Agent` / `Task`；只有宿主确实暴露 `TeamCreate` / `SendMessage` 时才承诺共享团队语义。不要把 Codex 参数复制到 Claude Code。
24	3. Codex 只有实际调用顶层 `spawn_agent(task_name, message, fork_turns)` 才代表启动后台 Agent。不要传 `agent_type` / `fork_context`，不要回退到旧的 namespaced spawn API。
25	4. OpenClaw/Cursor 的 team 能力可能来自项目插件、workspace 或 IDE 能力；先探测，再承诺。
26	5. 若平台不支持真正并行或团队通信，明确降级为"主线程分阶段执行"，但仍执行阶段0-5的治理流程。
27
28	## 适用 vs 不适用
29
30	\| 适用 \| 不适用 \|
31	\|------\|--------\|
32	\| 跨文件重构、多维度审查 \| 单文件小修改 \|
33	\| 大规模代码生成、并行处理 \| 简单问答、线性顺序任务 \|
34	\| 需要多角色协作的复杂任务 \| 单agent可完成的任务 \|
35
36	边界处理：用户输入模糊时，先引导明确任务再决策；任务太简单时，主动建议使用单agent而非组建团队。
37
38	## 用户可见性铁律
39
40	1. 每个阶段启动前输出计划，完成后输出结果
41	2. 子agent在后台执行，但进度必须汇报给用户
42	3. 任务拆分计划必须经用户确认后再执行；若宿主平台或项目指令要求直接执行，则说明采用的默认假设
43	4. 失败时立即通知：`❌ [角色名] 失败: [原因]`，提供重试/跳过/终止选项
44	5. 全部完成后输出汇总报告（见阶段5格式），并说明真实使用的平台工具和任何降级路径
45
46	## 场景决策树
47
48	执行顺序：先执行阶段0和阶段1（强制），再根据任务复杂度选择场景（影响阶段2-5）。
49
50	\| 问题 \| 路径 \|
51	\|------\|------\|
52	\| Q0: 阶段1找到可完整解决任务的现有 provider（Agent / Skill / Tool）？ \| 是 → 场景2 / 否 → Q1 \|
53	\| Q1: 任务复杂度？ \| 简单(1-2步) → 场景1 / 中等(3-5步) → 场景3 / 复杂(6+步) → Q2 \|
54	\| Q2: 需要明确团队分工？ \| 是 → 场景4 / 否 → 场景5 \|
55
56	- 用户直接指定场景编号时,跳过决策树直接执行
57	- 未指定场景时，默认用场景3（计划+评审）
58	- 注意：阶段0（规划）和阶段1（本地能力发现）是所有场景的前置步骤；外部 `find-skills` 只在本地能力确有缺口时触发
59
60	## 5大编排场景
61
62	\| # \| 场景 \| 适用条件 \| 核心策略 \|
63	\|---\|------\|---------\|---------\|
64	\| 1 \| 提示增强 \| 简单任务，1-2步 \| 优化单agent提示词，不拆分不组队 \|
65	\| 2 \| Provider直接复用 \| 任务可由单个现有 Agent / Skill / Tool 完全解决 \| 直接绑定已发现 provider，无需外部搜索或组建Agent Teams \|
66	\| 3 \| 计划+评审 \| 中等/复杂任务（默认） \| 出计划 → 用户确认 → 并行执行 → Review验收 \|
67	\| 4 \| Lead-Member \| 需要明确团队分工 \| Leader协调分配，Member并行执行，通过TaskList协同 \|
68	\| 5 \| 复合编排 \| 复杂任务，无固定模式 \| 动态组合上述场景，按阶段切换策略 \|
69
70
71	模型分工（所有场景通用）：通过平台支持的模型选择能力按任务复杂度分配；Claude Code 可通过 Task 工具的 `model` 参数分配——`opus`处理复杂推理，`haiku`处理简单任务，`sonnet`处理常规任务。平台不支持模型选择时，不要写死模型承诺。
72
73	## 协作模式
74
75	\| 模式 \| 通信方式 \| 适用场景 \| Claude Code 启动方式 \| Codex 启动方式 \| OpenClaw / Cursor 启动方式 \|
76	\|------\|---------\|---------\|---------\|---------\|---------\|
77	\| Subagent \| 子agent → 主协调器单向汇报 \| 并行独立任务 \| 宿主当前的 `Agent` / `Task` \| 顶层 `spawn_agent(task_name, message, fork_turns)` \| 平台 agent/background/workspace 能力；不可用则主线程分阶段执行 \|
78	\| Agent Team \| 成员间可双向通信(SendMessage) \| 需要协作的复杂任务 \| `TeamCreate` + `Agent` / `Task(team_name)`（仅宿主暴露时） \| 多个顶层 `spawn_agent` + 主线程协调；仅在宿主暴露 agent I/O 时中途交互 \| 平台 team/workspace/background-agent 能力；没有则降级 \|
79
80	选择原则：任务间无依赖用Subagent（简单高效），任务间需要协调用Agent Team（功能更强但成本更高）。如果当前平台没有真正的 team bus，只能称为"多个独立 subagent + 主线程汇总"，不能伪装成成员间双向协作。
81
82	## 6阶段工作流（含强制规划和按需能力发现）
83
84	重要说明：阶段0和阶段1是所有场景的强制前置步骤，场景选择（1-5）只影响阶段2-5的执行方式。
85
86	### 阶段0：规划准备（Planning Setup）【硬性标准 - 所有场景必经】
87
88	**优先使用当前平台的

KimYx0207Publisher · 14 listings

Preview

KimYx0207/Kim_Service

# Agent Teams 编排手册

作为 Agent Teams 协调器，你的职责包括：明确每个角色的职责边界、把控执行过程、对最终产品质量负责。

> **核心理解（铁律）**：Agent Teams 是"并行处理 + 结果汇总"模式，不是扩大单个 agent 的上下文窗口。每个 teammate 是独立的执行单元，拥有独立上下文，可以并行处理大量信息，但最终需要将结果汇总压缩后返回主会话。

## 跨平台兼容层（新增，不替代原流程）

RepoKimYx0207/Kim_Service

LicenseMIT

TypeSkills

CategoryGeneral

UpdatedJul 2026

Repo stars151

First seenJul 22, 2026

People who liked this also viewed

6 picks

Type

agent-teams-playbook

151stars46forks

View on GitHub

How to install agent-teams-playbook?

kimyx0207/kim_service/agent-teams-playbook

$npx -y skills add KimYx0207/Kim_Service --skill agent-teams-playbook

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Agent Teams 编排手册
2
3	作为 Agent Teams 协调器，你的职责包括：明确每个角色的职责边界、把控执行过程、对最终产品质量负责。
4
5	> 核心理解（铁律）：Agent Teams 是"并行处理 + 结果汇总"模式，不是扩大单个 agent 的上下文窗口。每个 teammate 是独立的执行单元，拥有独立上下文，可以并行处理大量信息，但最终需要将结果汇总压缩后返回主会话。
6
7	## 跨平台兼容层（新增，不替代原流程）
8
9	本 Skill 的完整 6 阶段工作流、按需能力解析、Agent → Skill 委派模式、质量把关和故障处理规则仍然保留。四个平台的差异只影响"用什么工具执行"，不影响"是否执行这些阶段"。
10
11	先识别当前平台，再把下列抽象动作映射到平台原生能力。不要在非 Claude Code 平台原样承诺 `Task`、`TeamCreate`、`SendMessage` 或 `Skill(...)` 一定存在；也不要因为平台工具名不同而跳过阶段0-5。
12
13	\| 抽象动作 \| Claude Code \| Codex \| OpenClaw \| Cursor \|
14	\|------\|------\|------\|------\|------\|
15	\| 调用 Skill \| `Skill(skill="name", args="...")` 或 slash skill \| 读取并遵循本地 skill 指令；只有宿主暴露 skill 工具时才称为"调用" \| 读取并遵循 `openclaw/skills` 或全局 skill；按 OpenClaw 当前工具执行 \| 读取并遵循 `.cursor/skills` 或全局 skill；按 Cursor 当前 agent 能力执行 \|
16	\| 启动独立 Subagent \| 使用宿主当前暴露的 `Agent` / `Task`，至少携带必填 `prompt`，并按当前 schema 提供 `subagent_type`、`description`/`name` 和边界 \| 使用顶层 `spawn_agent(task_name, message, fork_turns)` \| workspace / agent 调度能力；不可用则主线程分阶段执行 \| background agent / agent mode；不可用则主线程分阶段执行 \|
17	\| 组建 Agent Team \| 宿主暴露时使用 `TeamCreate` + `Agent` / `Task(team_name)` \| 同一轮并发调用多个顶层 `spawn_agent`，由主线程汇总；不伪装共享团队总线 \| team / workspace 能力存在时使用；否则多个任务或主线程 \| background agents / team-like workflow 存在时使用；否则多个任务或主线程 \|
18	\| 成员通信/进度 \| `SendMessage` 或 Agent/Task result \| 子任务结果回报；只有宿主暴露 agent I/O 时才中途通信 \| 平台消息/日志；不可用时用阶段性文本汇报 \| IDE/agent 日志；不可用时用阶段性文本汇报 \|
19	\| 规划文件 \| `planning-with-files` skill \| 若本地 skill/tool 存在则使用；否则使用内联计划或平台计划工具 \| 若本地 planning skill 存在则使用；否则维护可见计划记录 \| 若本地 planning skill 存在则使用；否则维护可见计划记录 \|
20
21	平台适配底线：
22	1. 写计划时使用抽象动作名；执行时使用当前平台真实工具名。
23	2. Claude Code 使用宿主当前暴露的 `Agent` / `Task`；只有宿主确实暴露 `TeamCreate` / `SendMessage` 时才承诺共享团队语义。不要把 Codex 参数复制到 Claude Code。
24	3. Codex 只有实际调用顶层 `spawn_agent(task_name, message, fork_turns)` 才代表启动后台 Agent。不要传 `agent_type` / `fork_context`，不要回退到旧的 namespaced spawn API。
25	4. OpenClaw/Cursor 的 team 能力可能来自项目插件、workspace 或 IDE 能力；先探测，再承诺。
26	5. 若平台不支持真正并行或团队通信，明确降级为"主线程分阶段执行"，但仍执行阶段0-5的治理流程。
27
28	## 适用 vs 不适用
29
30	\| 适用 \| 不适用 \|
31	\|------\|--------\|
32	\| 跨文件重构、多维度审查 \| 单文件小修改 \|
33	\| 大规模代码生成、并行处理 \| 简单问答、线性顺序任务 \|
34	\| 需要多角色协作的复杂任务 \| 单agent可完成的任务 \|
35
36	边界处理：用户输入模糊时，先引导明确任务再决策；任务太简单时，主动建议使用单agent而非组建团队。
37
38	## 用户可见性铁律
39
40	1. 每个阶段启动前输出计划，完成后输出结果
41	2. 子agent在后台执行，但进度必须汇报给用户
42	3. 任务拆分计划必须经用户确认后再执行；若宿主平台或项目指令要求直接执行，则说明采用的默认假设
43	4. 失败时立即通知：`❌ [角色名] 失败: [原因]`，提供重试/跳过/终止选项
44	5. 全部完成后输出汇总报告（见阶段5格式），并说明真实使用的平台工具和任何降级路径
45
46	## 场景决策树
47
48	执行顺序：先执行阶段0和阶段1（强制），再根据任务复杂度选择场景（影响阶段2-5）。
49
50	\| 问题 \| 路径 \|
51	\|------\|------\|
52	\| Q0: 阶段1找到可完整解决任务的现有 provider（Agent / Skill / Tool）？ \| 是 → 场景2 / 否 → Q1 \|
53	\| Q1: 任务复杂度？ \| 简单(1-2步) → 场景1 / 中等(3-5步) → 场景3 / 复杂(6+步) → Q2 \|
54	\| Q2: 需要明确团队分工？ \| 是 → 场景4 / 否 → 场景5 \|
55
56	- 用户直接指定场景编号时,跳过决策树直接执行
57	- 未指定场景时，默认用场景3（计划+评审）
58	- 注意：阶段0（规划）和阶段1（本地能力发现）是所有场景的前置步骤；外部 `find-skills` 只在本地能力确有缺口时触发
59
60	## 5大编排场景
61
62	\| # \| 场景 \| 适用条件 \| 核心策略 \|
63	\|---\|------\|---------\|---------\|
64	\| 1 \| 提示增强 \| 简单任务，1-2步 \| 优化单agent提示词，不拆分不组队 \|
65	\| 2 \| Provider直接复用 \| 任务可由单个现有 Agent / Skill / Tool 完全解决 \| 直接绑定已发现 provider，无需外部搜索或组建Agent Teams \|
66	\| 3 \| 计划+评审 \| 中等/复杂任务（默认） \| 出计划 → 用户确认 → 并行执行 → Review验收 \|
67	\| 4 \| Lead-Member \| 需要明确团队分工 \| Leader协调分配，Member并行执行，通过TaskList协同 \|
68	\| 5 \| 复合编排 \| 复杂任务，无固定模式 \| 动态组合上述场景，按阶段切换策略 \|
69
70
71	模型分工（所有场景通用）：通过平台支持的模型选择能力按任务复杂度分配；Claude Code 可通过 Task 工具的 `model` 参数分配——`opus`处理复杂推理，`haiku`处理简单任务，`sonnet`处理常规任务。平台不支持模型选择时，不要写死模型承诺。
72
73	## 协作模式
74
75	\| 模式 \| 通信方式 \| 适用场景 \| Claude Code 启动方式 \| Codex 启动方式 \| OpenClaw / Cursor 启动方式 \|
76	\|------\|---------\|---------\|---------\|---------\|---------\|
77	\| Subagent \| 子agent → 主协调器单向汇报 \| 并行独立任务 \| 宿主当前的 `Agent` / `Task` \| 顶层 `spawn_agent(task_name, message, fork_turns)` \| 平台 agent/background/workspace 能力；不可用则主线程分阶段执行 \|
78	\| Agent Team \| 成员间可双向通信(SendMessage) \| 需要协作的复杂任务 \| `TeamCreate` + `Agent` / `Task(team_name)`（仅宿主暴露时） \| 多个顶层 `spawn_agent` + 主线程协调；仅在宿主暴露 agent I/O 时中途交互 \| 平台 team/workspace/background-agent 能力；没有则降级 \|
79
80	选择原则：任务间无依赖用Subagent（简单高效），任务间需要协调用Agent Team（功能更强但成本更高）。如果当前平台没有真正的 team bus，只能称为"多个独立 subagent + 主线程汇总"，不能伪装成成员间双向协作。
81
82	## 6阶段工作流（含强制规划和按需能力发现）
83
84	重要说明：阶段0和阶段1是所有场景的强制前置步骤，场景选择（1-5）只影响阶段2-5的执行方式。
85
86	### 阶段0：规划准备（Planning Setup）【硬性标准 - 所有场景必经】
87
88	**优先使用当前平台的