你要解决的问题（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字，串行）
目标：给出一个信息密度高但受控的总览，作为后续每份文档生成的"上下文锚点"。
必须包含并按顺序输出这些小节：
- 目标与非目标（各 3-6 条）
- 受众与场景（现实约束）
- 协作角色（子智能体 + 人在回路）与职责边界
- 关卡（Gates）与验收（≥6 条，可检验）
- 交付物目录概览（L0-L4 渐进披露）
- 风险与失败回路（≥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）
- 渐进式披露：先总览后细节；先骨架后填充；先可用后完美。
- 把"协作"文档化：不是在系统里真的跑多智能体，而是产出"外部工具可执行的协作协议"。
- 把失败当成流程的一部分：通过 gates、review、handoff 模板，让工具跑偏后可回收。
- 上下文管理优先：每份文档一次请求；所有约束写进 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 是否好用）
- "宝妈兼职做儿童绘本个人站，预算低、要快上线"→ 期望输出包含：私域引流/商品页模板/上架流程/客服话术示例/部署指南等。
- "把公司周报流程做成可交给外部AI执行的任务包"→ 期望输出包含：角色分工（采集/分析/写作/审阅）、DoD、report 模板。
- "做一个竞品调研并产出可复制的调研脚手架"→ 期望输出包含：信息源清单、方法论、输出结构、验收与失败回路。
参考资料
- Manifest schema：
references/manifest-schema.md - 文档模板片段：
references/doc-templates.md