@zeyue0329/xiaoma-cli 1.0.47 → 1.0.49

package/xiaoma-core/tasks/requirement-analysis-with-rag.md

@@ -2,12 +2,12 @@
 
 ## Purpose
 
-通过结合外部需求文档(req.txt)和知识库(RAG/MCP)进行深度需求分析，生成高质量的PRD文档。
+通过结合外部需求文档(req.txt)和知识库(RAG/MCP)进行深度需求分析，输出结构化的需求分析报告，为后续PM智能体生成PRD提供完整输入。
 
 ## Workflow Overview
 
 ```
-req.txt → 深度解析 → 问题生成 → 知识库查询 → 知识落地(docs/rag/) → 需求分析 → PRD生成
+req.txt → 深度解析 → 问题生成 → 知识库查询 → 知识落地(docs/rag/) → 需求分析报告
 ```
 
 ## 输出文件
@@ -18,7 +18,27 @@ req.txt → 深度解析 → 问题生成 → 知识库查询 → 知识落地(d
 | 问题生成 | 问题清单 | `docs/rag/_questions.md` |
 | 知识落地 | 知识索引 | `docs/rag/_index.md` |
 | 知识落地 | 分类知识 | `docs/rag/{category}/*.md` |
-| PRD生成 | PRD文档 | `docs/prd.md` |
+| 需求分析 | 分析报告 | `docs/rag/_analysis-report.md` |
+
+## 职责边界
+
+```yaml
+本任务职责:
+  - 需求文档深度解析
+  - 知识库问题生成与查询
+  - 知识文档落地与组织
+  - 需求分析报告生成
+
+不在本任务职责范围:
+  - PRD文档生成（由PM智能体负责）
+  - 用户故事编写（由SM智能体负责）
+  - 任务拆解与排期（由SM智能体负责）
+
+下游交接:
+  交接对象: PM智能体
+  交接物: docs/rag/ 目录下的完整知识文档和分析报告
+  交接命令: "*create-prd docs/rag/"
+```
 
 ---
 
@@ -948,7 +968,7 @@ docs/rag/
 
 ---
 
-## Phase 5: 需求分析与PRD生成
+## Phase 5: 需求分析报告生成
 
 ### 5.1 分析输入整合
 
@@ -969,8 +989,8 @@ docs/rag/
 分析维度:
   功能分析:
     - 核心功能拆解
-    - 功能优先级排序
-    - 功能依赖关系
+    - 功能优先级排序（P0/P1/P2）
+    - 功能依赖关系图
 
   用户分析:
     - 用户角色定义
@@ -980,7 +1000,7 @@ docs/rag/
   技术分析:
     - 技术可行性评估（基于技术架构和编码规范）
     - 与现有系统的兼容性（基于中间件和数据模型）
-    - 技术风险识别
+    - 技术风险识别与评估
 
   业务分析:
     - 业务规则验证（基于业务知识）
@@ -996,32 +1016,242 @@ docs/rag/
     - 现有能力 vs 需求能力
     - 需要新增/修改的功能
     - 需要新增/修改的数据
+
+  风险分析:
+    - 技术风险清单
+    - 业务风险清单
+    - 依赖风险清单
+    - 风险缓解建议
 ```
 
-### 5.3 PRD生成流程
+### 5.3 需求分析报告生成流程
 
 ```yaml
-PRD生成:
+报告生成:
   步骤1:
     动作: 整合所有知识输入
     输入: docs/rag/ 目录下的所有知识文件
     输出: 知识上下文汇总
 
   步骤2:
-    动作: 执行需求分析(5.2维度)
-    输出: 需求分析报告
+    动作: 执行多维度需求分析(5.2)
+    输出: 各维度分析结论
 
   步骤3:
-    动作: 套用PRD模板(prd-tmpl.yaml)
-    输出: PRD草稿
+    动作: 识别待澄清问题
+    输出: 待确认事项清单
 
   步骤4:
-    动作: 启发式验证(advanced-elicitation)
-    输出: 优化后的PRD
+    动作: 生成需求分析报告
+    输出: docs/rag/_analysis-report.md
 
   步骤5:
-    动作: 输出最终PRD到指定位置
-    输出: docs/prd.md
+    动作: 更新知识索引
+    输出: docs/rag/_index.md (更新)
+```
+
+### 5.4 需求分析报告模板
+
+保存到 `docs/rag/_analysis-report.md`：
+
+```markdown
+# 需求分析报告
+
+## 元信息
+- 源需求文档: {req_file}
+- 分析时间: {timestamp}
+- 分析师: Analyst Agent
+- 报告版本: 1.0
+
+---
+
+## 1. 需求概述
+
+### 1.1 需求背景
+{基于req.txt提取的背景信息}
+
+### 1.2 核心目标
+{需求要达成的核心目标}
+
+### 1.3 范围边界
+- **包含**: {明确包含的内容}
+- **不包含**: {明确排除的内容}
+
+---
+
+## 2. 功能分析
+
+### 2.1 功能清单
+
+| 序号 | 功能名称 | 优先级 | 描述 | 依赖功能 |
+|------|----------|--------|------|----------|
+| F001 | {功能名} | P0/P1/P2 | {描述} | {依赖} |
+
+### 2.2 功能依赖关系
+
+```mermaid
+graph TD
+    F001 --> F002
+    F002 --> F003
+```
+
+### 2.3 功能优先级说明
+- **P0 (必须实现)**: {列表}
+- **P1 (重要)**: {列表}
+- **P2 (可选)**: {列表}
+
+---
+
+## 3. 用户分析
+
+### 3.1 用户角色
+
+| 角色 | 描述 | 主要操作 | 权限级别 |
+|------|------|----------|----------|
+| {角色名} | {描述} | {操作列表} | {权限} |
+
+### 3.2 用户旅程
+{关键用户旅程描述}
+
+---
+
+## 4. 数据分析
+
+### 4.1 数据实体清单
+
+| 实体名称 | 描述 | 核心属性 | 关联实体 |
+|----------|------|----------|----------|
+| {实体名} | {描述} | {属性} | {关联} |
+
+### 4.2 数据关系图
+
+```mermaid
+erDiagram
+    EntityA ||--o{ EntityB : contains
+```
+
+### 4.3 与现有数据模型的兼容性
+- **可复用**: {已有实体/表}
+- **需新增**: {新实体/表}
+- **需修改**: {需变更的实体/表}
+
+---
+
+## 5. 技术分析
+
+### 5.1 技术可行性评估
+
+| 功能 | 可行性 | 依赖技术 | 风险等级 | 备注 |
+|------|--------|----------|----------|------|
+| {功能} | 高/中/低 | {技术} | 高/中/低 | {备注} |
+
+### 5.2 与现有系统兼容性
+- **架构兼容**: {评估结论}
+- **中间件兼容**: {评估结论}
+- **编码规范兼容**: {评估结论}
+
+### 5.3 技术实现建议
+{基于知识库获取的技术规范，给出实现建议}
+
+---
+
+## 6. 业务规则汇总
+
+### 6.1 核心业务规则
+
+| 规则ID | 规则名称 | 规则描述 | 来源 |
+|--------|----------|----------|------|
+| BR001 | {名称} | {描述} | 知识库/需求文档 |
+
+### 6.2 业务流程
+
+| 流程名称 | 触发条件 | 主要步骤 | 异常处理 |
+|----------|----------|----------|----------|
+| {流程名} | {条件} | {步骤} | {异常} |
+
+---
+
+## 7. 差距分析
+
+### 7.1 能力差距
+
+| 需求能力 | 现有能力 | 差距 | 解决方案 |
+|----------|----------|------|----------|
+| {需求} | {现有} | {差距} | {方案} |
+
+### 7.2 新增/修改清单
+- **新增功能**: {列表}
+- **修改功能**: {列表}
+- **新增数据**: {列表}
+- **修改数据**: {列表}
+
+---
+
+## 8. 风险分析
+
+### 8.1 风险清单
+
+| 风险ID | 风险类型 | 风险描述 | 可能性 | 影响 | 缓解措施 |
+|--------|----------|----------|--------|------|----------|
+| R001 | 技术/业务/依赖 | {描述} | 高/中/低 | 高/中/低 | {措施} |
+
+### 8.2 关键风险说明
+{高风险项的详细说明}
+
+---
+
+## 9. 待澄清事项
+
+### 9.1 业务待澄清
+
+| 序号 | 问题 | 上下文 | 建议选项 |
+|------|------|--------|----------|
+| Q001 | {问题} | {上下文} | {选项A/B/C} |
+
+### 9.2 技术待澄清
+
+| 序号 | 问题 | 上下文 | 建议选项 |
+|------|------|--------|----------|
+| Q001 | {问题} | {上下文} | {选项A/B/C} |
+
+---
+
+## 10. 知识库引用索引
+
+| 知识文件 | 路径 | 主要内容 |
+|----------|------|----------|
+| {文件名} | docs/rag/{path} | {内容摘要} |
+
+---
+
+## 11. 下游交接清单
+
+### 11.1 交接给PM智能体的输入
+
+```yaml
+交接物清单:
+  必读文件:
+    - docs/rag/_analysis-report.md    # 本报告
+    - docs/rag/_requirement-parsing.yaml  # 需求解析结果
+
+  知识文件目录:
+    - docs/rag/business/    # 业务知识
+    - docs/rag/technical/   # 技术知识
+    - docs/rag/constraints/ # 约束条件
+
+  原始需求:
+    - {req_file}
+
+建议后续动作:
+  - PM智能体执行: "*create-prd docs/rag/"
+  - 重点关注: 待澄清事项（第9节）
+  - 风险跟踪: 风险清单（第8节）
+```
+
+---
+
+*报告生成时间: {timestamp}*
+*Analyst Agent - XiaoMa Framework*
 ```
 
 ---
@@ -1040,7 +1270,6 @@ PRD生成:
 参数:
   req_file: 需求文档路径 (默认: req.txt)
   rag_output: 知识输出路径 (默认: docs/rag/)
-  prd_output: PRD输出路径 (默认: docs/prd.md)
   skip_rag: 跳过知识库查询 (默认: false)
   interactive: 交互模式 (默认: true)
 ```
@@ -1050,8 +1279,8 @@ PRD生成:
 1. **解析阶段**: 展示需求解析结果，保存到 `docs/rag/_requirement-parsing.yaml`，请用户确认
 2. **提问阶段**: 展示问题清单，保存到 `docs/rag/_questions.md`，请用户确认或调整
 3. **查询阶段**: 依次查询知识库，将返回结果保存到 `docs/rag/` 对应子目录
-4. **分析阶段**: 展示分析结论，请用户确认
-5. **生成阶段**: 生成PRD草稿，启用启发式优化，输出到 `docs/prd.md`
+4. **分析阶段**: 执行多维度需求分析，生成分析报告
+5. **完成阶段**: 输出 `docs/rag/_analysis-report.md`，提示用户交接给PM智能体
 
 ### 相关命令
 
@@ -1059,8 +1288,31 @@ PRD生成:
 |------|------|
 | `*generate-rag-questions {req_file}` | 单独执行问题生成，保存到 `docs/rag/_questions.md` |
 | `*land-knowledge` | 将知识库返回内容保存到 `docs/rag/` 对应子目录 |
-| `*create-prd-from-rag` | 基于 `docs/rag/` 知识生成PRD |
+| `*generate-analysis-report` | 基于 `docs/rag/` 知识生成需求分析报告 |
 
 ### YOLO模式
 
 通过 `*yolo` 命令切换YOLO模式，一次性完成所有步骤，跳过中间确认环节。
+
+---
+
+## 任务完成标志
+
+```yaml
+完成条件:
+  必要输出:
+    - docs/rag/_requirement-parsing.yaml  # 需求解析结果
+    - docs/rag/_questions.md              # 问题清单
+    - docs/rag/_index.md                  # 知识索引
+    - docs/rag/_analysis-report.md        # 需求分析报告
+    - docs/rag/{category}/*.md            # 分类知识文件
+
+  完成提示: |
+    ✅ 需求分析任务完成！
+
+    📁 输出目录: docs/rag/
+    📋 分析报告: docs/rag/_analysis-report.md
+
+    🔄 下一步: 请将分析结果交接给PM智能体
+    💡 执行命令: *create-prd docs/rag/
+```