implement

用户输入

$ARGUMENTS

你必须解析用户输入以提取功能标识（rpi/ 中的文件夹名称）。

目的

此命令基于规划文档执行功能的分阶段实现。它编排专业 agent，强制执行验证门，并确保整个实现过程中的章程合规性。

前提条件：

• 功能文件夹存在于 rpi/{功能标识}/
• 规划已完成（rpi/{功能标识}/plan/PLAN.md 存在）

输出位置：rpi/{功能标识}/implement/

这是 RPI 工作流的第 4 步（最后一步 - 实际实现）。

标志

• --phase N：执行特定阶段编号（1-8），如果省略则从阶段 1 开始
• --validate-only：仅验证当前阶段，不实现
• --skip-validation：跳过验证门并继续（谨慎使用）

可用 Agents

所有 agent 使用 Opus 模型以获得最高质量。

实现 Agent

Agent	类型	何时使用
senior-software-engineer	自定义	所有实现任务

支持 Agents

Agent	类型	目的
Explore	内置	实现前代码探索
code-reviewer	自定义	代码审查和质量验证
constitutional-validator	自定义	根据项目章程验证
documentation-analyst-writer	内置	文档生成

Agent 路由

所有实现任务由 senior-software-engineer agent 处理。

---

阶段 0：加载上下文和规则

前提条件：从用户输入解析的功能标识

过程：

0.1 加载项目章程

1. 检查仓库中是否存在章程或原则文档
2. 如果存在，提取：
   • 技术约束（类型安全、测试、组件隔离）
   • 业务原则（质量标准、工作流）
   • 架构边界
3. 存储约束以在执行期间强制执行

0.2 加载领域特定指南

根据要修改的文件，加载相关的项目指南：

• 检查组件特定的 README 文件
• 检查编码风格指南
• 检查测试需求文档

0.3 分析实现范围

1. 读取 rpi/{功能标识}/plan/PLAN.md
2. 识别所有要修改的文件
3. 将文件映射到实现 agent

输出：

• 章程上下文摘要
• 加载的领域规则
• 文件到 agent 的映射
• 阶段执行计划

验证：

• 章程已加载（如果存在）
• 受影响文件的领域规则已加载
• 所有文件已映射到 agent
• 执行计划已理解

---

分阶段实现工作流

阶段实现循环

对于 PLAN.md 中的每个阶段：

┌─────────────────────────────────────────────────────────────────┐
│ 阶段 N: [阶段名称]                                            │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  1. 代码发现 (Explore Agent)                                   │
│     └─→ 在修改前理解现有代码                                   │
│                                                                  │
│  2. 实现 (senior-software-engineer)                            │
│     └─→ 实现阶段交付物                                         │
│                                                                  │
│  3. 自我验证                                                   │
│     └─→ 工程师根据阶段清单验证                                 │
│                                                                  │
│  4. 代码审查 (code-reviewer Agent)                             │
│     └─→ 安全性、正确性、可维护性                               │
│                                                                  │
│  5. 用户验证门                                                 │
│     └─→ 停止并请求用户批准                                     │
│         ├─→ 通过：进入下一阶段                                 │
│         ├─→ 有条件通过：记录问题，继续                         │
│         └─→ 失败：修复问题，重新验证                           │
│                                                                  │
│  6. 文档更新                                                   │
│     └─→ 在 PLAN.md 中更新阶段状态                              │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘