需求实现校验

前置条件

当前需求 phase 为 implemented
代码实现已完成（迭代分支上），本子 skill 不创建分支、不切分支
pipeline 主编排已按 references/context-and-meta-template.md 重写当前阶段的 context.md （白名单含：spec.md / plan.md / tasks.md + 项目宪章 + 架构/安全/编码规范文档 + 项目根 AGENTS.md（项目定位与关键规范索引）+ Code scope + 可复用 skill 入口 skills/bk-security-redlines/； CodeReview 维度由 code-reviewer agent 经 use_skill("code-review") 加载统一后的 CR 方法论驱动）
本子 skill 不维护代码回滚锚点：回退默认保留代码

输入

${WORKDIR}/meta.yaml（读取 attempts）
当前需求 ID（由 pipeline 主编排传入）
${WORKDIR}/spec.md / plan.md / tasks.md
${WORKDIR}/context.md
${WORKDIR}/iteration-patches/attempt-${N}.md（若为回退重入，必读）

执行流程

本阶段由四段并行校验 subagent + 一段原地修复 subagent（仅当需要）组成。

┌── subagent #1 ── validate-arch-report.md
attempt ${N}      ├── subagent #2 ── validate-security-report.md
round ${R}  ──────┤                                              ── 汇总 ── subagent #5 (修复) ── round +1
                  ├── subagent #3 ── validate-codereview-report.md
                  └── subagent #4 ── validate-test-report.md

1. 四段并行校验（subagent #1 / #2 / #3 / #4）

pipeline 主编排按 ../references/subagent-prompt-template.md 中的四份模板分别渲染， 同一轮次内四次 Task() 并行发起：

subagent	执行 agent	template 段	产出	日志
#1 架构	`tech-lead`	§2.6 validate-arch	`validate-arch-report.md`	`process-validate-arch.log`
#2 安全	`code-reviewer`	§2.7 validate-security	`validate-security-report.md`	`process-validate-security.log`
#3 CodeReview	`code-reviewer`	§2.8 validate-codereview	`validate-codereview-report.md`	`process-validate-codereview.log`
#4 测试	`qa-engineer`	§2.10 validate-test	`validate-test-report.md`	`process-validate-test.log`

渲染填充：${ID} / ${VERSION} / ${WORK_DIR} / attempts / round；若 attempts > 1，附上 iteration-patches/attempt-${attempts}.md 摘要。

四段的命令、统一报告模板、Verdict 判定规则均在 subagent-prompt-template.md §2.6~§2.8 及 §2.10 中定义，本子 skill 不重复。

2. 汇总决策（主会话）

汇总条件	主会话动作
四份全 `LGTM`，且无 CRITICAL/HIGH finding	跳过修复，推进 phase
任一份 `needs_fix`，但全部归因 `code-self`	启动原地修复（同 attempt 内 round +1）
任一份 `spec_insufficient` / `plan_insufficient`	走回退重入（§5）
任一段 subagent `status=fail`	按 `error-handling.md` 处理

3. 原地修复（subagent #5，仅当需要）

pipeline 主编排按 ../references/subagent-prompt-template.md §2.9 validate-fix 模板渲染，拉起修复 subagent。日志写入 process-validate-fix.log。

修复命令、自检步骤、回传 JSON 要求均在 §2.9 中定义。

修复完成后，pipeline 主编排重新回到步骤 1 并行跑四段校验（round +1），直到全部 LGTM 或升级为回退重入。同 attempt 内最多 3 个 round。

round 号在"修复 + 四段校验"整组完成后才 +1。

3.1 fullstack 需求的 fix 路由

fix 阶段根据受影响文件路径确定执行 agent：

受影响文件归属	分配给
纯后端文件（如 `.go`、`.proto`、`internal/`）	`backend-developer`
纯前端文件（如 `.vue`、`.ts`、`components/`）	`frontend-developer`
前后端文件均受影响	串行：`backend-developer` 先，`frontend-developer` 后

前后端接口契约不一致的归因判定：

根因	归因	fix 路由
backend 实现偏离了 plan.md 的接口定义（frontend 对着 plan.md 实现，无误）	`code-self`	`backend-developer` 修复至符合 plan.md；frontend 无需改动
plan.md 接口定义模糊，前后端各自作了不同的合理解读	`spec-insufficient`	回退重入，tech-lead 修订 plan.md，两端重新 implement

判断标准：validate-arch 核对 plan.md 与实际代码的差异。若某一端代码符合 plan.md 而另一端不符合，归因 code-self；若 plan.md 本身存在多义性（两端实现均符合各自解读），归因 spec-insufficient。

4. 更新状态

四份 verdict 均 LGTM 时：phase → validated；history 追加成功记录。

5. 信息不足回退（回退重入入口，保留代码）

回退触发条件：

触发条件	动作
任一份 verdict 为 `spec_insufficient` / `plan_insufficient`	走回退重入
同 attempt 内 round 重试 3 次仍有 CRITICAL/HIGH finding	强制升级为回退重入

回退动作清单（validate 阶段特化）：

步骤	动作	备注
1	四份评审报告原样保留	作为上游修订的参考证据
2	由 pipeline 写 `iteration-patches/attempt-${N+1}.md`	固定 `code_preserved: true`；必填字段见 state-mutation-guide §2
3	pipeline 更新 meta.yaml	先校验 `attempts < max_attempts`；通过后 `attempts` +1、`last_failure` 写入摘要、`history` 追加 `code_preserved_rollback`
4	不做 git 回滚	代码、评审报告、日志全部保留
5	跳转到 `target_phase_to_re_enter`	下游按差量修复模式工作

下游复用代码行为：

子 skill	行为
implement	不重建 baseline_commit；注入 unresolved_findings，做差量修复
validate	重走四段并行校验；新 attempt rounds 从 1 开始

可重入约定

两类重入，都不主动回滚代码：

同 attempt round 重试 = 原地修复：评审报告覆盖重写，历史经 process-validate-*.log 回溯
回退重入 = 保留代码 + 携带问题回上游（详见 §5）

重入类型	pipeline 主编排动作	meta.yaml 变化
round 重试	不动代码；覆盖重写评审报告；拉修复 subagent	round +1，attempts 不变
回退重入	调用方提供 retry / reject 语义指令与 attempt patch；pipeline 写 `last_failure`、attempt patch 与 phase	仅当 `attempts < max_attempts` 时 attempts +1、phase 切换

严禁：git reset --hard / git stash / git checkout <branch> / git clean -fdx。

子 skill 在执行前必须：

读取最新 attempt-*.md（若有），追加重入增量段（subagent-prompt-template.md §3）
若 code_preserved=true，在 SUBAGENT_PROMPT 中告知"重新评审当前代码与新规范的对齐"
校验 Code scope 白名单未被意外缩窄

幂等性、各 process-validate-*.log 仅追加等通用约束见 ../references/reentry-protocol.md。

参考资料

SUBAGENT_PROMPT（validate-arch §2.6 / validate-security §2.7 / validate-codereview §2.8 / validate-fix §2.9 / validate-test §2.10）+ 统一报告模板：../references/subagent-prompt-template.md
通用回传 JSON Schema：../references/subagent-prompt-template.md §1.3
上下文与元数据模板：../references/context-and-meta-template.md
可重入协议：../references/reentry-protocol.md
错误处理：../references/error-handling.md
可复用 skill：skills/bk-security-redlines/（安全维度）
CodeReview 维度执行 agent：agents/code-reviewer.md（经 use_skill("code-review") 加载统一 CR 方法论）
测试覆盖维度执行 agent：agents/qa-engineer.md（内置测试审查清单）

产出

${WORKDIR}/validate-arch-report.md — 架构校验报告
${WORKDIR}/validate-security-report.md — 安全校验报告
${WORKDIR}/validate-codereview-report.md — CodeReview 报告
${WORKDIR}/validate-test-report.md — 测试覆盖审查报告
${WORKDIR}/process-validate-arch.log — 架构校验日志
${WORKDIR}/process-validate-security.log — 安全校验日志
${WORKDIR}/process-validate-codereview.log — CodeReview 日志
${WORKDIR}/process-validate-test.log — 测试审查日志
${WORKDIR}/process-validate-fix.log — 修复日志（仅当修复执行时）
${WORKDIR}/meta.yaml — 更新后的 attempts / round / validate_attempts / history
需求 phase 为 validated

tapd-story-validate