需求分析审查

--agent 取值见 .agents/rules/task-management.md「合作者 token 规范」。

若入口业务操作数包含 --orchestrated，绑定 {execution-flag} = --orchestrated 并原样转发给 summary finalizer 与 completed 事件；否则绑定为空。不得从 orchestration.json、环境变量或历史产物推断该标记。生命周期事件还必须携带显式触发信息：编排调用使用 {trigger-initiator}=orchestrator，否则使用 model；{request-id} 是本任务与本轮产物的稳定单行标识，{reason-code} 使用 user-request 或 review-finding；started 与 completed 使用同一组值。

审查最新需求分析产物，并产出 review-analysis.md 或 review-analysis-r{N}.md。

行为边界 / 关键规则

路径与返工

本阶段只消费核心从最新有效分析产物解析出的规范路径事实；未被所选路径包含的阶段不得创建产物。同阶段完成一次修订—复审后再次收到 Changes Requested 时，必须在下一执行产物前提交绑定 finding、来源 SHA 和稳定任务事实摘要的返工分类；轮次或文件名变化不是新证据。

持久化报告证据

生成审查报告时，先读取 .agents/rules/evidence-reporting.md。正常检视记录命令、范围、结构化结果、实际结论和未覆盖部分；finding、阻塞或争议保留可复现位置与决定性摘录，身份字段必须精确保留。

• 审查候选资格或 HD-N 判断时，先读取 .agents/rules/decision-qualification.md，逐项复核产物中的三张资格审计决策表、资格快照、digest 和 QCR；不得把流程标签当作身份认证
• 本技能只审查分析产物并写报告，不修改业务代码
• 生成会同步到 Issue 的任务或生命周期 Markdown 前，先读取 .agents/rules/sync-content-generation.md 并遵循其中的生成端约束；同步端不解析或改写正文
• 执行本技能后，你必须立即更新 task.md

版本戳规则：创建或更新 task.md frontmatter 时，先读取 .agents/rules/version-stamp.md，并写入或刷新 agent_infra_version。

第 0 步：状态核对（执行前硬约束）

在加载 workflow / skill / rules 指令之后、做任何任务状态判断或用户可见结论之前，必须先执行状态核对。指令类文件读取不算对外动作或结论。

运行以下命令，并在本轮产物的 ## 状态核对 段记录任务/产物范围、关键结果和未覆盖部分；正常成功不粘贴完整目录清单或 task.md 尾部。失败、阻塞、身份不一致或争议时，附决定性原文行：

agent-infra-internal task-snapshot {task-id} --format text

状态核对完成前，禁止任何关于外部状态的断言。

任务上下文解析

入口可省略 task ref；显式 task scope 仅接受 --task <ref> 或 -t <ref>，不再解释位置 task ref。保留其余业务操作数后调用 agent-infra-internal task-context resolve {task-scope}；{task-scope} 为空或 task flag 之一。只读取结构化结果的 taskId，后续把 {task-id} 绑定为完整 TASK-YYYYMMDD-HHMMSS。解析失败时透传非零退出码，不自行扫描任务。

解析任务引用，并确认任务位于本技能支持的状态或目录且存在 task.md；无法定位时按未找到任务处理并停止。

步骤开始：声明 started 事件

确认前置条件和产物上下文后、本轮第一个产出动作之前执行 agent-infra-internal task-event {task-id} review-analysis.started --agent {standard-agent-token} --initiator {trigger-initiator} --request-id {request-id} --reason-code {reason-code}。

执行步骤

1. 验证前置条件

要求存在：

• .agents/workspace/active/{task-id}/task.md
• 至少一个分析产物：analysis.md 或 analysis-r{N}.md

2. 解析审查上下文

运行 agent-infra-internal task-artifact {task-id} inspect --family review-analysis。仅当结果为 ready 时继续。若 selection.disposition 为 reuse，复用 selection.artifact，不得执行 started、init 或写入新产物，并直接进入完成校验与下一步提示。其他状态从 inputs 取得 {analysis-artifact}，从 next.round / next.name 取得 {review-round} / {review-artifact}；不得自行扫描轮次或拼装文件名。随后执行 started 事件并复核返回身份。

3. 阅读分析上下文

读取最新 {analysis-artifact}、task.md 和关联 Issue 上下文（如有）。读取后，把本轮实际检视的最高轮 analysis artifact 文件名回填到报告 审查输入 段；无法可靠取得时留空，不要伪造。

4. 执行审查

重点检查需求完整性、风险识别、影响范围、开放问题和工作量评估。

共享检视方法见 .agents/rules/review-method.md。执行此步骤前先读取该规则，并按五遍协议完成覆盖声明、风险镜头判断、追踪矩阵和反证检视。 详细审查标准见 reference/review-criteria.md。执行此步骤前先读取 reference/review-criteria.md。

5. 编写审查报告

在首次写入本轮 {review-artifact} 前，先创建受控审查骨架：

agent-infra-internal task-artifact {task-id} init --family review-analysis --artifact {review-artifact}

骨架不生成审查结论、发现或计数；完成审查内容后才能进入 summary finalizer。结构错误时，遵循 .agents/rules/local-artifact-repair.md 直接修正正式审查产物并重跑原 finalizer；当前产物内容是唯一输入。

创建 .agents/workspace/active/{task-id}/{review-artifact}。

报告格式见 reference/report-template.md。写报告前先读取 reference/report-template.md。

6. 更新任务状态

报告完成后，先调用 agent-infra-internal task-review {task-id} preflight --stage analysis --artifact {review-artifact} {execution-flag}，不得先写入账本。失败后直接修正正式产物并重跑；只有 preflight 通过后，才逐条调用 agent-infra-internal task-ledger {task-id} finding-upsert --stage analysis --review-artifact {review-artifact} --ordinal {n} --severity {blocker|major|minor} --evidence {review-artifact}#{anchor}，或复核上一轮响应时调用 finding-review --id {ledger-id} --status {confirmed|closed|open|needs-human-decision} --evidence {相称证据}。不得扫描编号或手写账本行。全部账本写入完成后调用 agent-infra-internal task-review {task-id} finalize-summary --stage analysis --artifact {review-artifact} {execution-flag}；不能把失败类型或 changed=false 当作自动授权。

从该次返回值绑定并复用以下结构化映射：

{unresolved-blockers} = stageStatus.unresolvedFindingCounts.blocker
{unresolved-major} = stageStatus.unresolvedFindingCounts.major
{unresolved-minor} = stageStatus.unresolvedFindingCounts.minor

该 intent 原子最终化报告摘要并返回同一次账本快照；不得再调用 stage-status、手工替换占位符或扫描问题清单。失败后，模型只能在共享规则的机械安全门通过时修改同一个受控 artifact，并完整重跑相同 intent；每次失败都重新判断是否收敛。最终一次完整成功返回决定同一快照的 verdict 和计数：stageStatus.canAdvance=true 且结论为 Approved 时允许跨阶段推进；stageStatus.canAdvance=false 时仍须执行 agent-infra-internal task-event {task-id} review-analysis.completed --agent {standard-agent-token} --initiator {trigger-initiator} --request-id {request-id} --reason-code {reason-code} --artifact {review-artifact} --verdict {approved|changes-requested|rejected} --blockers {unresolved-blockers} --major {unresolved-major} --minor {unresolved-minor} --manual-validation {n} {execution-flag}，使用 changes-requested 并路由到同阶段修订/复审（报告明确拒绝时使用 rejected）。失败、模型停止、无进展或紧急熔断时，不发布完成事件或跨阶段命令，但必须按 reference/output-templates.md 的 repair-stop 场景展示已有 summary/findings、artifact、实际修复次数、最后诊断和停止原因。

manual-validation 是 ai task log 中 review 行「人工校验点」（EN Manual-validation）计数的数据源；不要新增并行人工验证字段。

如果 task.md 中存在有效的 platform_issue_identity，调用 agent-infra-internal platform-comment sync {task-id} --kind task --agent {standard-agent-token}，再调用 agent-infra-internal platform-comment sync {task-id} --kind artifact --artifact {review-artifact} --agent {standard-agent-token}；失败按 .agents/rules/issue-sync.md 记录 warning。

最终化 intent 会在写入摘要前检查详情块 ID；任何可见重复都返回结构化失败并保持 artifact 字节不变，由模型按共享规则判断是否进行最小编辑。无法通过安全门、诊断重复、没有实际字节变化或达到紧急熔断时，停止在完成事件之前；停止路径仍必须展示已有审查结果，不得吞掉 artifact 内容。

7. 完成校验

agent-infra-internal task-verify {task-id} review-analysis.completed --artifact {review-artifact} --format text

按 .agents/rules/validation-output.md 展示当次校验摘要；失败、阻塞和软警告保留必要诊断。

校验通过后继续告知用户；校验失败则修复报告或 task 状态后重跑。

8. 告知用户

按 reference/output-templates.md 的结论分支输出，并通过统一 helper 渲染已选场景的下一步命令。

渲染最终输出前先读取 .agents/rules/next-step-output.md 并落实其两类规则：(1) 「下一步」命令的 {task-ref} 渲染为当前任务短号 NN（取值与回退见该文件），其他 {task-id} 占位（报告标题、路径）保持完整 TASK-id 形式；(2) 在面向用户输出的绝对最后一行追加 Completed at 收尾行（成功、错误、早退等任何面向用户输出都适用，不限于校验通过的成功态）。

完成检查清单

• 已审查最新分析上下文
• 已创建 {review-artifact}
• 已更新 task.md 并追加 Activity Log
• 已通过统一 helper 渲染已选场景的下一步命令

注意事项

• 首轮审查使用 review-analysis.md，后续轮次使用 review-analysis-r{N}.md
• 所有问题都要引用具体文件路径和行号；分析产物问题可引用 {analysis-artifact} 的行号