plan

用户输入

$ARGUMENTS

你必须解析用户输入以提取特性标识（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：加载上下文

前提条件：已提供特性标识

流程：

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
   • 需要的数据库 schema 变更
   • 事件/消息流
   • 前后端集成

4. 评估技术风险：

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

输出：

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

验证：

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

---

阶段 3：设计特性架构

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

代理：senior-software-engineer

流程：

1. 设计高层架构：

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

2. 定义实现方案：

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

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

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