research

用户输入

$ARGUMENTS

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

预期输入格式：rpi/{功能标识}/REQUEST.md

目的

此命令在规划阶段开始之前对功能请求进行全面的研究和分析。它作为关键的 GO/NO-GO 门，决定功能想法是否应该进入详细规划。

关键目标：

• 评估产品市场契合度和用户价值
• 评估技术可行性和复杂性
• 识别风险和潜在阻塞
• 确定正确的方法（构建、购买、合作或放弃）
• 做出 go/no-go 建议并给出明确理由

前提条件：

• 功能文件夹存在于 rpi/{功能标识}/
• 功能请求文件存在于 rpi/{功能标识}/REQUEST.md

输出位置：rpi/{功能标识}/research/RESEARCH.md

这是 RPI 工作流的第 2 步（第 1 步初始功能描述之后）。

大纲

1. 加载上下文：从 rpi/{功能标识}/ 读取功能描述和项目章程（如果存在）
2. 解析功能请求：使用 requirement-parser agent 提取结构化需求
3. 执行多阶段研究：
   • 第 1 阶段：解析功能请求（requirement-parser agent）
   • 第 2 阶段：产品分析与章程一致性（product-manager agent）
   • 第 2.5 阶段：技术发现（Explore agent） - 关键：深度代码探索
   • 第 3 阶段：技术可行性（senior-software-engineer agent）
   • 第 4 阶段：战略评估（technical-cto-advisor agent）
   • 第 5 阶段：生成研究报告（documentation-analyst-writer agent）
4. 综合建议：将所有分析组合成清晰的 go/no-go 建议
5. 验证输出：对照质量门检查
6. 报告完成：提供建议、后续步骤和报告位置

阶段

阶段 0：加载上下文

前提条件：提供了功能标识，rpi/{功能标识}/REQUEST.md 存在

过程：

1. 读取功能描述：

   • 读取 rpi/{功能标识}/REQUEST.md（必需）
   • 从 REQUEST.md 提取功能需求和目标

2. 检查项目章程（可选）：

   • 查找仓库中的章程或原则文档
   • 常见位置：constitution.md、PRINCIPLES.md、.project/constitution.md
   • 如果找到，提取核心原则、约束和目标

3. 创建研究上下文：

   • 综合成简洁的摘要供 agent 使用
   • 识别关键对齐标准

输出：

• 功能描述摘要
• 章程原则（如果找到）
• 评估的对齐标准

验证：

• 功能文件夹存在于 rpi/{功能标识}/
• 提取了功能描述
• 检查并加载了章程（如果存在）

---

第 1 阶段：解析功能请求

前提条件：阶段 0 完成

Agent：requirement-parser（规划域）

过程：

1. 启动 requirement-parser agent 并传入功能描述

2. Agent 提取：

   • 功能名称和类型
   • 目标组件
   • 目标和目的
   • 功能和非功能需求
   • 约束和假设
   • 复杂性估计
   • 澄清问题（如果有）

3. 审查解析结果：

   • 如果存在澄清问题，停止并询问用户再继续

输出：

• 结构化需求文档
• 功能元数据（名称、类型、组件、复杂性）
• 澄清问题（如果有）

---

第 2 阶段：产品分析与章程一致性

前提条件：第 1 阶段完成，需求清晰

Agent：product-manager

过程：

1. 启动 product-manager agent 并传入：

   • 第 1 阶段的解析需求
   • 第 0 阶段的章程上下文

2. Agent 分析：

   • 用户价值：谁受益？影响多大？
   • 市场契合：这与市场需求一致吗？
   • 产品愿景：这符合我们的产品战略吗？
   • 章程一致性：这与项目原则一致吗？
   • 约束检查：这是否违反任何章程约束？