@zeyue0329/xiaoma-cli 1.0.41 → 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 (33) hide show
  1. package/.idea/workspace.xml +23 -2
  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 +170 -20
  9. package/dist/agents/xiaoma-master.txt +20 -20
  10. package/dist/teams/team-all.txt +193 -43
  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 +6 -1
  19. package/tools/api-server.js +367 -0
  20. package/xiaoma-core/agents/pm.md +1 -1
  21. package/xiaoma-core/agents/po.md +1 -1
  22. package/xiaoma-core/agents/requirements-coverage-auditor.yaml +1 -1
  23. package/xiaoma-core/agents/sm.md +1 -1
  24. package/xiaoma-core/agents/workflow-executor.md +174 -20
  25. package/xiaoma-core/tasks/batch-story-generation.md +1 -1
  26. package/xiaoma-core/tasks/requirements-coverage-audit.md +5 -5
  27. package/xiaoma-core/templates/fullstack-architecture-tmpl.yaml +1 -1
  28. package/xiaoma-core/templates/prd-tmpl.yaml +19 -19
  29. package/xiaoma-core/templates/requirements-coverage-audit.yaml +6 -6
  30. package/xiaoma-core/workflows/automated-requirements-analysis.yaml +90 -90
  31. package/xiaoma-core/workflows/automated-requirements-development.yaml +739 -0
  32. package/xiaoma-core/workflows/enhanced-fullstack-with-qa-loop.yaml +1 -1
  33. package/xiaoma-core/workflows/full-requirement-automation.yaml +1 -1
@@ -74,13 +74,18 @@ persona:
74
74
  - 自动切换智能体:根据工作流定义,自动使用 /analyst、/architect、/pm、/po、/sm、/dev、/qa 等命令切换到相应的智能体角色
75
75
  - 连续执行模式:完成一个步骤后,立即显示简短进度(1-2行)并**无需任何确认**直接进入下一个步骤,直到整个工作流完成或遇到真正的技术错误
76
76
  - "🚫 严禁中断询问:不要问'是否继续'、'请选择'、'您希望'等问题。用户启动工作流就是明确要求自动执行到底。唯一允许暂停的情况:文件不存在、执行报错、质量门控失败。"
77
- - "✅ 正确的进度报告格式:简短报告 + 立即继续,例如:'✅ 步骤 3/6 完成: PM 创建 PRD → 立即开始步骤 4/6: PM 拆分史诗...'"
77
+ - "✅ 正确的进度报告格式:简短报告 + 立即继续,例如:'✅ 步骤 3/6 完成: PM 创建 PRD → 立即开始步骤 4/6: PM 拆分模块...'"
78
78
 
79
79
  # 所有命令在使用时都需要 * 前缀 (例如, *help, *run-requirements-analysis)
80
80
  commands:
81
81
  - help: 显示以下命令的编号列表以供选择
82
82
  - run-requirements-analysis: 🔥 自动化需求分析工作流(完全自动执行,不暂停)- 加载 automated-requirements-analysis.yaml 并连续执行所有 6 个步骤,从 req.txt 到最终的架构设计文档,全程自动化无需人工干预
83
83
  - run-story-development: 🔥 自动化用户故事开发工作流(完全自动执行,不暂停)- 加载 automated-story-development.yaml 并循环执行所有用户故事的 SM→PO→Dev→QA 完整开发周期,全程自动化无需人工干预
84
+ - run-requirements-development: >-
85
+ 🔥🔥🔥 端到端全自动化工作流(完全自动执行,不暂停)-
86
+ 加载 automated-requirements-development.yaml 并连续执行从需求分析到用户故事开发完成的完整流程
87
+ (阶段1: 需求分析 6步 + 阶段2: 用户故事开发循环),
88
+ 实现从 req.txt 到所有代码完成的端到端自动化
84
89
  - status: 显示当前工作流执行状态和进度
85
90
  - validate-prerequisites: 验证工作流执行的前置条件
86
91
  - resume-workflow: 从上次中断的位置恢复工作流执行(同样会自动连续执行剩余步骤)
@@ -91,6 +96,7 @@ dependencies:
91
96
  workflows:
92
97
  - automated-requirements-analysis.yaml
93
98
  - automated-story-development.yaml
99
+ - automated-requirements-development.yaml
94
100
  ```
95
101
 
96
102
  ---
@@ -155,7 +161,7 @@ workflow_stages:
155
161
  tasks:
156
162
  - 创建 Brownfield 项目迭代需求的 PRD 文档
157
163
  - 定义功能模块、数据变更、API 规范
158
- - 制定验收标准和史诗拆分建议
164
+ - 制定验收标准和模块拆分建议
159
165
  - 自检 PRD 质量(16项检查)
160
166
  outputs:
161
167
  - docs/prd/brownfield-iteration-prd.md
@@ -163,15 +169,15 @@ workflow_stages:
163
169
  stage_4_pm_epics:
164
170
  agent: pm
165
171
  command: "*create-epic"
166
- duration: "变动,取决于史诗数量"
172
+ duration: "变动,取决于模块数量"
167
173
  tasks:
168
- - 从 PRD 提取史诗清单
169
- - 循环创建每个史诗文档
174
+ - 从 PRD 提取模块清单
175
+ - 循环创建每个模块文档
170
176
  - 初步识别用户故事
171
177
  - 定义技术设计概要和数据库/API 变更
172
- - 验证史诗质量
178
+ - 验证模块质量
173
179
  outputs:
174
- - docs/epics/史诗-*.md (多个史诗文件)
180
+ - docs/epics/Epic-*.md (多个模块文件)
175
181
 
176
182
  stage_5_architect_design:
177
183
  agent: architect
@@ -180,7 +186,7 @@ workflow_stages:
180
186
  duration: "30-40分钟"
181
187
  inputs:
182
188
  - docs/prd/brownfield-iteration-prd.md
183
- - docs/epics/史诗-*.md
189
+ - docs/epics/Epic-*.md
184
190
  - docs/architecture/current-architecture-analysis.md
185
191
  tasks:
186
192
  - 设计新增数据模型(Entity + DDL)
@@ -204,7 +210,77 @@ workflow_stages:
204
210
 
205
211
  ---
206
212
 
207
- ### 2. 自动化用户故事开发工作流
213
+ ### 2. 🔥🔥🔥 端到端全自动化工作流 (新增)
214
+
215
+ **命令**: `*run-requirements-development`
216
+
217
+ **功能**: 执行从需求分析到用户故事开发完成的完整端到端自动化流程
218
+
219
+ **工作流文件**: `xiaoma-core/workflows/automated-requirements-development.yaml`
220
+
221
+ **核心价值**:
222
+ - ✅ **一键启动**: 只需执行一个命令,完成从 req.txt 到所有代码的端到端开发
223
+ - ✅ **无缝衔接**: 需求分析阶段自动衔接用户故事开发阶段,无需人工干预
224
+ - ✅ **全程自动化**: 整合了两个子工作流的所有优势,实现完整的自动化流程
225
+ - ✅ **质量保证**: 两个阶段的所有质量门控都会自动执行
226
+
227
+ **执行流程**:
228
+
229
+ ```yaml
230
+ 端到端工作流结构:
231
+
232
+ 阶段 1: 需求分析阶段 (1.5-2.5小时)
233
+ ├─ 步骤 0/6: 前置环境验证
234
+ ├─ 步骤 1/6: Analyst 需求分析
235
+ ├─ 步骤 2/6: Architect 架构分析
236
+ ├─ 步骤 3/6: PM 创建 PRD
237
+ ├─ 步骤 4/6: PM 拆分模块
238
+ ├─ 步骤 5/6: Architect 架构设计
239
+ └─ 步骤 6/6: 生成需求分析报告
240
+
241
+ 阶段间验证(无缝衔接)
242
+
243
+ 阶段 2: 用户故事开发阶段 (40-70分钟/故事)
244
+ 循环执行(直到所有用户故事完成):
245
+ ├─ 步骤 1: SM 创建用户故事
246
+ ├─ 步骤 1.5: 快速构建验证
247
+ ├─ 步骤 2: PO 验证故事
248
+ ├─ 步骤 2.5: 预开发构建检查
249
+ ├─ 步骤 3: Dev 开发故事
250
+ ├─ 步骤 4: QA 测试验证
251
+ └─ 步骤 5: 质量门控决策
252
+
253
+ 生成端到端完成报告
254
+ ```
255
+
256
+ **总耗时**:
257
+ - 阶段 1(需求分析): 约 1.5-2.5 小时
258
+ - 阶段 2(用户故事开发): 约 40-70 分钟 × 用户故事数量
259
+ - **典型小型项目(5-10个故事)**: 4-8 小时
260
+ - **典型中型项目(10-20个故事)**: 8-16 小时
261
+
262
+ **成功标准**:
263
+
264
+ 阶段 1 成功标准:
265
+ - ✅ 所有需求分析文档生成完成
266
+ - ✅ PRD 和 Epic 文档创建完成
267
+ - ✅ 架构设计和数据库脚本生成完成
268
+ - ✅ 所有质量门控通过
269
+
270
+ 阶段 2 成功标准:
271
+ - ✅ 所有用户故事状态为 Done
272
+ - ✅ 所有测试通过(覆盖率 ≥80%)
273
+ - ✅ 所有 QA 质量门控通过
274
+ - ✅ 代码质量达标
275
+
276
+ 整体成功标准:
277
+ - ✅ 两个阶段全部完成
278
+ - ✅ 完整的文档和代码生成
279
+ - ✅ 准备就绪进入集成测试和部署阶段
280
+
281
+ ---
282
+
283
+ ### 3. 自动化用户故事开发工作流
208
284
 
209
285
  **命令**: `*run-story-development`
210
286
 
@@ -390,6 +466,84 @@ quality_gates:
390
466
 
391
467
  ## 📊 使用示例
392
468
 
469
+ ### 🔥🔥🔥 执行端到端全自动化工作流(推荐)
470
+
471
+ ```bash
472
+ # 1. 准备工作
473
+ # 确保 docs/req.txt 文件存在且包含 PM 提供的需求
474
+
475
+ # 2. 激活工作流执行器
476
+ /workflow-executor
477
+
478
+ # 3. 执行端到端全自动化工作流(完全自动化,一键到底)
479
+ *run-requirements-development
480
+
481
+ # ⚡ 核心优势:一个命令完成从需求分析到代码实现的全部工作!
482
+ # ⚠️ 重要提示:工作流执行器会自动连续执行两个阶段的所有步骤,不会在中间暂停
483
+ # 如果工作流在某个步骤停止,说明遇到了错误或质量门控失败,请查看错误信息
484
+
485
+ # 工作流执行器将自动完成以下所有工作(典型小项目 4-8 小时):
486
+ #
487
+ # 【阶段 1: 需求分析】(约 1.5-2.5 小时)
488
+ # ✓ 步骤 0/6: 前置环境验证
489
+ # ✓ 步骤 1/6: Analyst 需求分析 → 生成需求分析报告
490
+ # ✓ 步骤 2/6: Architect 架构分析 → 生成架构分析报告
491
+ # ✓ 步骤 3/6: PM 创建 PRD → 生成 Brownfield PRD
492
+ # ✓ 步骤 4/6: PM 拆分模块 → 生成 Epic 文档
493
+ # ✓ 步骤 5/6: Architect 架构设计 → 生成架构设计和数据库脚本
494
+ # ✓ 步骤 6/6: 生成需求分析完成报告
495
+ # ↓
496
+ # ✓ 阶段间无缝衔接验证
497
+ # ↓
498
+ # 【阶段 2: 用户故事开发】(约 40-70 分钟 × 故事数量)
499
+ # 对每个用户故事循环执行:
500
+ # ✓ SM 创建用户故事 → 快速构建验证
501
+ # ✓ PO 验证故事(10步验证)
502
+ # ✓ 预开发构建检查
503
+ # ✓ Dev 开发实现 + 自测
504
+ # ✓ QA 测试验证(真实数据测试)
505
+ # ✓ 质量门控决策 → Done
506
+ # 直到所有用户故事完成
507
+ # ↓
508
+ # ✓ 生成端到端完成报告
509
+
510
+ # 4. 工作流完成后检查所有输出
511
+ # 阶段 1 输出:
512
+ # - docs/requirements/requirements-analysis.md
513
+ # - docs/architecture/current-architecture-analysis.md
514
+ # - docs/prd/brownfield-iteration-prd.md
515
+ # - docs/epics/Epic-*.md
516
+ # - docs/architecture/iteration-backend-design.md
517
+ # - docs/architecture/db-migration-scripts.sql
518
+ # - docs/architecture/*.md (7个模块文档)
519
+ #
520
+ # 阶段 2 输出:
521
+ # - docs/stories/epic{X}-story{Y}.md (所有故事状态: Done)
522
+ # - src/ 目录下的实现代码
523
+ # - 测试报告
524
+ # - QA gate 文件
525
+ #
526
+ # 完成报告:
527
+ # - docs/end-to-end-completion-report.md
528
+ ```
529
+
530
+ **🌟 端到端工作流的特殊优势**:
531
+
532
+ - ✅ **一键到底**: 只需一个命令,无需在两个阶段间手动切换
533
+ - ✅ **无缝衔接**: 阶段1完成后自动验证并进入阶段2,完全自动化
534
+ - ✅ **全程监控**: 统一的进度追踪和质量控制
535
+ - ✅ **完整报告**: 生成包含两个阶段的综合完成报告
536
+ - ✅ **节省时间**: 避免手动操作和阶段间切换的开销
537
+ - ⚠️ **执行时长**: 适合有充足时间的场景(典型小项目 4-8 小时)
538
+
539
+ **🔥 适用场景**:
540
+ - 从零开始的新需求迭代
541
+ - 需要完整的需求分析和代码实现
542
+ - 有充足的执行时间(半天到一天)
543
+ - 希望最小化人工干预
544
+
545
+ ---
546
+
393
547
  ### 执行需求分析工作流
394
548
 
395
549
  ```bash
@@ -410,7 +564,7 @@ quality_gates:
410
564
  # ✓ 步骤 1/6: 切换到 Analyst 进行需求分析(15-25分钟)
411
565
  # ✓ 步骤 2/6: 切换到 Architect 分析现有架构(10-20分钟)
412
566
  # ✓ 步骤 3/6: 切换到 PM 创建 Brownfield PRD(20-30分钟)
413
- # ✓ 步骤 4/6: 切换到 PM 拆分史诗(取决于史诗数量)
567
+ # ✓ 步骤 4/6: 切换到 PM 拆分模块(取决于模块数量)
414
568
  # ✓ 步骤 5/6: 切换到 Architect 设计增量架构(30-40分钟)
415
569
  # ✓ 步骤 6/6: 生成完成报告
416
570
 
@@ -418,7 +572,7 @@ quality_gates:
418
572
  # - docs/requirements/requirements-analysis.md
419
573
  # - docs/architecture/current-architecture-analysis.md
420
574
  # - docs/prd/brownfield-iteration-prd.md
421
- # - docs/epics/史诗-*.md
575
+ # - docs/epics/Epic-*.md
422
576
  # - docs/architecture/iteration-backend-design.md
423
577
  # - docs/architecture/db-migration-scripts.sql
424
578
  ```
@@ -468,7 +622,7 @@ quality_gates:
468
622
 
469
623
  # 输出示例:
470
624
  # 当前工作流: automated-requirements-analysis
471
- # 当前阶段: stage_4_pm_epics (PM 拆分史诗)
625
+ # 当前阶段: stage_4_pm_epics (PM 拆分模块)
472
626
  # 进度: 60% (3/5 步骤完成)
473
627
  # 当前智能体: pm
474
628
  # 已完成步骤:
@@ -477,7 +631,7 @@ quality_gates:
477
631
  # ✓ stage_2_architect - 架构分析
478
632
  # ✓ stage_3_pm_prd - PRD 创建
479
633
  # 进行中步骤:
480
- # ⏳ stage_4_pm_epics - 史诗拆分 (2/4 史诗已创建)
634
+ # ⏳ stage_4_pm_epics - 模块拆分 (2/4 模块已创建)
481
635
  # 待执行步骤:
482
636
  # ⏸ stage_5_architect_design - 架构设计
483
637
  ```
@@ -579,7 +733,7 @@ escalation_protocol:
579
733
  *validate-prerequisites
580
734
 
581
735
  # 检查项目:
582
- # ✓ Epic 文档存在 (docs/epics/史诗-*.md)
736
+ # ✓ Epic 文档存在 (docs/epics/Epic-*.md)
583
737
  # ✓ 数据库设计文档存在 (docs/architecture/iteration-backend-design.md)
584
738
  # ✓ 架构分析文档存在 (docs/architecture/current-architecture-analysis.md)
585
739
  # ✓ 代码生成器配置完成 (如使用 MyBatis-Plus Generator)
@@ -607,7 +761,7 @@ escalation_protocol:
607
761
  # 示例输出:
608
762
  # 检测到未完成的工作流: automated-requirements-analysis
609
763
  # 最后完成的步骤: stage_3_pm_prd (PRD 创建)
610
- # 准备从步骤 stage_4_pm_epics (史诗拆分) 恢复执行
764
+ # 准备从步骤 stage_4_pm_epics (模块拆分) 恢复执行
611
765
  #
612
766
  # 验证前序输出:
613
767
  # ✓ docs/requirements/requirements-analysis.md
@@ -787,7 +941,7 @@ completion_report:
787
941
  # ✅ 步骤 1/6: Analyst 需求分析 → 立即开始步骤 2/6...
788
942
  # ✅ 步骤 2/6: Architect 架构分析 → 立即开始步骤 3/6...
789
943
  # ✅ 步骤 3/6: PM 创建 PRD → 立即开始步骤 4/6...
790
- # ✅ 步骤 4/6: PM 拆分史诗 → 立即开始步骤 5/6...
944
+ # ✅ 步骤 4/6: PM 拆分模块 → 立即开始步骤 5/6...
791
945
  # ✅ 步骤 5/6: Architect 架构设计 → 立即开始步骤 6/6...
792
946
  # ✅ 步骤 6/6: 生成完成报告 → 🎉 工作流完成!
793
947
 
@@ -823,9 +977,9 @@ completion_report:
823
977
  [20-30分钟后]
824
978
  ✅ 步骤 3/6 完成: 已生成 docs/prd/brownfield-iteration-prd.md
825
979
 
826
- 正在执行步骤 4/6: PM 拆分史诗...
827
- [根据史诗数量]
828
- ✅ 步骤 4/6 完成: 已生成 4 个史诗文档
980
+ 正在执行步骤 4/6: PM 拆分模块...
981
+ [根据模块数量]
982
+ ✅ 步骤 4/6 完成: 已生成 4 个模块文档
829
983
 
830
984
  正在执行步骤 5/6: Architect 设计增量架构...
831
985
  [30-40分钟后]
@@ -841,7 +995,7 @@ completion_report:
841
995
  - docs/requirements/requirements-analysis.md
842
996
  - docs/architecture/current-architecture-analysis.md
843
997
  - docs/prd/brownfield-iteration-prd.md
844
- - docs/epics/史诗-*.md (4个)
998
+ - docs/epics/Epic-*.md (4个)
845
999
  - docs/architecture/iteration-backend-design.md
846
1000
  - docs/architecture/db-migration-scripts.sql
847
1001
 
@@ -58,7 +58,7 @@ story_identification:
58
58
 
59
59
  story_sizing_guidelines:
60
60
  - small_story_preference: 优先小故事(1-3天)
61
- - epic_breakdown: 大史诗分解策略
61
+ - epic_breakdown: 大模块分解策略
62
62
  - dependency_minimization: 依赖最小化
63
63
  ```
64
64
 
@@ -11,7 +11,7 @@
11
11
  ### 📋 需求转化检查
12
12
 
13
13
  - PRD文档需求是否完全转化为用户故事
14
- - 史诗级需求的用户故事覆盖度分析
14
+ - 模块级需求的用户故事覆盖度分析
15
15
  - 需求优先级和实施状态匹配度验证
16
16
 
17
17
  ### ✅ 用户故事完整性检查
@@ -36,10 +36,10 @@
36
36
  *requirements-coverage-audit
37
37
  ```
38
38
 
39
- ### 专注特定史诗的审计
39
+ ### 专注特定模块的审计
40
40
 
41
41
  ```bash
42
- *coverage-audit --epic=史诗-1基础设施与核心文档展示
42
+ *coverage-audit --epic=模块-1基础设施与核心文档展示
43
43
  ```
44
44
 
45
45
  ### 验证用户故事状态准确性
@@ -54,12 +54,12 @@
54
54
 
55
55
  1. **加载PRD文档**
56
56
  - 读取主PRD文档
57
- - 扫描docs/prd/目录下的史诗文件
57
+ - 扫描docs/prd/目录下的模块文件
58
58
  - 提取所有需求和用户故事定义
59
59
  - 构建需求层次结构
60
60
 
61
61
  2. **提取需求矩阵**
62
- - 识别所有史诗和用户故事
62
+ - 识别所有模块和用户故事
63
63
  - 提取验收标准和功能点
64
64
  - 分析需求优先级
65
65
  - 构建需求依赖关系
@@ -340,7 +340,7 @@ sections:
340
340
  1. 如果是 REST API, 创建一个 OpenAPI 3.0 规范
341
341
  2. 如果是 GraphQL, 提供 GraphQL 模式
342
342
  3. 如果是 tRPC, 展示路由定义
343
- 4. 包括来自史诗/故事的所有端点
343
+ 4. 包括来自模块/故事的所有端点
344
344
  5. 基于数据模型定义请求/响应模式
345
345
  6. 记录认证要求
346
346
  7. 包括请求/响应示例
@@ -73,7 +73,7 @@ sections:
73
73
  title: 关键交互范式
74
74
  - id: core-screens
75
75
  title: 核心屏幕与视图
76
- instruction: 从产品角度看,为实现 PRD 的价值和目标,最关键的屏幕或视图是什么?这旨在提供概念性的高层概览,以驱动粗略的史诗或用户故事。
76
+ instruction: 从产品角度看,为实现 PRD 的价值和目标,最关键的屏幕或视图是什么?这旨在提供概念性的高层概览,以驱动粗略的模块或用户故事。
77
77
  examples:
78
78
  - "登录屏幕"
79
79
  - "主仪表盘"
@@ -123,38 +123,38 @@ sections:
123
123
  instruction: 在起草本文档的整个过程中,如果提出或发现任何其他适合架构师的技术假设,请在此处作为额外的项目符号添加。
124
124
 
125
125
  - id: epic-list
126
- title: 史诗列表
126
+ title: 模块列表
127
127
  instruction: |
128
- 向用户呈现一份高层次的史诗列表以供批准。每个史诗应有一个标题和一个简短的(1句话)目标陈述。这使用户能在深入细节之前审阅整体结构。
128
+ 向用户呈现一份高层次的模块列表以供批准。每个模块应有一个标题和一个简短的(1句话)目标陈述。这使用户能在深入细节之前审阅整体结构。
129
129
 
130
- 关键:史诗必须遵循敏捷最佳实践,保持逻辑上的顺序:
130
+ 关键:模块必须遵循敏捷最佳实践,保持逻辑上的顺序:
131
131
 
132
- - 每个史诗都应交付一个重要的、端到端的、完全可部署且可测试的功能增量。
133
- - 史诗 1 必须建立基础项目设施(应用设置、Git、CI/CD、核心服务),除非我们是向现有应用添加新功能。同时,它还应交付一个初始功能,即使只是一个健康检查路由或一个简单的金丝雀页面显示——在为第一个史诗编写用户故事时要记住这一点!
134
- - 每个后续的史诗都在之前史诗功能的基础上构建,交付主要的功能模块,这些模块在部署时能为用户或业务提供切实的价值。
135
- - 并非每个项目都需要多个史诗,一个史诗需要交付价值。例如,一个已完成的 API 即使 UI 尚未完成并计划在另一个史诗中实现,也可以交付价值。
136
- - 倾向于设置较少的史诗,但要告知用户你的理由,并提供拆分选项,如果某些史诗看起来太大或关注点分散的话。
137
- - 横切关注点应该贯穿于史诗和用户故事中,而不是作为最后的用户故事。例如,在一个史诗的最后一个故事中添加日志框架,或者在项目结束时作为最后一个史诗或故事来做,这将非常糟糕,因为我们从一开始就没有日志记录。
132
+ - 每个模块都应交付一个重要的、端到端的、完全可部署且可测试的功能增量。
133
+ - 模块 1 必须建立基础项目设施(应用设置、Git、CI/CD、核心服务),除非我们是向现有应用添加新功能。同时,它还应交付一个初始功能,即使只是一个健康检查路由或一个简单的金丝雀页面显示——在为第一个模块编写用户故事时要记住这一点!
134
+ - 每个后续的模块都在之前模块功能的基础上构建,交付主要的功能模块,这些模块在部署时能为用户或业务提供切实的价值。
135
+ - 并非每个项目都需要多个模块,一个模块需要交付价值。例如,一个已完成的 API 即使 UI 尚未完成并计划在另一个模块中实现,也可以交付价值。
136
+ - 倾向于设置较少的模块,但要告知用户你的理由,并提供拆分选项,如果某些模块看起来太大或关注点分散的话。
137
+ - 横切关注点应该贯穿于模块和用户故事中,而不是作为最后的用户故事。例如,在一个模块的最后一个故事中添加日志框架,或者在项目结束时作为最后一个模块或故事来做,这将非常糟糕,因为我们从一开始就没有日志记录。
138
138
  elicit: true
139
139
  examples:
140
- - "史诗 1:基础与核心设施:建立项目设置、认证和基本用户管理"
141
- - "史诗 2:核心业务实体:创建和管理主要领域对象的 CRUD 操作"
142
- - "史诗 3:用户工作流与交互:实现关键用户旅程和业务流程"
143
- - "史诗 4:报告与分析:为用户提供洞察和数据可视化"
140
+ - "模块 1:基础与核心设施:建立项目设置、认证和基本用户管理"
141
+ - "模块 2:核心业务实体:创建和管理主要领域对象的 CRUD 操作"
142
+ - "模块 3:用户工作流与交互:实现关键用户旅程和业务流程"
143
+ - "模块 4:报告与分析:为用户提供洞察和数据可视化"
144
144
 
145
145
  - id: epic-details
146
- title: 史诗 {{epic_number}} {{epic_title}}
146
+ title: 模块 {{epic_number}} {{epic_title}}
147
147
  repeatable: true
148
148
  instruction: |
149
- 在史诗列表被批准后,将每个史诗及其所有的用户故事和验收标准作为一个完整的审查单元呈现。
149
+ 在模块列表被批准后,将每个模块及其所有的用户故事和验收标准作为一个完整的审查单元呈现。
150
150
 
151
- 为每个史诗提供扩展的目标(2-3 句话描述所有故事将实现的目标和价值)。
151
+ 为每个模块提供扩展的目标(2-3 句话描述所有故事将实现的目标和价值)。
152
152
 
153
153
  关键的用户故事排序要求:
154
154
 
155
- - 每个史诗中的用户故事必须在逻辑上是顺序的。
155
+ - 每个模块中的用户故事必须在逻辑上是顺序的。
156
156
  - 每个故事都应该是一个“垂直切片”,交付完整的功能,除了项目基础的早期使能型故事。
157
- - 任何故事都不应依赖于后续故事或史诗的工作。
157
+ - 任何故事都不应依赖于后续故事或模块的工作。
158
158
  - 识别并注明任何直接的前置故事。
159
159
  - 关注“做什么”和“为什么”,而不是“怎么做”(将技术实现留给架构师),但要足够精确以支持故事之间逻辑上顺序的操作。
160
160
  - 确保每个故事都交付明确的用户或业务价值,尽量避免使能型故事,而是将它们构建到交付价值的故事中。
@@ -25,7 +25,7 @@ description: |
25
25
 
26
26
  📋 **需求转化检查**:
27
27
  - PRD文档需求是否完全转化为用户故事
28
- - 史诗级需求的用户故事覆盖度
28
+ - 模块级需求的用户故事覆盖度
29
29
  - 需求优先级和实施状态匹配度
30
30
 
31
31
  ✅ **用户故事完整性检查**:
@@ -51,7 +51,7 @@ execution:
51
51
  description: "加载PRD文档"
52
52
  actions:
53
53
  - "读取主PRD文档"
54
- - "扫描docs/prd/目录下的史诗文件"
54
+ - "扫描docs/prd/目录下的模块文件"
55
55
  - "提取所有需求和用户故事定义"
56
56
  - "构建需求层次结构"
57
57
  output: "requirements_inventory.json"
@@ -59,7 +59,7 @@ execution:
59
59
  - step: "extract_requirements_matrix"
60
60
  description: "提取需求矩阵"
61
61
  actions:
62
- - "识别所有史诗和用户故事"
62
+ - "识别所有模块和用户故事"
63
63
  - "提取验收标准和功能点"
64
64
  - "分析需求优先级"
65
65
  - "构建需求依赖关系"
@@ -204,7 +204,7 @@ report_structure:
204
204
  sections:
205
205
  - requirements_coverage_matrix:
206
206
  title: "需求覆盖度矩阵"
207
- content: "史诗-用户故事映射表"
207
+ content: "模块-用户故事映射表"
208
208
  - story_completeness_analysis:
209
209
  title: "用户故事完整性分析"
210
210
  content: "每个故事的完整性评分"
@@ -322,8 +322,8 @@ usage_examples:
322
322
  *requirements-coverage-audit
323
323
 
324
324
  focused_audit: |
325
- # 专注于特定史诗的审计
326
- *coverage-audit --epic=史诗-1基础设施与核心文档展示
325
+ # 专注于特定模块的审计
326
+ *coverage-audit --epic=模块-1基础设施与核心文档展示
327
327
 
328
328
  status_verification: |
329
329
  # 验证用户故事状态准确性