需求实现计划
前置条件
- 当前需求 phase 为
tech-clarified ${WORKDIR}/spec.md已存在- pipeline 主编排已按
references/context-and-meta-template.md重写当前阶段的context.md（白名单包含：spec.md + 项目宪章 + 架构/安全/编码规范引用文档）
输入
${WORKDIR}/meta.yaml（读取attempts）- 当前需求 ID（由 pipeline 主编排传入）
${WORKDIR}/spec.md${WORKDIR}/context.md${WORKDIR}/iteration-patches/attempt-${N}.md（若为回退重入，必读）
执行流程
pipeline 主编排按 ../references/subagent-prompt-template.md §2.2 Plan 模板渲染
SUBAGENT_PROMPT（含 speckit.plan skill + 就地合规自检 + plan-report.md 产出），
通过 Task(subagent_name="tech-lead", ...) 拉起 subagent。
渲染填充：${ID} / ${VERSION} / ${WORK_DIR} / attempts / round；
若 attempts > 1，附上 iteration-patches/attempt-${attempts}.md 摘要。
subagent 内的两段工作（speckit-plan + 就地合规自检）、合规自检 checklist（3 个维度： 完整度 / research 合规 / 项目宪章）、plan-report.md 统一模板、Verdict 判定规则 均在 subagent-prompt-template.md §2.2 中定义，本子 skill 不重复。
内容门禁（主编排内联）
在消费 plan-report.md 的 verdict 前，主编排必须确认 plan 产物具备可实施性：
| 检查项 | 通过标准 |
|---|---|
| 技术上下文 | plan.md 明确技术栈、受影响模块与项目结构；未知项已在 research.md 中消除或显式列出 |
| 架构与契约 | 方案描述模块交互和依赖方向；存在外部接口时，contracts/ 或 plan.md 定义了请求、响应及错误行为 |
| 数据模型 | 涉及数据时 data-model.md 定义实体、字段、校验与关系；不涉及时在 plan.md 显式说明 |
| 需求映射 | spec.md 的每个用户场景、功能需求和验收标准均能映射到实现方案或明确标注不适用原因 |
| 关键决策 | research.md 对每个选型记录 Decision、Rationale 和 Alternatives considered |
不要求固定的文件章节标题，应根据 Speckit 模板的等效内容判断。任一项未满足时，
主编排将 compliance.verdict 视为 needs_fix，在 report 中列出缺失项并按同 attempt
round 重试规则处理。
消费 subagent 回传 JSON
按 compliance.verdict 分支：
| Verdict | 主会话动作 |
|---|---|
pass | 进入"更新状态"推进 phase |
needs_fix | 同 attempt 内 round +1，重跑 plan（最多 3 个 round） |
spec_insufficient | 整理 findings 摘要为 iteration-patches/attempt-${N+1}.md，target_phase_to_re_enter=specify，走回退重入 |
status=fail 按 references/error-handling.md 处理，一般升级为回退重入。
更新状态
compliance.verdict=pass 时：
- 更新
meta.yaml.phase为researched meta.yaml.history追加成功记录，清空meta.yaml.last_failure
可重入约定
通用规则见 ../references/shared-reentry-conventions.md。本阶段差异：
- round 重试触发条件：
compliance.verdict=needs_fix，同 attempt 内最多 3 个 round - 报告文件不做快照：
plan-report.md每轮覆盖重写，历史可在 process.log 中追溯 - 读取最新
attempt-*.md（若有），在 SUBAGENT_PROMPT 中追加重入增量段到/speckit.plan提示词中 （subagent-prompt-template.md §2.2）
幂等性、产物保留、process.log 仅追加等通用约束见 ../references/reentry-protocol.md。
信息不足回退（回退重入入口）
当 verdict=spec_insufficient 或下游子 skill 反向追溯到本阶段信息不足时，
attempt-${N+1}.md 必须明确：
failed_phase: planroot_cause：可直接复用plan-report.md中对应 Finding 的根因字段target_phase_to_re_enter: specify（spec 不足）或plan（仅 plan 自身）
参考资料
- SUBAGENT_PROMPT（plan 模板 + 合规自检 checklist + 报告模板）：
../references/subagent-prompt-template.md§2.2 - 通用回传 JSON Schema：
../references/subagent-prompt-template.md§1.3 - 上下文与元数据模板：
../references/context-and-meta-template.md - 可重入协议：
../references/reentry-protocol.md - 错误处理：
../references/error-handling.md
产出
${WORKDIR}/plan.md— 开发计划${WORKDIR}/research.md— 技术调研报告${WORKDIR}/data-model.md— 数据模型（如有）${WORKDIR}/contracts/*.md— 通讯协议（如有）${WORKDIR}/plan-report.md— 文档级合规自检报告${WORKDIR}/process.log— stream-json 流式日志（追加）${WORKDIR}/meta.yaml— 更新后的 attempts / round / history- 需求 phase 为
researched
