开发实现 — 子工作流

本文件定义"开发实现"阶段的独立子工作流。用户可单独加载本文件执行开发阶段。

阶段目标

按设计产出可工作的软件资产。开发阶段的核心产出是"可工作的代码"——通过自动化门禁、Code Review、集成验证的源代码。

AI 编程场景特有风险

在 AI 辅助编程项目中，开发阶段存在以下特有风险：

独立使用时的目标锚定

当本子工作流被独立加载（非通过 main-workflow.md 总入口加载）时，MUST 在执行阶段活动前完成以下自包含检查。本段不依赖任何其他文件。

锚定步骤（每步有具体文件路径和检查目标）：

1. 目标确认：读取 .governance/plan-tracker.md → 找到 ## 项目配置 节 → 提取"项目目标"和"量化成功标准"。如果 plan-tracker 中无明确目标 → MUST 通过 AskUserQuestion 工具询问用户（M5.1 禁止内联文字问题），选项示例：(1) "输入项目目标" (2) "跳过目标锚定——我知道风险" (3) "初始化 governance 后再继续"
2. 偏离检查：对照成功标准，确认本轮开发范围是否在目标方向上。偏离 = 发现你准备实现的与 plan-tracker 中定义的目标不一致 → MUST 先记录到 .governance/decision-log.md
3. 质量底线：代码 MUST 通过自动化门禁（lint/test/coverage/security）+ Code Review 闭环（≥1 reviewer，遗留项=0）

降级行为（.governance/ 不存在时）：

• .governance/plan-tracker.md 不存在 → 内联告知用户（单向通知，非提问——不触发 M5.1 禁令）："当前项目未初始化 governance。独立使用模式下目标锚定不可用——无法确认开发方向是否与项目目标一致。建议运行 governance-init 初始化治理。"
• 降级不阻塞执行——独立使用模式下可以直接开始开发，但 agent MUST 在开始前内联告知用户锚定缺失的风险（单向通知——非交互式提问）
• 如果后续初始化了 governance，锚定检查在下一会话自动恢复

进入条件

• 架构设计已完成（G5 通过或条件通过）
• 开发环境已搭建（G4 通过）
• 有明确的详细设计和 ADR 作为输入

活动清单

1. 开发准备

2. 迭代开发（TDD 顺序）

3. Code Review

4. 自动化门禁（Pre-Merge）

5. 集成验证

产出物标准

退出条件

• 核心功能按设计和 ADR 实现（功能列表逐项对照无遗漏）
• 单元测试覆盖率达标（standard ≥70%, strict ≥90%）
• Code Review 遗留项已关闭（遗留项 = 0；每条意见已回复）
• AI 专项检查通过（无 mock 残留、硬编码、幻觉 API、未实现 TODO）
• 安全扫描通过（无 HIGH/CRITICAL 漏洞）
• 自动化门禁全部通过（lint、test、coverage、security、dependency）
• 集成验证通过（无阻塞性失败）
• 实现偏差已记录（如有偏离设计的，已记入决策日志）

Gate 映射

本阶段对应 G6 — 开发完成。

企业实践溯源

本子工作流的设计参考了以下企业实践，每条实践已映射到具体活动步骤：