| name | outcome-first-agent-loop-zh |
| description | This skill should be used when 用户需要结果导向 plan 交接：讲解 plan/TLDR、设计 Outcome Validation、设置简短 Codex goal、按 plan 开发、独立审查、真实/受控使用测试、判断是否完成或开发收口，且要避免主 agent 自评完成。 |
结果导向计划交接规则
复杂开发里，plan、聊天摘要、goal、测试结果和 review 证据很容易分散：agent 可能记得“要做什么”，却在开发后用测试绿灯或自评替代真正验收。这个 skill 用在已有 plan 之后，给 agent 增加一层结果导向的交接和收口规则。
这个 skill 是通用叠加层，不绑定任何具体计划、开发或 review 工具，也不替代写 plan、实现代码、代码审查、测试或真实验收。
它只做四件事：
- 讲清 plan 方向：把完整 plan 转成用户能看懂、愿意看的核心说明，帮助人判断方向、边界和取舍是否正确。
- 设计验收标准：把“独立子代理如何验收开发结果”讲成用户可确认的短版说明，并在确认后写回 plan 内自包含的 Outcome Validation / Gate Matrix，给后续 agent 执行。
- 指导开发目标：开发前设置简短、准确、可独立执行的 Codex goal，让后续 agent 即使不再读取本 skill，也能围绕完整 plan、Outcome Validation、Gate Matrix 和证据要求长期执行。
- 卡住完成声明：开发收口或用户问“是否完成”时，要求主 agent 准备当前证据包并按 Gate Matrix 派发独立子代理；缺 gate attestation 时只能 blocked / incomplete。
核心分工：
- 人不需要细读完整长 plan；人需要快速判断方向、边界和验收方式是否符合真实需求。短是手段，可理解和自包含更重要。
- 主 agent 负责读取完整 plan、生成可读说明、把已确认的验收标准写回 plan、设置短 goal、开发和准备当前证据包。
- 完整 plan 和 plan 内“验收标准（Outcome Validation）”是执行标准；其中 Gate Matrix 定义必须验证的 gate、score items、subagent attestation、评分迭代和 complete 授权。聊天说明和 goal 只是交接层。
- 最终通过判定必须来自独立子代理对 required gate 的 attestation。主 agent 可以预检、收集证据和修复缺口，但不能把自评、测试绿灯或 summary 当作完成证明。
- Memory、旧 transcript、旧 scorecard 和旧 review packet 只能当线索；没有映射到当前 plan 并按需重跑时，不能当完成证明。
阶段路由
先判断用户处于哪一段；不确定时读 references/workflow-routing-zh.md。
1. 计划说明
用于“讲一下 plan”“TLDR”“这设计是什么”“给我看方向”。
- 读完整 plan 和用户原始需求；不要只读标题或 summary。
- 输出用户可读的短版方向说明，不复述完整 plan。
- 讲清用户真正要的结果、核心做法、需求对应关系、明确不做什么、关键取舍和成功证据。
- 遇到内部术语、英文缩写、项目私有文件名或机制名时，解释用途；不要把术语本身当解释。
- 原始需求不可见时，明确说明内容是按完整 plan 推断。
- 附完整 plan 路径，并说明完整 plan 才是执行标准。
详细输出规则见 references/plan-tldr-template-zh.md。
2. 验收标准
用于“设计验收标准”“怎么验”“validation”“reviewer 怎么测”“写到 plan 中”。
- 先给用户可读的短版验收说明，用户确认后再写回 plan。
- 短版说明只回答：独立子代理实际验证哪些 gate、谁验证、看什么证据、主要 score items 是什么、什么失败。
- 不展开完整需求编号、reviewer 名单、证据清单或评分表；这些放到 plan 内 Outcome Validation。
- 写回 plan 时，必须把同一套规则展开成自包含 Gate Matrix：gate、独立 verifier、证据、score items、评分迭代、subagent attestation、不可替代证据、失败条件、scope 和 complete 授权不能和短版说明变化。
- 开发型任务默认考虑计划覆盖、代码审查、真实/受控使用和任务特定风险 gate；安全、数据、UI、CLI、性能、迁移、文档或研究质量等按风险补充。
详细规则见 references/validation-contract-zh.md；任务类型映射见 references/task-specific-validation-zh.md。
3. 开发目标
用于“开始开发”“按这个 plan 做”“依据 plan 实现”“设置 goal”。
- 先读完整 plan 和已写回 plan 的 Outcome Validation；缺 Outcome Validation 时回到第 2 段。
- 生成简短 Codex goal，使用任务自己的语言；不要复制 plan，也不要套固定模板。
- goal 必须自包含到足够执行：后续 agent 不应依赖重新读取本 skill 才知道怎么收口。
- goal 必须包含：完整 plan 是开发依据、Outcome Validation / Gate Matrix 是证据收集和独立验收依据、完成范围内工作、收集可复核证据、按 required gate 派发独立子代理。
- goal 必须写入最小收口协议：开发后准备当前证据包，按 Gate Matrix 派发 required gate 的独立 subagent，required score items 按 plan 内评分协议逐项达标，汇总 Final Gate Ledger；缺任何 required gate attestation 或 required score item 未达标时继续修复/补证据/补派验收。
- goal 必须讲清 complete 授权：只有当前证据包齐全、所有 required gate 都有覆盖 scope 的 subagent attestation 且通过、没有未解决的范围/证据/通过条件冲突时，才允许调用
update_goal(status="complete")。
- 缺证据、缺真实/受控使用、缺 required gate attestation、scope 冲突或无法独立验收时，继续修复/补证据/派发验收，或在确实无法推进时 blocked / incomplete。
详细 goal 规则见 references/validation-contract-zh.md。
4. 开发收口
用于“验收一下”“是否完成”“可以收口吗”“done”“complete”，或 agent 准备声明完成时。
- 读完整 plan、Outcome Validation / Gate Matrix、goal、当前开发结果包和当前证据包。
- 主 agent 只准备证据和派发独立验收，不做最终裁判。
- 当前证据至少要覆盖计划覆盖清单、测试/日志/截图/产物、真实或受控使用记录、任务特定风险证据、旧证据映射和 subagent 派发状态。
- subagent 可用时，按 Gate Matrix 派发并等待 attestation；需要评分时，执行者和评分者尽量拆开。
- 主 agent 汇总 Final Gate Ledger，但 ledger 只是证据索引，不是主 agent 自评。
- 只输出三类状态：通过、未通过需修复、阻塞需补证据或补独立验收。
收口闸门见 references/execution-done-gate-zh.md；审查包见 references/independent-review-zh.md；评分规则见 references/review-scoring-zh.md。
输出合同
- 每个阶段末尾给一个短
下一步建议，不要自动越过用户确认、写文件、开发或审查 gate。
- 计划说明只给短版方向说明、plan 路径和下一步建议。
- 验收标准先给短版说明；只有用户确认后才写回 plan。
- 开发目标只给短 goal 正文和前置 gate 状态。
- 开发收口只给状态、Final Gate Ledger 摘要、证据缺口、已派发或需要派发的独立子代理 attestation、blocked 原因或最小修复包。
硬门槛
- 不把主 agent 自评、测试绿灯、summary、memory 或旧 review packet 当完成证明。
- 不把 skill reference 当运行时必读前提；第二阶段写回 plan、第三阶段写入 goal 的内容必须让后续 agent 不重读本 skill 也能执行和收口。
- 不让独立子代理读取主 agent 隐藏推理、预期答案、完整聊天记录或同轮其他 reviewer 意见。
- 不为了省事把多个 required gate 合并成一个通用评分者；低风险单维任务例外，但 Gate Matrix 或证据包必须说明理由。
- 可运行、可交互、可交付或面向用户 / agent 使用的任务必须有真实或受控核心路径记录。
- 如果 plan 要求真实端到端验证，mock、stub、preview、内存样例或单元测试只能算补充证据，不能替代该场景。
- 邮件、发布、付款、删除数据、生产提交等外部动作默认用 mock、dry-run、sandbox、preview 或受控样例验证。
Reference 路由
不要一次性读取所有 reference。按阶段选择最小必要文件：
references/workflow-routing-zh.md：判断当前阶段和 gate。references/plan-tldr-template-zh.md：解释 plan 方向。references/validation-contract-zh.md：生成短版验收说明、写回 Outcome Validation / Gate Matrix、生成短 goal。references/gate-subagent-contract-zh.md：定义 Gate Matrix、Subagent Attestation、Final Gate Ledger 和 complete 授权。references/task-specific-validation-zh.md：把通用验收映射到具体任务类型。references/execution-done-gate-zh.md：开发收口和完成判断。references/independent-review-zh.md：构造独立子代理审查包。references/review-scoring-zh.md：per-gate 评分、直接失败条件和修复循环。
