plan

用户输入

$ARGUMENTS

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

目的

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

前提条件：

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

输出位置：所有文件保存到 rpi/{功能标识}/plan/

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

大纲

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

阶段

阶段 0：加载上下文

前提条件：提供了功能标识

过程：

1. 验证研究已完成：

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

2. 读取研究发现：

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

3. 加载项目章程（如果存在）：

   • 查找仓库中的章程或原则文档
   • 提取相关约束和偏好

输出：

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

验证：

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

---

阶段 1：理解功能需求

前提条件：阶段 0 完成

过程：

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

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

2. 识别受影响的组件：

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

3. 研究现有模式：

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

输出：

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

验证：

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

---

阶段 2：分析技术需求

前提条件：阶段 1 完成

过程：

1. 审查组件架构：

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

2. 识别技术依赖：

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

3. 评估集成点：

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

4. 评估技术风险：

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

输出：

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

验证：

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

---

阶段 3：设计功能架构

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

Agent：senior-software-engineer

过程：

1. 设计高级架构：

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

2. 定义实现方法：

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

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

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

4. 设计 API 契约（如果适用）：

   • 请求/响应格式
   • 认证需求
   • 错误响应