多智能体协作自动化编排与拆解SKILL

你要解决的问题（Why）

用户往往只给一句话需求，但想要可持续复用的“多智能体协作编排”，并且希望把任务交给外部工具（Claude Code/Codex）去真正落地。直接长提示词一次性写完容易：

• 上下文过大、失败半径大、不可控；
• 输出结构不稳定，难以复用；
• 缺乏“人在回路”的验收关卡，工具跑偏后难以纠偏。

本 skill 的核心是：把一次大输入拆成两次规划 + 多次并行小生成，用“协议 + 关卡 + 模板 + 示例”的形式，产出一个可投喂外部工具执行的编排文件包（doc pack）。

最终交付（What）

输出一个可下载/可复制的目录包，默认包含：

• docs/00-README-Quickstart.md：总体反馈（≈1000字）+ 导航
• docs/10-Protocol/*：角色定义 / 协作协议 / harness 工程约束
• docs/20-Workflow/*：阶段与关卡 / 状态与回路 / DoD（验收定义）
• docs/30-Templates/*：task / checklist / report / handoff 模板
• docs/40-Examples/*：示例输入、示例输出、示例对话片段
• docs/manifest.json：文件清单 + DAG + 每份文档验收点

你可以允许模型在最低骨架基础上“加少量文件”，但必须受控（建议 12~22 个文件）。

工作流总览（How）

严格遵循以下 4 步（前两步串行、后两步并行/轻审查）：

Step 1｜总体反馈（Symbolic Overview，≈1000字，串行）

目标：给出一个信息密度高但受控的总览，作为后续每份文档生成的“上下文锚点”。

必须包含并按顺序输出这些小节：

1. 目标与非目标（各 3-6 条）
2. 受众与场景（现实约束）
3. 协作角色（子智能体 + 人在回路）与职责边界
4. 关卡（Gates）与验收（≥6 条，可检验）
5. 交付物目录概览（L0-L4 渐进披露）
6. 风险与失败回路（≥4 条，含“如何继续让外部工具跑”）

Step 2｜Manifest（严格 JSON，串行）

目标：让模型输出“本次文件清单 + 文档流转关系（DAG）+ 每份文档的验收点”，并保证可解析、可执行、可控。

JSON ONLY。若第一次过长或 JSON 不可解析：

• 进行第 2 次尝试：更少 roles、更少 files、更少 acceptance；
• 仍失败则回退到“最低骨架 + 默认依赖链”。

Manifest schema（核心字段）见：references/manifest-schema.md

Step 3｜分文档并行生成（并行）

目标：把每个文件作为一次独立的大模型请求生成，降低上下文压力与失败半径，并允许大规模并行。

每个文件生成时，只带以下上下文（禁止把全量历史塞回去）：

• 用户原始需求（短）
• Step1 的总体反馈（≈1000字）
• 本文件 filespec：path/title/level/purpose
• 本文件 acceptance（5 条左右）
• 目录内所有 paths（用于导航）
• 若为修订：review 失败原因（逐条修复）

Step 4｜轻量审查与修订（可选、快速）

目标：尽可能让 run快速完成，避免格式性缺失导致整体失败。

推荐的“轻审查”策略：

• Protocol/Workflow/Templates：至少包含用途/输入/输出（建议但不强制验收/失败处理）
• Examples：通常只需要输入/输出（不要被“验收/失败处理”卡住）
• 若失败：只对该文件局部重试 0~2 次（默认 1 次）
• 若仍失败：允许标记为“已生成但轻审查未通过”，不要阻塞整体交付（除非用户要求强一致性）

关键思维方式（Mindset）

1. 渐进式披露：先总览后细节；先骨架后填充；先可用后完美。
2. 把“协作”文档化：不是在系统里真的跑多智能体，而是产出“外部工具可执行的协作协议”。
3. 把失败当成流程的一部分：通过 gates、review、handoff 模板，让工具跑偏后可回收。
4. 上下文管理优先：每份文档一次请求；所有约束写进 acceptance；用 manifest 控制规模。

输出格式要求（必须遵守）

A) Overview 文档（docs/00-README-Quickstart.md）

必须开头即给出“用途一句话 + 文档导航表”，并在文末给出“下一步怎么把包交给 Claude Code/Codex 执行”。

B) 非 JSON 文档（所有 Markdown）

建议结构（模板/示例可简化，但要清晰可复制）：

• 标题
• 用途（1 句话）
• 导航（相对链接）
• 输入
• 输出
• 规则/约束
• 验收（建议）
• 失败处理（建议）

C) Manifest JSON

必须可json.loads()解析；ids 必须稳定；paths 必须以docs/开头。

快速测试用例（给你自己/团队验证 skill 是否好用）

1. “宝妈兼职做儿童绘本个人站，预算低、要快上线”→ 期望输出包含：私域引流/商品页模板/上架流程/客服话术示例/部署指南等。
2. “把公司周报流程做成可交给外部AI执行的任务包”→ 期望输出包含：角色分工（采集/分析/写作/审阅）、DoD、report 模板。
3. “做一个竞品调研并产出可复制的调研脚手架”→ 期望输出包含：信息源清单、方法论、输出结构、验收与失败回路。

参考资料

• Manifest schema：references/manifest-schema.md
• 文档模板片段：references/doc-templates.md