plan

用户输入

$ARGUMENTS

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

目的

此命令为功能请求创建全面的规划文档。它在功能的 RPI 文件夹中生成详细规范、技术设计和实施计划。

前置条件：

• 功能文件夹存在于 rpi/{feature-slug}/
• 研究完成并获得 GO 建议（rpi/{feature-slug}/research/RESEARCH.md 存在）

输出位置：所有文件保存到 rpi/{feature-slug}/plan/

这是 RPI 工作流的步骤 3（研究批准 GO 之后）。

大纲

1. 加载上下文：读取研究报告和项目宪法（如果存在）
2. 理解需求：解析功能范围和需求
3. 分析技术需求：审查架构和依赖项
4. 设计架构：创建高级架构和 API 契约
5. 分解实施：创建分阶段的任务分解
6. 生成文档：创建结构化文档文件
7. 验证输出：确保所有质量关卡通过
8. 报告完成：提供摘要和下一步

阶段

阶段 0：加载上下文

前置条件：提供了功能 slug

流程：

1. 验证研究完成：

   • 检查 rpi/{feature-slug}/research/RESEARCH.md 存在
   • 验证 GO 建议（如果是 NO-GO 或 CONDITIONAL 则警告）

2. 读取研究发现：

   • 提取产品分析
   • 提取技术发现
   • 提取技术可行性评估
   • 注意风险和约束

3. 加载项目宪法（如果存在）：

   • 在代码库中查找宪法或原则文档
   • 提取相关约束和偏好

输出：

• 研究摘要
• 宪法上下文（如果找到）
• 规划约束

验证：

• 研究报告存在
• GO 建议已确认
• 宪法已加载（如果存在）

---

阶段 1：理解功能需求

前置条件：阶段 0 完成

流程：

1. 从研究报告中解析功能描述：

   • 提取功能名称和主要目标
   • 识别目标组件
   • 理解面向用户的 vs 技术功能
   • 确定功能复杂性级别

2. 识别受影响的组件：

   • 主要组件（功能所在的位置）
   • 辅助组件（集成点）
   • 需要的共享工具
   • 外部依赖项

3. 研究现有模式：

   • 在代码库中搜索类似功能
   • 审查组件架构和模式
   • 识别可复用的代码和模式

输出：

• 功能范围文档（内部）
• 受影响组件列表
• 现有模式目录

验证：

• 功能名称和目标已明确定义
• 目标组件已识别
• 功能复杂性已评估

---

阶段 2：分析技术需求

前置条件：阶段 1 完成

流程：

1. 审查组件架构：

   • 阅读组件 README 和文档
   • 审查现有代码结构
   • 识别使用的架构模式

2. 识别技术依赖项：

   • 内部依赖项（其他组件、共享工具）
   • 外部依赖项（API、服务、库）
   • 数据库/存储需求
   • 认证/授权需求

3. 评估集成点：

   • 需要创建或修改的 API
   • 需要的数据库模式更改
   • 事件/消息流
   • 前端-后端集成

4. 评估技术风险：

   • 对现有功能的破坏性更改
   • 性能影响
   • 安全问题
   • 数据迁移需求

输出：

• 技术需求文档（内部）
• 依赖项映射
• 集成点图表
• 风险评估

验证：

• 组件架构已理解
• 所有依赖项已识别
• 集成点已映射
• 技术风险已评估

---

阶段 3：设计功能架构

前置条件：阶段 1-2 完成

Agent：senior-software-engineer

流程：

1. 设计高级架构：

   • 组件/模块结构
   • 数据流图
   • API 接口
   • 数据库模式更改

2. 定义实施方法：

   • 文件结构和组织
   • 代码组织模式
   • 测试策略
   • 错误处理方法

3. 规划数据库/存储更改（如适用）：

   • 新集合/表
   • 模式修改
   • 迁移策略
   • 数据验证规则