outcome-first-agent-loop-zh

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、实现代码、代码审查、测试或真实验收。

它只做四件事：

1. 讲清 plan 方向：把完整 plan 转成用户能看懂、愿意看的核心说明，帮助人判断方向、边界和取舍是否正确。
2. 设计验收标准：把“独立子代理如何验收开发结果”讲成用户可确认的短版说明，并在确认后写回 plan 内自包含的 Outcome Validation / Gate Matrix，给后续 agent 执行。
3. 指导开发目标：开发前设置简短、准确、可独立执行的 Codex goal，让后续 agent 即使不再读取本 skill，也能围绕完整 plan、Outcome Validation、Gate Matrix 和证据要求长期执行。
4. 卡住完成声明：开发收口或用户问“是否完成”时，要求主 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 评分、直接失败条件和修复循环。