research

用户输入

$ARGUMENTS

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

预期输入格式：rpi/{feature-slug}/REQUEST.md

目的

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

关键目标：

• 评估产品-市场匹配和用户价值
• 评估技术可行性和复杂性
• 识别风险和潜在阻碍
• 确定正确的方法（构建、购买、合作或拒绝）
• 提供明确的 go/no-go 建议和理由

前置条件：

• 功能文件夹存在于 rpi/{feature-slug}/
• 功能请求文件存在于 rpi/{feature-slug}/REQUEST.md

输出位置：rpi/{feature-slug}/research/RESEARCH.md

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

大纲

1. 加载上下文：从 rpi/{feature-slug}/ 和项目宪法（如果存在）读取功能描述
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：加载上下文

前置条件：提供了功能 slug，rpi/{feature-slug}/REQUEST.md 存在

流程：

1. 读取功能描述：

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

2. 检查项目宪法（可选）：

   • 在代码库中查找宪法或原则文档
   • 常见位置：constitution.md、PRINCIPLES.md、.project/constitution.md
   • 如果找到，提取核心原则、约束和目标

3. 创建研究上下文：

   • 综合为 agent 的简洁摘要
   • 识别关键一致性标准

输出：

• 功能描述摘要
• 宪法原则（如果找到）
• 评估的一致性标准

验证：

• 功能文件夹存在于 rpi/{feature-slug}/
• 功能描述已提取
• 已检查并加载宪法（如果存在）

---

阶段 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 分析：

   • 用户价值：谁受益？影响有多大？
   • 市场匹配：这是否符合市场需求？
   • 产品愿景：这是否符合我们的产品策略？
   • 宪法一致性：这是否符合项目原则？
   • 约束检查：这是否违反任何宪法约束？