@zeyue0329/xiaoma-cli 1.0.42 → 1.0.43

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (32) hide show
  1. package/.idea/workspace.xml +20 -5
  2. package/JAVA-BACKEND-COMMANDS-REFERENCE.md +2 -2
  3. package/JAVA-BACKEND-ITERATION-GUIDE.md +31 -31
  4. package/dist/agents/architect.txt +1 -1
  5. package/dist/agents/pm.txt +20 -20
  6. package/dist/agents/po.txt +1 -1
  7. package/dist/agents/sm.txt +1 -1
  8. package/dist/agents/workflow-executor.txt +22 -22
  9. package/dist/agents/xiaoma-master.txt +20 -20
  10. package/dist/teams/team-all.txt +45 -45
  11. package/dist/teams/team-fullstack-with-database.txt +24 -24
  12. package/dist/teams/team-fullstack.txt +22 -22
  13. package/dist/teams/team-ide-minimal.txt +2 -2
  14. package/dist/teams/team-no-ui.txt +22 -22
  15. package/docs/architecture-sharding-modification.md +4 -4
  16. package/docs/automated-requirements-analysis-outputs.md +29 -29
  17. package/docs/prd/workflow-coordinator-prd.md +2 -2
  18. package/package.json +1 -1
  19. package/xiaoma-core/agents/pm.md +1 -1
  20. package/xiaoma-core/agents/po.md +1 -1
  21. package/xiaoma-core/agents/requirements-coverage-auditor.yaml +1 -1
  22. package/xiaoma-core/agents/sm.md +1 -1
  23. package/xiaoma-core/agents/workflow-executor.md +22 -22
  24. package/xiaoma-core/tasks/batch-story-generation.md +1 -1
  25. package/xiaoma-core/tasks/requirements-coverage-audit.md +5 -5
  26. package/xiaoma-core/templates/fullstack-architecture-tmpl.yaml +1 -1
  27. package/xiaoma-core/templates/prd-tmpl.yaml +19 -19
  28. package/xiaoma-core/templates/requirements-coverage-audit.yaml +6 -6
  29. package/xiaoma-core/workflows/automated-requirements-analysis.yaml +90 -90
  30. package/xiaoma-core/workflows/automated-requirements-development.yaml +10 -10
  31. package/xiaoma-core/workflows/enhanced-fullstack-with-qa-loop.yaml +1 -1
  32. package/xiaoma-core/workflows/full-requirement-automation.yaml +1 -1
@@ -5,11 +5,25 @@
5
5
  </component>
6
6
  <component name="ChangeListManager">
7
7
  <list default="true" id="4ca3d6ad-bc27-4e67-9acd-07dccd21dd95" name="Changes" comment="drop unchecked message">
8
- <change beforePath="$PROJECT_DIR$/dist/agents/architect.txt" beforeDir="false" afterPath="$PROJECT_DIR$/dist/agents/architect.txt" afterDir="false" />
9
- <change beforePath="$PROJECT_DIR$/dist/teams/team-all.txt" beforeDir="false" afterPath="$PROJECT_DIR$/dist/teams/team-all.txt" afterDir="false" />
10
- <change beforePath="$PROJECT_DIR$/dist/teams/team-fullstack-with-database.txt" beforeDir="false" afterPath="$PROJECT_DIR$/dist/teams/team-fullstack-with-database.txt" afterDir="false" />
11
- <change beforePath="$PROJECT_DIR$/dist/teams/team-fullstack.txt" beforeDir="false" afterPath="$PROJECT_DIR$/dist/teams/team-fullstack.txt" afterDir="false" />
12
- <change beforePath="$PROJECT_DIR$/dist/teams/team-no-ui.txt" beforeDir="false" afterPath="$PROJECT_DIR$/dist/teams/team-no-ui.txt" afterDir="false" />
8
+ <change beforePath="$PROJECT_DIR$/JAVA-BACKEND-COMMANDS-REFERENCE.md" beforeDir="false" afterPath="$PROJECT_DIR$/JAVA-BACKEND-COMMANDS-REFERENCE.md" afterDir="false" />
9
+ <change beforePath="$PROJECT_DIR$/JAVA-BACKEND-ITERATION-GUIDE.md" beforeDir="false" afterPath="$PROJECT_DIR$/JAVA-BACKEND-ITERATION-GUIDE.md" afterDir="false" />
10
+ <change beforePath="$PROJECT_DIR$/docs/architecture-sharding-modification.md" beforeDir="false" afterPath="$PROJECT_DIR$/docs/architecture-sharding-modification.md" afterDir="false" />
11
+ <change beforePath="$PROJECT_DIR$/docs/automated-requirements-analysis-outputs.md" beforeDir="false" afterPath="$PROJECT_DIR$/docs/automated-requirements-analysis-outputs.md" afterDir="false" />
12
+ <change beforePath="$PROJECT_DIR$/docs/prd/workflow-coordinator-prd.md" beforeDir="false" afterPath="$PROJECT_DIR$/docs/prd/workflow-coordinator-prd.md" afterDir="false" />
13
+ <change beforePath="$PROJECT_DIR$/xiaoma-core/agents/pm.md" beforeDir="false" afterPath="$PROJECT_DIR$/xiaoma-core/agents/pm.md" afterDir="false" />
14
+ <change beforePath="$PROJECT_DIR$/xiaoma-core/agents/po.md" beforeDir="false" afterPath="$PROJECT_DIR$/xiaoma-core/agents/po.md" afterDir="false" />
15
+ <change beforePath="$PROJECT_DIR$/xiaoma-core/agents/requirements-coverage-auditor.yaml" beforeDir="false" afterPath="$PROJECT_DIR$/xiaoma-core/agents/requirements-coverage-auditor.yaml" afterDir="false" />
16
+ <change beforePath="$PROJECT_DIR$/xiaoma-core/agents/sm.md" beforeDir="false" afterPath="$PROJECT_DIR$/xiaoma-core/agents/sm.md" afterDir="false" />
17
+ <change beforePath="$PROJECT_DIR$/xiaoma-core/agents/workflow-executor.md" beforeDir="false" afterPath="$PROJECT_DIR$/xiaoma-core/agents/workflow-executor.md" afterDir="false" />
18
+ <change beforePath="$PROJECT_DIR$/xiaoma-core/tasks/batch-story-generation.md" beforeDir="false" afterPath="$PROJECT_DIR$/xiaoma-core/tasks/batch-story-generation.md" afterDir="false" />
19
+ <change beforePath="$PROJECT_DIR$/xiaoma-core/tasks/requirements-coverage-audit.md" beforeDir="false" afterPath="$PROJECT_DIR$/xiaoma-core/tasks/requirements-coverage-audit.md" afterDir="false" />
20
+ <change beforePath="$PROJECT_DIR$/xiaoma-core/templates/fullstack-architecture-tmpl.yaml" beforeDir="false" afterPath="$PROJECT_DIR$/xiaoma-core/templates/fullstack-architecture-tmpl.yaml" afterDir="false" />
21
+ <change beforePath="$PROJECT_DIR$/xiaoma-core/templates/prd-tmpl.yaml" beforeDir="false" afterPath="$PROJECT_DIR$/xiaoma-core/templates/prd-tmpl.yaml" afterDir="false" />
22
+ <change beforePath="$PROJECT_DIR$/xiaoma-core/templates/requirements-coverage-audit.yaml" beforeDir="false" afterPath="$PROJECT_DIR$/xiaoma-core/templates/requirements-coverage-audit.yaml" afterDir="false" />
23
+ <change beforePath="$PROJECT_DIR$/xiaoma-core/workflows/automated-requirements-analysis.yaml" beforeDir="false" afterPath="$PROJECT_DIR$/xiaoma-core/workflows/automated-requirements-analysis.yaml" afterDir="false" />
24
+ <change beforePath="$PROJECT_DIR$/xiaoma-core/workflows/automated-requirements-development.yaml" beforeDir="false" afterPath="$PROJECT_DIR$/xiaoma-core/workflows/automated-requirements-development.yaml" afterDir="false" />
25
+ <change beforePath="$PROJECT_DIR$/xiaoma-core/workflows/enhanced-fullstack-with-qa-loop.yaml" beforeDir="false" afterPath="$PROJECT_DIR$/xiaoma-core/workflows/enhanced-fullstack-with-qa-loop.yaml" afterDir="false" />
26
+ <change beforePath="$PROJECT_DIR$/xiaoma-core/workflows/full-requirement-automation.yaml" beforeDir="false" afterPath="$PROJECT_DIR$/xiaoma-core/workflows/full-requirement-automation.yaml" afterDir="false" />
13
27
  </list>
14
28
  <option name="SHOW_DIALOG" value="false" />
15
29
  <option name="HIGHLIGHT_CONFLICTS" value="true" />
@@ -74,6 +88,7 @@
74
88
  <workItem from="1762781553645" duration="3390000" />
75
89
  <workItem from="1762933631198" duration="16000" />
76
90
  <workItem from="1763045898895" duration="4599000" />
91
+ <workItem from="1763520819252" duration="1863000" />
77
92
  </task>
78
93
  <task id="LOCAL-00001" summary="drop unchecked message">
79
94
  <option name="closed" value="true" />
@@ -29,7 +29,7 @@ Agent 没有对应的专用命令,通过详细的 Prompt 描述让 Agent 理
29
29
  | 1.1 分析现有架构 | Architect | ❌ 不需要 | 无 | 通过详细 Prompt 描述分析任务 |
30
30
  | 1.2 创建 Brownfield PRD | PM | ✅ **需要** | `*create-brownfield-prd` | 必须在 Prompt 结尾明确执行此命令 |
31
31
  | 1.2 验证 PRD 质量 | PM | ❌ 不需要 | 无 | 通过 Prompt 要求 Agent 自我审查 |
32
- | 1.3 创建史诗 | PM | ✅ **需要** | `*create-epic` | 必须在 Prompt 结尾明确执行此命令 |
32
+ | 1.3 创建模块 | PM | ✅ **需要** | `*create-epic` | 必须在 Prompt 结尾明确执行此命令 |
33
33
 
34
34
  ---
35
35
 
@@ -237,7 +237,7 @@ Agent 没有对应的专用命令,通过详细的 Prompt 描述让 Agent 理
237
237
 
238
238
  | 任务类型 | 是否需要命令 | 示例 |
239
239
  | ------------------------------- | ------------ | --------------------------------- |
240
- | 创建正式文档(PRD、史诗、故事) | ✅ 需要 | `*create-epic`, `*draft-enhanced` |
240
+ | 创建正式文档(PRD、模块、故事) | ✅ 需要 | `*create-epic`, `*draft-enhanced` |
241
241
  | 开发/测试代码 | ✅ 需要 | `*develop-story`, `*run-tests` |
242
242
  | 质量审查和决策 | ✅ 需要 | `*review`, `*gate` |
243
243
  | 探索性分析 | ❌ 不需要 | 分析架构、识别故事列表 |
@@ -21,7 +21,7 @@
21
21
  /your-project/
22
22
  ├── src/ # Java 源码
23
23
  ├── docs/ # 文档目录
24
- │ ├── prd/ # PRD 和史诗
24
+ │ ├── prd/ # PRD 和模块
25
25
  │ └── stories/ # 用户故事
26
26
  ├── .xiaoma-core/ # xiaoma-core 配置
27
27
  └── req.txt # PM 提供的需求文档
@@ -130,7 +130,7 @@ cd /your-project/
130
130
  6. 数据需求(数据库变更)
131
131
  7. API 需求(新增/修改的接口)
132
132
  8. 验收标准
133
- 9. 实施计划(史诗拆分建议)
133
+ 9. 实施计划(模块拆分建议)
134
134
 
135
135
  **特别注意**:
136
136
  - 这是现有项目的迭代需求,需要考虑与现有系统的兼容性
@@ -169,41 +169,41 @@ cd /your-project/
169
169
 
170
170
  ---
171
171
 
172
- ### 📍 **步骤 1.3:拆分史诗(针对大型需求)**
172
+ ### 📍 **步骤 1.3:拆分模块(针对大型需求)**
173
173
 
174
- **判断依据**:如果 PRD 包含多个独立的功能模块(≥3个),建议拆分为史诗。
174
+ **判断依据**:如果 PRD 包含多个独立的功能模块(≥3个),建议拆分为模块。
175
175
 
176
176
  #### 操作步骤:
177
177
 
178
178
  **① 保持 PM Agent 激活状态**
179
179
 
180
- **② 发送 Prompt(针对每个史诗)**
180
+ **② 发送 Prompt(针对每个模块)**
181
181
 
182
182
  ```
183
- 基于刚才创建的 PRD,我需要创建史诗。
183
+ 基于刚才创建的 PRD,我需要创建模块。
184
184
 
185
- **史诗拆分建议**:
186
- 根据 PRD 的功能模块,建议拆分为以下史诗:
187
- 1. [史诗1名称]:[功能描述]
188
- 2. [史诗2名称]:[功能描述]
189
- 3. [史诗3名称]:[功能描述]
185
+ **模块拆分建议**:
186
+ 根据 PRD 的功能模块,建议拆分为以下模块:
187
+ 1. [模块1名称]:[功能描述]
188
+ 2. [模块2名称]:[功能描述]
189
+ 3. [模块3名称]:[功能描述]
190
190
 
191
191
  **当前任务**:
192
- 请为第一个史诗"[史诗1名称]"创建史诗文档。
192
+ 请为第一个模块"[模块1名称]"创建模块文档。
193
193
 
194
- **史诗信息**:
195
- - 史诗名称:[史诗1名称]
196
- - 功能范围:[详细描述此史诗包含的功能]
194
+ **模块信息**:
195
+ - 模块名称:[模块1名称]
196
+ - 功能范围:[详细描述此模块包含的功能]
197
197
  - 业务价值:[业务价值说明]
198
198
  - 优先级:高/中/低
199
- - 依赖关系:[是否依赖其他史诗]
199
+ - 依赖关系:[是否依赖其他模块]
200
200
 
201
- **史诗文档要求**:
202
- 1. 史诗级别的目标和价值
201
+ **模块文档要求**:
202
+ 1. 模块级别的目标和价值
203
203
  2. 包含的用户故事清单(初步识别)
204
- 3. 技术设计概要(针对此史诗)
205
- 4. 数据库变更(针对此史诗)
206
- 5. API 接口清单(针对此史诗)
204
+ 3. 技术设计概要(针对此模块)
205
+ 4. 数据库变更(针对此模块)
206
+ 5. API 接口清单(针对此模块)
207
207
  6. 验收标准
208
208
  7. 估算工作量
209
209
 
@@ -218,8 +218,8 @@ cd /your-project/
218
218
 
219
219
  **期望输出**:
220
220
 
221
- - 史诗文档:`docs/prd/史诗-[名称].md`
222
- - 对每个史诗重复此步骤
221
+ - 模块文档:`docs/prd/Epic[名称].md`
222
+ - 对每个模块重复此步骤
223
223
 
224
224
  ---
225
225
 
@@ -347,7 +347,7 @@ cd /your-project/
347
347
  **用户故事清单格式**:
348
348
  请以表格形式列出所有用户故事:
349
349
 
350
- | 编号 | 故事名称 | 所属史诗 | 优先级 | 估算复杂度 | 依赖 |
350
+ | 编号 | 故事名称 | 所属模块 | 优先级 | 估算复杂度 | 依赖 |
351
351
  |------|---------|---------|--------|----------|------|
352
352
  | US-01 | [名称] | Epic-01 | 高 | 中 | 无 |
353
353
  | US-02 | [名称] | Epic-01 | 高 | 高 | US-01 |
@@ -384,7 +384,7 @@ cd /your-project/
384
384
  **故事基本信息**:
385
385
  - 故事 ID:US-01
386
386
  - 故事名称:[从清单中获取]
387
- - 所属史诗:[Epic 名称]
387
+ - 所属模块:[Epic 名称]
388
388
  - 优先级:高/中/低
389
389
  - 估算复杂度:低/中/高
390
390
 
@@ -1250,7 +1250,7 @@ cd /your-project/
1250
1250
 
1251
1251
  **审计范围**:
1252
1252
  - PRD 文档:`docs/prd/云链API平台需求文档.md`
1253
- - 史诗文档:`docs/prd/史诗-*.md`(如有)
1253
+ - 模块文档:`docs/prd/Epic-*.md`(如有)
1254
1254
  - 所有用户故事:`docs/stories/epic*-story*.md`
1255
1255
 
1256
1256
  **审计任务**:
@@ -1481,7 +1481,7 @@ cd /your-project/
1481
1481
  - 迭代目标
1482
1482
 
1483
1483
  **2. 完成故事清单**:
1484
- | 故事ID | 故事名称 | 所属史诗 | 优先级 | 状态 | 完成日期 | 开发者 |
1484
+ | 故事ID | 故事名称 | 所属模块 | 优先级 | 状态 | 完成日期 | 开发者 |
1485
1485
  |--------|---------|---------|-------|------|---------|--------|
1486
1486
  | US-01 | [名称] | Epic-01 | 高 | Done | 2025-01-15 | Dev Agent |
1487
1487
  | ... | ... | ... | ... | ... | ... | ... |
@@ -1492,13 +1492,13 @@ cd /your-project/
1492
1492
  - 完成率:[百分比]
1493
1493
  - 高优先级完成率:[百分比]
1494
1494
 
1495
- **4. 功能交付清单**(按史诗分组):
1496
- **Epic 01: [史诗名称]**
1495
+ **4. 功能交付清单**(按模块分组):
1496
+ **Epic 01: [模块名称]**
1497
1497
  - ✅ [功能1](US-01)
1498
1498
  - ✅ [功能2](US-02)
1499
1499
  - ...
1500
1500
 
1501
- **Epic 02: [史诗名称]**
1501
+ **Epic 02: [模块名称]**
1502
1502
  - ✅ [功能3](US-03)
1503
1503
  - ...
1504
1504
 
@@ -2047,7 +2047,7 @@ systemctl start your-service
2047
2047
  1. **需求分析和 PRD 创建**(1-2 小时)
2048
2048
  - Architect: 分析现有架构
2049
2049
  - PM: 创建 Brownfield PRD
2050
- - PM: 拆分史诗(如需要)
2050
+ - PM: 拆分模块(如需要)
2051
2051
 
2052
2052
  2. **技术架构设计**(1-2 小时)
2053
2053
  - Architect: 后端增量设计
@@ -2874,7 +2874,7 @@ sections:
2874
2874
  1. 如果是 REST API, 创建一个 OpenAPI 3.0 规范
2875
2875
  2. 如果是 GraphQL, 提供 GraphQL 模式
2876
2876
  3. 如果是 tRPC, 展示路由定义
2877
- 4. 包括来自史诗/故事的所有端点
2877
+ 4. 包括来自模块/故事的所有端点
2878
2878
  5. 基于数据模型定义请求/响应模式
2879
2879
  6. 记录认证要求
2880
2880
  7. 包括请求/响应示例
@@ -76,7 +76,7 @@ commands:
76
76
  - create-brownfield-epic: 运行任务 brownfield-create-epic.md
77
77
  - create-brownfield-prd: 使用模板 brownfield-prd-tmpl.yaml 运行任务 create-doc.md
78
78
  - create-brownfield-story: 运行任务 brownfield-create-story.md
79
- - create-epic: 为现有项目项目创建史诗 (任务 brownfield-create-epic)
79
+ - create-epic: 为现有项目项目创建模块 (任务 brownfield-create-epic)
80
80
  - create-prd: 使用模板 prd-tmpl.yaml 运行任务 create-doc.md
81
81
  - create-story: 从需求创建用户故事 (任务 brownfield-create-story)
82
82
  - doc-out: 将完整文档输出到当前目标文件
@@ -1524,7 +1524,7 @@ sections:
1524
1524
  title: 关键交互范式
1525
1525
  - id: core-screens
1526
1526
  title: 核心屏幕与视图
1527
- instruction: 从产品角度看,为实现 PRD 的价值和目标,最关键的屏幕或视图是什么?这旨在提供概念性的高层概览,以驱动粗略的史诗或用户故事。
1527
+ instruction: 从产品角度看,为实现 PRD 的价值和目标,最关键的屏幕或视图是什么?这旨在提供概念性的高层概览,以驱动粗略的模块或用户故事。
1528
1528
  examples:
1529
1529
  - "登录屏幕"
1530
1530
  - "主仪表盘"
@@ -1574,38 +1574,38 @@ sections:
1574
1574
  instruction: 在起草本文档的整个过程中,如果提出或发现任何其他适合架构师的技术假设,请在此处作为额外的项目符号添加。
1575
1575
 
1576
1576
  - id: epic-list
1577
- title: 史诗列表
1577
+ title: 模块列表
1578
1578
  instruction: |
1579
- 向用户呈现一份高层次的史诗列表以供批准。每个史诗应有一个标题和一个简短的(1句话)目标陈述。这使用户能在深入细节之前审阅整体结构。
1579
+ 向用户呈现一份高层次的模块列表以供批准。每个模块应有一个标题和一个简短的(1句话)目标陈述。这使用户能在深入细节之前审阅整体结构。
1580
1580
 
1581
- 关键:史诗必须遵循敏捷最佳实践,保持逻辑上的顺序:
1581
+ 关键:模块必须遵循敏捷最佳实践,保持逻辑上的顺序:
1582
1582
 
1583
- - 每个史诗都应交付一个重要的、端到端的、完全可部署且可测试的功能增量。
1584
- - 史诗 1 必须建立基础项目设施(应用设置、Git、CI/CD、核心服务),除非我们是向现有应用添加新功能。同时,它还应交付一个初始功能,即使只是一个健康检查路由或一个简单的金丝雀页面显示——在为第一个史诗编写用户故事时要记住这一点!
1585
- - 每个后续的史诗都在之前史诗功能的基础上构建,交付主要的功能模块,这些模块在部署时能为用户或业务提供切实的价值。
1586
- - 并非每个项目都需要多个史诗,一个史诗需要交付价值。例如,一个已完成的 API 即使 UI 尚未完成并计划在另一个史诗中实现,也可以交付价值。
1587
- - 倾向于设置较少的史诗,但要告知用户你的理由,并提供拆分选项,如果某些史诗看起来太大或关注点分散的话。
1588
- - 横切关注点应该贯穿于史诗和用户故事中,而不是作为最后的用户故事。例如,在一个史诗的最后一个故事中添加日志框架,或者在项目结束时作为最后一个史诗或故事来做,这将非常糟糕,因为我们从一开始就没有日志记录。
1583
+ - 每个模块都应交付一个重要的、端到端的、完全可部署且可测试的功能增量。
1584
+ - 模块 1 必须建立基础项目设施(应用设置、Git、CI/CD、核心服务),除非我们是向现有应用添加新功能。同时,它还应交付一个初始功能,即使只是一个健康检查路由或一个简单的金丝雀页面显示——在为第一个模块编写用户故事时要记住这一点!
1585
+ - 每个后续的模块都在之前模块功能的基础上构建,交付主要的功能模块,这些模块在部署时能为用户或业务提供切实的价值。
1586
+ - 并非每个项目都需要多个模块,一个模块需要交付价值。例如,一个已完成的 API 即使 UI 尚未完成并计划在另一个模块中实现,也可以交付价值。
1587
+ - 倾向于设置较少的模块,但要告知用户你的理由,并提供拆分选项,如果某些模块看起来太大或关注点分散的话。
1588
+ - 横切关注点应该贯穿于模块和用户故事中,而不是作为最后的用户故事。例如,在一个模块的最后一个故事中添加日志框架,或者在项目结束时作为最后一个模块或故事来做,这将非常糟糕,因为我们从一开始就没有日志记录。
1589
1589
  elicit: true
1590
1590
  examples:
1591
- - "史诗 1:基础与核心设施:建立项目设置、认证和基本用户管理"
1592
- - "史诗 2:核心业务实体:创建和管理主要领域对象的 CRUD 操作"
1593
- - "史诗 3:用户工作流与交互:实现关键用户旅程和业务流程"
1594
- - "史诗 4:报告与分析:为用户提供洞察和数据可视化"
1591
+ - "模块 1:基础与核心设施:建立项目设置、认证和基本用户管理"
1592
+ - "模块 2:核心业务实体:创建和管理主要领域对象的 CRUD 操作"
1593
+ - "模块 3:用户工作流与交互:实现关键用户旅程和业务流程"
1594
+ - "模块 4:报告与分析:为用户提供洞察和数据可视化"
1595
1595
 
1596
1596
  - id: epic-details
1597
- title: 史诗 {{epic_number}} {{epic_title}}
1597
+ title: 模块 {{epic_number}} {{epic_title}}
1598
1598
  repeatable: true
1599
1599
  instruction: |
1600
- 在史诗列表被批准后,将每个史诗及其所有的用户故事和验收标准作为一个完整的审查单元呈现。
1600
+ 在模块列表被批准后,将每个模块及其所有的用户故事和验收标准作为一个完整的审查单元呈现。
1601
1601
 
1602
- 为每个史诗提供扩展的目标(2-3 句话描述所有故事将实现的目标和价值)。
1602
+ 为每个模块提供扩展的目标(2-3 句话描述所有故事将实现的目标和价值)。
1603
1603
 
1604
1604
  关键的用户故事排序要求:
1605
1605
 
1606
- - 每个史诗中的用户故事必须在逻辑上是顺序的。
1606
+ - 每个模块中的用户故事必须在逻辑上是顺序的。
1607
1607
  - 每个故事都应该是一个“垂直切片”,交付完整的功能,除了项目基础的早期使能型故事。
1608
- - 任何故事都不应依赖于后续故事或史诗的工作。
1608
+ - 任何故事都不应依赖于后续故事或模块的工作。
1609
1609
  - 识别并注明任何直接的前置故事。
1610
1610
  - 关注“做什么”和“为什么”,而不是“怎么做”(将技术实现留给架构师),但要足够精确以支持故事之间逻辑上顺序的操作。
1611
1611
  - 确保每个故事都交付明确的用户或业务价值,尽量避免使能型故事,而是将它们构建到交付价值的故事中。
@@ -76,7 +76,7 @@ persona:
76
76
  commands:
77
77
  - help: 显示以下命令的编号列表以供选择
78
78
  - correct-course: 执行 correct-course 任务
79
- - create-epic: 为现有项目项目创建史诗 (任务 brownfield-create-epic)
79
+ - create-epic: 为现有项目项目创建模块 (任务 brownfield-create-epic)
80
80
  - create-story: 从需求创建用户故事 (任务 brownfield-create-story)
81
81
  - doc-out: 将完整文档输出到当前目标文件
82
82
  - execute-checklist-po: 运行任务 execute-checklist (清单 po-master-checklist)
@@ -55,7 +55,7 @@ agent:
55
55
  id: sm
56
56
  title: Scrum Master
57
57
  icon: 🏃
58
- whenToUse: 用于创建故事、史诗管理、在派对模式下进行回顾以及敏捷流程指导
58
+ whenToUse: 用于创建故事、模块管理、在派对模式下进行回顾以及敏捷流程指导
59
59
  customization: null
60
60
  persona:
61
61
  role: 技术 Scrum Master - 故事准备专家
@@ -78,7 +78,7 @@ persona:
78
78
  - 自动切换智能体:根据工作流定义,自动使用 /analyst、/architect、/pm、/po、/sm、/dev、/qa 等命令切换到相应的智能体角色
79
79
  - 连续执行模式:完成一个步骤后,立即显示简短进度(1-2行)并**无需任何确认**直接进入下一个步骤,直到整个工作流完成或遇到真正的技术错误
80
80
  - 🚫 严禁中断询问:不要问'是否继续'、'请选择'、'您希望'等问题。用户启动工作流就是明确要求自动执行到底。唯一允许暂停的情况:文件不存在、执行报错、质量门控失败。
81
- - '✅ 正确的进度报告格式:简短报告 + 立即继续,例如:''✅ 步骤 3/6 完成: PM 创建 PRD → 立即开始步骤 4/6: PM 拆分史诗...'''
81
+ - '✅ 正确的进度报告格式:简短报告 + 立即继续,例如:''✅ 步骤 3/6 完成: PM 创建 PRD → 立即开始步骤 4/6: PM 拆分模块...'''
82
82
  commands:
83
83
  - help: 显示以下命令的编号列表以供选择
84
84
  - run-requirements-analysis: 🔥 自动化需求分析工作流(完全自动执行,不暂停)- 加载 automated-requirements-analysis.yaml 并连续执行所有 6 个步骤,从 req.txt 到最终的架构设计文档,全程自动化无需人工干预
@@ -158,7 +158,7 @@ workflow_stages:
158
158
  tasks:
159
159
  - 创建 Brownfield 项目迭代需求的 PRD 文档
160
160
  - 定义功能模块、数据变更、API 规范
161
- - 制定验收标准和史诗拆分建议
161
+ - 制定验收标准和模块拆分建议
162
162
  - 自检 PRD 质量(16项检查)
163
163
  outputs:
164
164
  - docs/prd/brownfield-iteration-prd.md
@@ -166,15 +166,15 @@ workflow_stages:
166
166
  stage_4_pm_epics:
167
167
  agent: pm
168
168
  command: "*create-epic"
169
- duration: "变动,取决于史诗数量"
169
+ duration: "变动,取决于模块数量"
170
170
  tasks:
171
- - 从 PRD 提取史诗清单
172
- - 循环创建每个史诗文档
171
+ - 从 PRD 提取模块清单
172
+ - 循环创建每个模块文档
173
173
  - 初步识别用户故事
174
174
  - 定义技术设计概要和数据库/API 变更
175
- - 验证史诗质量
175
+ - 验证模块质量
176
176
  outputs:
177
- - docs/epics/史诗-*.md (多个史诗文件)
177
+ - docs/epics/Epic-*.md (多个模块文件)
178
178
 
179
179
  stage_5_architect_design:
180
180
  agent: architect
@@ -183,7 +183,7 @@ workflow_stages:
183
183
  duration: "30-40分钟"
184
184
  inputs:
185
185
  - docs/prd/brownfield-iteration-prd.md
186
- - docs/epics/史诗-*.md
186
+ - docs/epics/Epic-*.md
187
187
  - docs/architecture/current-architecture-analysis.md
188
188
  tasks:
189
189
  - 设计新增数据模型(Entity + DDL)
@@ -231,7 +231,7 @@ workflow_stages:
231
231
  ├─ 步骤 1/6: Analyst 需求分析
232
232
  ├─ 步骤 2/6: Architect 架构分析
233
233
  ├─ 步骤 3/6: PM 创建 PRD
234
- ├─ 步骤 4/6: PM 拆分史诗
234
+ ├─ 步骤 4/6: PM 拆分模块
235
235
  ├─ 步骤 5/6: Architect 架构设计
236
236
  └─ 步骤 6/6: 生成需求分析报告
237
237
 
@@ -486,7 +486,7 @@ quality_gates:
486
486
  # ✓ 步骤 1/6: Analyst 需求分析 → 生成需求分析报告
487
487
  # ✓ 步骤 2/6: Architect 架构分析 → 生成架构分析报告
488
488
  # ✓ 步骤 3/6: PM 创建 PRD → 生成 Brownfield PRD
489
- # ✓ 步骤 4/6: PM 拆分史诗 → 生成 Epic 文档
489
+ # ✓ 步骤 4/6: PM 拆分模块 → 生成 Epic 文档
490
490
  # ✓ 步骤 5/6: Architect 架构设计 → 生成架构设计和数据库脚本
491
491
  # ✓ 步骤 6/6: 生成需求分析完成报告
492
492
  # ↓
@@ -509,7 +509,7 @@ quality_gates:
509
509
  # - docs/requirements/requirements-analysis.md
510
510
  # - docs/architecture/current-architecture-analysis.md
511
511
  # - docs/prd/brownfield-iteration-prd.md
512
- # - docs/epics/史诗-*.md
512
+ # - docs/epics/Epic-*.md
513
513
  # - docs/architecture/iteration-backend-design.md
514
514
  # - docs/architecture/db-migration-scripts.sql
515
515
  # - docs/architecture/*.md (7个模块文档)
@@ -561,7 +561,7 @@ quality_gates:
561
561
  # ✓ 步骤 1/6: 切换到 Analyst 进行需求分析(15-25分钟)
562
562
  # ✓ 步骤 2/6: 切换到 Architect 分析现有架构(10-20分钟)
563
563
  # ✓ 步骤 3/6: 切换到 PM 创建 Brownfield PRD(20-30分钟)
564
- # ✓ 步骤 4/6: 切换到 PM 拆分史诗(取决于史诗数量)
564
+ # ✓ 步骤 4/6: 切换到 PM 拆分模块(取决于模块数量)
565
565
  # ✓ 步骤 5/6: 切换到 Architect 设计增量架构(30-40分钟)
566
566
  # ✓ 步骤 6/6: 生成完成报告
567
567
 
@@ -569,7 +569,7 @@ quality_gates:
569
569
  # - docs/requirements/requirements-analysis.md
570
570
  # - docs/architecture/current-architecture-analysis.md
571
571
  # - docs/prd/brownfield-iteration-prd.md
572
- # - docs/epics/史诗-*.md
572
+ # - docs/epics/Epic-*.md
573
573
  # - docs/architecture/iteration-backend-design.md
574
574
  # - docs/architecture/db-migration-scripts.sql
575
575
  ```
@@ -619,7 +619,7 @@ quality_gates:
619
619
 
620
620
  # 输出示例:
621
621
  # 当前工作流: automated-requirements-analysis
622
- # 当前阶段: stage_4_pm_epics (PM 拆分史诗)
622
+ # 当前阶段: stage_4_pm_epics (PM 拆分模块)
623
623
  # 进度: 60% (3/5 步骤完成)
624
624
  # 当前智能体: pm
625
625
  # 已完成步骤:
@@ -628,7 +628,7 @@ quality_gates:
628
628
  # ✓ stage_2_architect - 架构分析
629
629
  # ✓ stage_3_pm_prd - PRD 创建
630
630
  # 进行中步骤:
631
- # ⏳ stage_4_pm_epics - 史诗拆分 (2/4 史诗已创建)
631
+ # ⏳ stage_4_pm_epics - 模块拆分 (2/4 模块已创建)
632
632
  # 待执行步骤:
633
633
  # ⏸ stage_5_architect_design - 架构设计
634
634
  ```
@@ -730,7 +730,7 @@ escalation_protocol:
730
730
  *validate-prerequisites
731
731
 
732
732
  # 检查项目:
733
- # ✓ Epic 文档存在 (docs/epics/史诗-*.md)
733
+ # ✓ Epic 文档存在 (docs/epics/Epic-*.md)
734
734
  # ✓ 数据库设计文档存在 (docs/architecture/iteration-backend-design.md)
735
735
  # ✓ 架构分析文档存在 (docs/architecture/current-architecture-analysis.md)
736
736
  # ✓ 代码生成器配置完成 (如使用 MyBatis-Plus Generator)
@@ -758,7 +758,7 @@ escalation_protocol:
758
758
  # 示例输出:
759
759
  # 检测到未完成的工作流: automated-requirements-analysis
760
760
  # 最后完成的步骤: stage_3_pm_prd (PRD 创建)
761
- # 准备从步骤 stage_4_pm_epics (史诗拆分) 恢复执行
761
+ # 准备从步骤 stage_4_pm_epics (模块拆分) 恢复执行
762
762
  #
763
763
  # 验证前序输出:
764
764
  # ✓ docs/requirements/requirements-analysis.md
@@ -938,7 +938,7 @@ completion_report:
938
938
  # ✅ 步骤 1/6: Analyst 需求分析 → 立即开始步骤 2/6...
939
939
  # ✅ 步骤 2/6: Architect 架构分析 → 立即开始步骤 3/6...
940
940
  # ✅ 步骤 3/6: PM 创建 PRD → 立即开始步骤 4/6...
941
- # ✅ 步骤 4/6: PM 拆分史诗 → 立即开始步骤 5/6...
941
+ # ✅ 步骤 4/6: PM 拆分模块 → 立即开始步骤 5/6...
942
942
  # ✅ 步骤 5/6: Architect 架构设计 → 立即开始步骤 6/6...
943
943
  # ✅ 步骤 6/6: 生成完成报告 → 🎉 工作流完成!
944
944
 
@@ -974,9 +974,9 @@ completion_report:
974
974
  [20-30分钟后]
975
975
  ✅ 步骤 3/6 完成: 已生成 docs/prd/brownfield-iteration-prd.md
976
976
 
977
- 正在执行步骤 4/6: PM 拆分史诗...
978
- [根据史诗数量]
979
- ✅ 步骤 4/6 完成: 已生成 4 个史诗文档
977
+ 正在执行步骤 4/6: PM 拆分模块...
978
+ [根据模块数量]
979
+ ✅ 步骤 4/6 完成: 已生成 4 个模块文档
980
980
 
981
981
  正在执行步骤 5/6: Architect 设计增量架构...
982
982
  [30-40分钟后]
@@ -992,7 +992,7 @@ completion_report:
992
992
  - docs/requirements/requirements-analysis.md
993
993
  - docs/architecture/current-architecture-analysis.md
994
994
  - docs/prd/brownfield-iteration-prd.md
995
- - docs/epics/史诗-*.md (4个)
995
+ - docs/epics/Epic-*.md (4个)
996
996
  - docs/architecture/iteration-backend-design.md
997
997
  - docs/architecture/db-migration-scripts.sql
998
998
 
@@ -4879,7 +4879,7 @@ sections:
4879
4879
  1. 如果是 REST API, 创建一个 OpenAPI 3.0 规范
4880
4880
  2. 如果是 GraphQL, 提供 GraphQL 模式
4881
4881
  3. 如果是 tRPC, 展示路由定义
4882
- 4. 包括来自史诗/故事的所有端点
4882
+ 4. 包括来自模块/故事的所有端点
4883
4883
  5. 基于数据模型定义请求/响应模式
4884
4884
  6. 记录认证要求
4885
4885
  7. 包括请求/响应示例
@@ -5795,7 +5795,7 @@ sections:
5795
5795
  title: 关键交互范式
5796
5796
  - id: core-screens
5797
5797
  title: 核心屏幕与视图
5798
- instruction: 从产品角度看,为实现 PRD 的价值和目标,最关键的屏幕或视图是什么?这旨在提供概念性的高层概览,以驱动粗略的史诗或用户故事。
5798
+ instruction: 从产品角度看,为实现 PRD 的价值和目标,最关键的屏幕或视图是什么?这旨在提供概念性的高层概览,以驱动粗略的模块或用户故事。
5799
5799
  examples:
5800
5800
  - "登录屏幕"
5801
5801
  - "主仪表盘"
@@ -5845,38 +5845,38 @@ sections:
5845
5845
  instruction: 在起草本文档的整个过程中,如果提出或发现任何其他适合架构师的技术假设,请在此处作为额外的项目符号添加。
5846
5846
 
5847
5847
  - id: epic-list
5848
- title: 史诗列表
5848
+ title: 模块列表
5849
5849
  instruction: |
5850
- 向用户呈现一份高层次的史诗列表以供批准。每个史诗应有一个标题和一个简短的(1句话)目标陈述。这使用户能在深入细节之前审阅整体结构。
5850
+ 向用户呈现一份高层次的模块列表以供批准。每个模块应有一个标题和一个简短的(1句话)目标陈述。这使用户能在深入细节之前审阅整体结构。
5851
5851
 
5852
- 关键:史诗必须遵循敏捷最佳实践,保持逻辑上的顺序:
5852
+ 关键:模块必须遵循敏捷最佳实践,保持逻辑上的顺序:
5853
5853
 
5854
- - 每个史诗都应交付一个重要的、端到端的、完全可部署且可测试的功能增量。
5855
- - 史诗 1 必须建立基础项目设施(应用设置、Git、CI/CD、核心服务),除非我们是向现有应用添加新功能。同时,它还应交付一个初始功能,即使只是一个健康检查路由或一个简单的金丝雀页面显示——在为第一个史诗编写用户故事时要记住这一点!
5856
- - 每个后续的史诗都在之前史诗功能的基础上构建,交付主要的功能模块,这些模块在部署时能为用户或业务提供切实的价值。
5857
- - 并非每个项目都需要多个史诗,一个史诗需要交付价值。例如,一个已完成的 API 即使 UI 尚未完成并计划在另一个史诗中实现,也可以交付价值。
5858
- - 倾向于设置较少的史诗,但要告知用户你的理由,并提供拆分选项,如果某些史诗看起来太大或关注点分散的话。
5859
- - 横切关注点应该贯穿于史诗和用户故事中,而不是作为最后的用户故事。例如,在一个史诗的最后一个故事中添加日志框架,或者在项目结束时作为最后一个史诗或故事来做,这将非常糟糕,因为我们从一开始就没有日志记录。
5854
+ - 每个模块都应交付一个重要的、端到端的、完全可部署且可测试的功能增量。
5855
+ - 模块 1 必须建立基础项目设施(应用设置、Git、CI/CD、核心服务),除非我们是向现有应用添加新功能。同时,它还应交付一个初始功能,即使只是一个健康检查路由或一个简单的金丝雀页面显示——在为第一个模块编写用户故事时要记住这一点!
5856
+ - 每个后续的模块都在之前模块功能的基础上构建,交付主要的功能模块,这些模块在部署时能为用户或业务提供切实的价值。
5857
+ - 并非每个项目都需要多个模块,一个模块需要交付价值。例如,一个已完成的 API 即使 UI 尚未完成并计划在另一个模块中实现,也可以交付价值。
5858
+ - 倾向于设置较少的模块,但要告知用户你的理由,并提供拆分选项,如果某些模块看起来太大或关注点分散的话。
5859
+ - 横切关注点应该贯穿于模块和用户故事中,而不是作为最后的用户故事。例如,在一个模块的最后一个故事中添加日志框架,或者在项目结束时作为最后一个模块或故事来做,这将非常糟糕,因为我们从一开始就没有日志记录。
5860
5860
  elicit: true
5861
5861
  examples:
5862
- - "史诗 1:基础与核心设施:建立项目设置、认证和基本用户管理"
5863
- - "史诗 2:核心业务实体:创建和管理主要领域对象的 CRUD 操作"
5864
- - "史诗 3:用户工作流与交互:实现关键用户旅程和业务流程"
5865
- - "史诗 4:报告与分析:为用户提供洞察和数据可视化"
5862
+ - "模块 1:基础与核心设施:建立项目设置、认证和基本用户管理"
5863
+ - "模块 2:核心业务实体:创建和管理主要领域对象的 CRUD 操作"
5864
+ - "模块 3:用户工作流与交互:实现关键用户旅程和业务流程"
5865
+ - "模块 4:报告与分析:为用户提供洞察和数据可视化"
5866
5866
 
5867
5867
  - id: epic-details
5868
- title: 史诗 {{epic_number}} {{epic_title}}
5868
+ title: 模块 {{epic_number}} {{epic_title}}
5869
5869
  repeatable: true
5870
5870
  instruction: |
5871
- 在史诗列表被批准后,将每个史诗及其所有的用户故事和验收标准作为一个完整的审查单元呈现。
5871
+ 在模块列表被批准后,将每个模块及其所有的用户故事和验收标准作为一个完整的审查单元呈现。
5872
5872
 
5873
- 为每个史诗提供扩展的目标(2-3 句话描述所有故事将实现的目标和价值)。
5873
+ 为每个模块提供扩展的目标(2-3 句话描述所有故事将实现的目标和价值)。
5874
5874
 
5875
5875
  关键的用户故事排序要求:
5876
5876
 
5877
- - 每个史诗中的用户故事必须在逻辑上是顺序的。
5877
+ - 每个模块中的用户故事必须在逻辑上是顺序的。
5878
5878
  - 每个故事都应该是一个“垂直切片”,交付完整的功能,除了项目基础的早期使能型故事。
5879
- - 任何故事都不应依赖于后续故事或史诗的工作。
5879
+ - 任何故事都不应依赖于后续故事或模块的工作。
5880
5880
  - 识别并注明任何直接的前置故事。
5881
5881
  - 关注“做什么”和“为什么”,而不是“怎么做”(将技术实现留给架构师),但要足够精确以支持故事之间逻辑上顺序的操作。
5882
5882
  - 确保每个故事都交付明确的用户或业务价值,尽量避免使能型故事,而是将它们构建到交付价值的故事中。