@zeyue0329/xiaoma-cli 1.0.37 → 1.0.39

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 (89) hide show
  1. package/.idea/workspace.xml +27 -26
  2. package/JAVA-BACKEND-COMMANDS-REFERENCE.md +62 -52
  3. package/JAVA-BACKEND-ITERATION-GUIDE.md +125 -18
  4. package/README.md +1 -1
  5. package/common/utils/bmad-doc-template.md +5 -5
  6. package/dist/agents/analyst.txt +35 -5
  7. package/dist/agents/architect.txt +217 -31
  8. package/dist/agents/automation-orchestrator.txt +4 -4
  9. package/dist/agents/dev.txt +3 -3
  10. package/dist/agents/full-requirement-orchestrator.txt +11 -11
  11. package/dist/agents/qa.txt +102 -102
  12. package/dist/agents/sm.txt +6 -6
  13. package/dist/agents/ux-expert.txt +6 -1
  14. package/dist/agents/workflow-executor.txt +879 -0
  15. package/dist/agents/xiaoma-master.txt +258 -37
  16. package/dist/teams/team-all.txt +1223 -445
  17. package/dist/teams/team-fullstack-with-database.txt +384 -446
  18. package/dist/teams/team-fullstack.txt +258 -37
  19. package/dist/teams/team-ide-minimal.txt +111 -111
  20. package/dist/teams/team-no-ui.txt +252 -36
  21. package/docs/architecture-sharding-modification.md +623 -0
  22. package/docs/automated-requirements-analysis-outputs.md +896 -0
  23. package/package.json +1 -1
  24. package/tools/builders/web-builder.js +292 -142
  25. package/tools/bump-all-versions.js +50 -32
  26. package/tools/cli.js +52 -47
  27. package/tools/flattener/aggregate.js +30 -12
  28. package/tools/flattener/binary.js +46 -43
  29. package/tools/flattener/discovery.js +23 -15
  30. package/tools/flattener/files.js +6 -6
  31. package/tools/flattener/ignoreRules.js +122 -121
  32. package/tools/flattener/main.js +249 -144
  33. package/tools/flattener/projectRoot.js +74 -69
  34. package/tools/flattener/prompts.js +12 -10
  35. package/tools/flattener/stats.helpers.js +90 -61
  36. package/tools/flattener/stats.js +1 -1
  37. package/tools/flattener/test-matrix.js +225 -170
  38. package/tools/flattener/xml.js +31 -23
  39. package/tools/installer/bin/xiaoma.js +199 -153
  40. package/tools/installer/lib/config-loader.js +76 -47
  41. package/tools/installer/lib/file-manager.js +101 -44
  42. package/tools/installer/lib/ide-base-setup.js +49 -39
  43. package/tools/installer/lib/ide-setup.js +694 -380
  44. package/tools/installer/lib/installer.js +802 -469
  45. package/tools/installer/lib/memory-profiler.js +22 -12
  46. package/tools/installer/lib/module-manager.js +16 -14
  47. package/tools/installer/lib/resource-locator.js +61 -35
  48. package/tools/lib/dependency-resolver.js +34 -23
  49. package/tools/lib/yaml-utils.js +7 -2
  50. package/tools/preview-release-notes.js +33 -25
  51. package/tools/shared/bannerArt.js +3 -3
  52. package/tools/sync-installer-version.js +16 -7
  53. package/tools/upgraders/v3-to-v4-upgrader.js +244 -163
  54. package/tools/version-bump.js +24 -18
  55. package/tools/xiaoma-npx-wrapper.js +15 -10
  56. package/tools/yaml-format.js +60 -36
  57. package/xiaoma-core/agent-teams/team-fullstack-with-database.yaml +0 -1
  58. package/xiaoma-core/agents/automated-fix-validator.yaml +2 -1
  59. package/xiaoma-core/agents/automated-quality-validator.yaml +10 -5
  60. package/xiaoma-core/agents/automation-orchestrator.md +4 -4
  61. package/xiaoma-core/agents/dev.md +4 -4
  62. package/xiaoma-core/agents/enhanced-workflow-orchestrator.yaml +2 -1
  63. package/xiaoma-core/agents/full-requirement-orchestrator.md +11 -11
  64. package/xiaoma-core/agents/global-requirements-auditor.yaml +11 -3
  65. package/xiaoma-core/agents/intelligent-template-adapter.yaml +19 -5
  66. package/xiaoma-core/agents/master-execution-engine.yaml +19 -5
  67. package/xiaoma-core/agents/workflow-executor.md +8 -4
  68. package/xiaoma-core/agents/xiaoma-master.md +1 -1
  69. package/xiaoma-core/data/test-levels-framework.md +12 -12
  70. package/xiaoma-core/tasks/analyze-existing-database.md +1 -1
  71. package/xiaoma-core/tasks/apply-qa-fixes.md +3 -3
  72. package/xiaoma-core/tasks/batch-story-generation.md +22 -22
  73. package/xiaoma-core/tasks/create-enhanced-story-with-database.md +6 -6
  74. package/xiaoma-core/tasks/nfr-assess.md +6 -6
  75. package/xiaoma-core/tasks/project-integration-testing.md +42 -42
  76. package/xiaoma-core/tasks/qa-gate.md +23 -23
  77. package/xiaoma-core/tasks/review-story.md +18 -18
  78. package/xiaoma-core/tasks/risk-profile.md +25 -25
  79. package/xiaoma-core/tasks/serial-development-orchestration.md +51 -51
  80. package/xiaoma-core/tasks/test-design.md +9 -9
  81. package/xiaoma-core/tasks/trace-requirements.md +21 -21
  82. package/xiaoma-core/templates/competitor-analysis-tmpl.yaml +35 -5
  83. package/xiaoma-core/templates/front-end-architecture-tmpl.yaml +77 -11
  84. package/xiaoma-core/templates/front-end-spec-tmpl.yaml +6 -1
  85. package/xiaoma-core/templates/fullstack-architecture-tmpl.yaml +140 -20
  86. package/xiaoma-core/templates/global-qa-monitoring-tmpl.yaml +2 -1
  87. package/xiaoma-core/templates/requirements-coverage-audit.yaml +2 -1
  88. package/xiaoma-core/workflows/automated-requirements-analysis.yaml +283 -6
  89. package/dist/agents/database-architect.txt +0 -322
@@ -158,7 +158,8 @@ multi_dimensional_quality_validation:
158
158
 
159
159
  - field_format_validation:
160
160
  user_story_format: "^\\*\\*作为\\*\\*.*\\*\\*我希望\\*\\*.*\\*\\*以便\\*\\*.*"
161
- status_values: ["Draft", "Approved", "InProgress", "Review", "Done", "Completed"]
161
+ status_values:
162
+ ["Draft", "Approved", "InProgress", "Review", "Done", "Completed"]
162
163
  table_format: "MARKDOWN_TABLE"
163
164
  validation_method: "REGEX_AND_FORMAT_CHECK"
164
165
 
@@ -192,7 +193,8 @@ multi_dimensional_quality_validation:
192
193
  scoring:
193
194
  weight: 25
194
195
  pass_threshold: 90
195
- improvement_strategies: ["content_enhancement", "clarity_improvement", "accuracy_correction"]
196
+ improvement_strategies:
197
+ ["content_enhancement", "clarity_improvement", "accuracy_correction"]
196
198
 
197
199
  # 维度3:跨文档一致性
198
200
  cross_document_consistency_validation:
@@ -220,7 +222,11 @@ multi_dimensional_quality_validation:
220
222
  weight: 20
221
223
  pass_threshold: 95
222
224
  correction_strategies:
223
- ["terminology_standardization", "format_alignment", "reference_correction"]
225
+ [
226
+ "terminology_standardization",
227
+ "format_alignment",
228
+ "reference_correction",
229
+ ]
224
230
 
225
231
  # 维度4:实施可行性
226
232
  implementation_feasibility_validation:
@@ -248,7 +254,11 @@ multi_dimensional_quality_validation:
248
254
  weight: 15
249
255
  pass_threshold: 85
250
256
  improvement_actions:
251
- ["design_optimization", "feasibility_enhancement", "implementation_guidance"]
257
+ [
258
+ "design_optimization",
259
+ "feasibility_enhancement",
260
+ "implementation_guidance",
261
+ ]
252
262
 
253
263
  # 维度5:业务价值对齐
254
264
  business_value_alignment_validation:
@@ -270,7 +280,11 @@ multi_dimensional_quality_validation:
270
280
  weight: 10
271
281
  pass_threshold: 80
272
282
  enhancement_strategies:
273
- ["value_clarification", "requirement_refinement", "stakeholder_alignment"]
283
+ [
284
+ "value_clarification",
285
+ "requirement_refinement",
286
+ "stakeholder_alignment",
287
+ ]
274
288
 
275
289
  # ========== 自动纠错和改进系统 ==========
276
290
  auto_correction_and_improvement_system:
@@ -304,7 +304,12 @@ quality_gate_system:
304
304
  type: "CRITICAL_GATE"
305
305
 
306
306
  - phase: "phase_2_intelligent_task_planning"
307
- gates: ["TASK_ANALYSIS_VALIDATION", "STRATEGY_FEASIBILITY_CHECK", "QA_READINESS_VALIDATION"]
307
+ gates:
308
+ [
309
+ "TASK_ANALYSIS_VALIDATION",
310
+ "STRATEGY_FEASIBILITY_CHECK",
311
+ "QA_READINESS_VALIDATION",
312
+ ]
308
313
  type: "CRITICAL_GATE"
309
314
 
310
315
  - phase: "phase_3_automated_content_generation"
@@ -330,14 +335,16 @@ quality_gate_system:
330
335
  type: "CRITICAL_GATE"
331
336
 
332
337
  - phase: "phase_5_delivery_preparation"
333
- gates: ["REPORTING_QUALITY_VALIDATION", "DELIVERY_READINESS_FINAL_VALIDATION"]
338
+ gates:
339
+ ["REPORTING_QUALITY_VALIDATION", "DELIVERY_READINESS_FINAL_VALIDATION"]
334
340
  type: "CRITICAL_GATE"
335
341
 
336
342
  # ========== 自动纠错和恢复系统 ==========
337
343
  automated_correction_and_recovery_system:
338
344
  correction_strategies:
339
345
  - strategy: "IMMEDIATE_AUTO_CORRECTION"
340
- triggers: ["syntax_errors", "format_violations", "missing_required_sections"]
346
+ triggers:
347
+ ["syntax_errors", "format_violations", "missing_required_sections"]
341
348
  actions:
342
349
  - apply_template_format_correction
343
350
  - perform_syntax_standardization
@@ -355,7 +362,8 @@ automated_correction_and_recovery_system:
355
362
  max_attempts: 3
356
363
 
357
364
  - strategy: "COMPREHENSIVE_REFINEMENT_CYCLE"
358
- triggers: ["integration_validation_failure", "business_value_misalignment"]
365
+ triggers:
366
+ ["integration_validation_failure", "business_value_misalignment"]
359
367
  actions:
360
368
  - perform_holistic_document_review
361
369
  - apply_comprehensive_improvement_strategies
@@ -400,7 +408,13 @@ monitoring_and_reporting_system:
400
408
 
401
409
  comprehensive_reporting:
402
410
  - report: "EXECUTIVE_SUMMARY_REPORT"
403
- content: ["overall_quality_score", "key_achievements", "critical_issues", "recommendations"]
411
+ content:
412
+ [
413
+ "overall_quality_score",
414
+ "key_achievements",
415
+ "critical_issues",
416
+ "recommendations",
417
+ ]
404
418
  audience: "STAKEHOLDERS_AND_MANAGEMENT"
405
419
 
406
420
  - report: "DETAILED_TECHNICAL_REPORT"
@@ -3,6 +3,7 @@
3
3
  > **🔥🔥🔥 核心使命:完全自动化、连续执行、绝不中断询问**
4
4
  >
5
5
  > 本智能体的核心价值是**自动化工作流执行**。当用户执行 `*run-requirements-analysis` 或 `*run-story-development` 时,你必须像自动化流水线一样连续执行所有步骤,**绝对禁止**在中间步骤暂停询问用户:
6
+ >
6
7
  > - 🚫 **禁止**:"是否继续执行下一步骤?"
7
8
  > - 🚫 **禁止**:"是否先查看已生成的文档?"
8
9
  > - 🚫 **禁止**:"请选择 A/B/C"
@@ -43,8 +44,8 @@ activation-instructions:
43
44
  - 保持角色!
44
45
  - 关键提示: 激活时,仅向用户打招呼,自动运行 `*help`,然后停止以等待用户请求协助或给出命令。唯一的例外是激活参数中也包含了命令。
45
46
  - ⚠️⚠️⚠️ 自动化执行模式(极其重要): 当用户执行 *run-requirements-analysis 或 *run-story-development 时,加载对应的工作流 YAML 文件,然后**必须自动连续执行工作流中定义的所有步骤(sequence),绝对不要在任何中间步骤停下来询问用户是否继续、是否查看文档、或提供选项让用户选择**。只有在遇到真正的错误(如文件不存在、执行失败)、质量门控失败、或明确需要人工决策时才暂停等待用户输入。
46
- - 进度报告: 在执行每个步骤时,简要报告当前进度(例如:"✅ 步骤 2/6 完成: Architect 现有架构分析"),然后**立即无需确认地**继续执行下一步骤。不要询问"是否继续"、不要提供"选项A/B/C"、不要问"您希望如何操作",直接执行即可。
47
- - 🚫 禁止行为: 绝对不要在步骤间暂停并问:"是否希望我继续?""是否先查看文档?""请选择A/B/C"。这些都是不必要的中断。工作流必须像流水一样连续执行。
47
+ - "进度报告: 在执行每个步骤时,简要报告当前进度(例如:'✅ 步骤 2/6 完成: Architect 现有架构分析'),然后**立即无需确认地**继续执行下一步骤。不要询问'是否继续'、不要提供'选项A/B/C'、不要问'您希望如何操作',直接执行即可。"
48
+ - "🚫 禁止行为: 绝对不要在步骤间暂停并问:'是否希望我继续?''是否先查看文档?''请选择A/B/C'。这些都是不必要的中断。工作流必须像流水一样连续执行。"
48
49
 
49
50
  agent:
50
51
  name: workflow-executor
@@ -72,8 +73,8 @@ persona:
72
73
  - 🔥🔥🔥 最高优先级原则:当执行 *run-requirements-analysis 或 *run-story-development 时,必须像自动化流水线一样连续执行所有步骤,绝对禁止在中间暂停询问用户。这是自动化工作流执行器的核心使命,违反此原则将完全失去自动化的意义。
73
74
  - 自动切换智能体:根据工作流定义,自动使用 /analyst、/architect、/pm、/po、/sm、/dev、/qa 等命令切换到相应的智能体角色
74
75
  - 连续执行模式:完成一个步骤后,立即显示简短进度(1-2行)并**无需任何确认**直接进入下一个步骤,直到整个工作流完成或遇到真正的技术错误
75
- - 🚫 严禁中断询问:不要问"是否继续""请选择""您希望"等问题。用户启动工作流就是明确要求自动执行到底。唯一允许暂停的情况:文件不存在、执行报错、质量门控失败。
76
- - ✅ 正确的进度报告格式:简短报告 + 立即继续,例如:"✅ 步骤 3/6 完成: PM 创建 PRD → 立即开始步骤 4/6: PM 拆分史诗..."
76
+ - "🚫 严禁中断询问:不要问'是否继续''请选择''您希望'等问题。用户启动工作流就是明确要求自动执行到底。唯一允许暂停的情况:文件不存在、执行报错、质量门控失败。"
77
+ - "✅ 正确的进度报告格式:简短报告 + 立即继续,例如:'✅ 步骤 3/6 完成: PM 创建 PRD → 立即开始步骤 4/6: PM 拆分史诗...'"
77
78
 
78
79
  # 所有命令在使用时都需要 * 前缀 (例如, *help, *run-requirements-analysis)
79
80
  commands:
@@ -196,6 +197,7 @@ workflow_stages:
196
197
  **总耗时**: 约 1.5-2.5 小时
197
198
 
198
199
  **成功标准**:
200
+
199
201
  - ✅ 所有文档生成完成
200
202
  - ✅ 所有质量门控通过
201
203
  - ✅ 准备就绪进入用户故事开发阶段
@@ -308,6 +310,7 @@ workflow_stages:
308
310
  **总耗时**: 每个用户故事约 40-70 分钟(取决于复杂度)
309
311
 
310
312
  **成功标准**:
313
+
311
314
  - ✅ 所有用户故事状态为 Done
312
315
  - ✅ 所有测试通过
313
316
  - ✅ 所有质量门控通过
@@ -421,6 +424,7 @@ quality_gates:
421
424
  ```
422
425
 
423
426
  **🔥 重要说明 - 完全自动化执行**:
427
+
424
428
  - ✅ 工作流会**像流水线一样自动连续执行所有步骤**,完全无需在每个步骤后手动确认
425
429
  - ✅ 每个步骤完成后会显示简要进度报告(1-2行),然后**立即自动**进入下一步骤
426
430
  - ✅ 你只需要执行 `*run-requirements-analysis` 一次,然后等待所有 6 个步骤自动完成(约 1.5-2.5 小时)
@@ -27,7 +27,7 @@ activation-instructions:
27
27
  - 关键规则: 当执行来自依赖项的正式任务工作流时,所有任务指令都会覆盖任何冲突的基础行为约束。带有 elicit=true 的交互式工作流需要用户交互,不能为了效率而绕过。
28
28
  - 在列出任务/模板或在对话中呈现选项时,始终以编号选项列表的形式显示,允许用户输入数字进行选择或执行
29
29
  - 保持角色!
30
- - '关键提示: 启动期间请勿扫描文件系统或加载任何资源,仅在收到命令时执行(例外:激活期间读取 xiaoma-core/core-config.yaml)'
30
+ - "关键提示: 启动期间请勿扫描文件系统或加载任何资源,仅在收到命令时执行(例外:激活期间读取 xiaoma-core/core-config.yaml)"
31
31
  - 关键提示: 不要自动运行发现任务
32
32
  - 关键提示: 除非用户输入 *kb,否则绝不加载 root/data/bmad-kb.md
33
33
  - 关键提示: 激活时,仅向用户打招呼,自动运行 *help,然后停止以等待用户请求协助或给出命令。唯一的例外是激活参数中也包含了命令。
@@ -27,10 +27,10 @@ Comprehensive guide for determining appropriate test levels (unit, integration,
27
27
 
28
28
  ```yaml
29
29
  unit_test:
30
- component: 'PriceCalculator'
31
- scenario: 'Calculate discount with multiple rules'
32
- justification: 'Complex business logic with multiple branches'
33
- mock_requirements: 'None - pure function'
30
+ component: "PriceCalculator"
31
+ scenario: "Calculate discount with multiple rules"
32
+ justification: "Complex business logic with multiple branches"
33
+ mock_requirements: "None - pure function"
34
34
  ```
35
35
 
36
36
  ### Integration Tests
@@ -54,10 +54,10 @@ unit_test:
54
54
 
55
55
  ```yaml
56
56
  integration_test:
57
- components: ['UserService', 'AuthRepository']
58
- scenario: 'Create user with role assignment'
59
- justification: 'Critical data flow between service and persistence'
60
- test_environment: 'In-memory database'
57
+ components: ["UserService", "AuthRepository"]
58
+ scenario: "Create user with role assignment"
59
+ justification: "Critical data flow between service and persistence"
60
+ test_environment: "In-memory database"
61
61
  ```
62
62
 
63
63
  ### End-to-End Tests
@@ -81,10 +81,10 @@ integration_test:
81
81
 
82
82
  ```yaml
83
83
  e2e_test:
84
- journey: 'Complete checkout process'
85
- scenario: 'User purchases with saved payment method'
86
- justification: 'Revenue-critical path requiring full validation'
87
- environment: 'Staging with test payment gateway'
84
+ journey: "Complete checkout process"
85
+ scenario: "User purchases with saved payment method"
86
+ justification: "Revenue-critical path requiring full validation"
87
+ environment: "Staging with test payment gateway"
88
88
  ```
89
89
 
90
90
  ## Test Level Selection Rules
@@ -11,7 +11,7 @@
11
11
  ```yaml
12
12
  action: check_existing_documentation
13
13
  path: docs/database/
14
- pattern: '{project_name}-database.md'
14
+ pattern: "{project_name}-database.md"
15
15
  ```
16
16
 
17
17
  ### 2. 连接数据库
@@ -15,13 +15,13 @@ Implement fixes based on QA results (gate and assessments) for a specific story.
15
15
 
16
16
  ```yaml
17
17
  required:
18
- - story_id: '{epic}.{story}' # e.g., "2.2"
18
+ - story_id: "{epic}.{story}" # e.g., "2.2"
19
19
  - qa_root: from `xiaoma-core/core-config.yaml` key `qa.qaLocation` (e.g., `docs/project/qa`)
20
20
  - story_root: from `xiaoma-core/core-config.yaml` key `devStoryLocation` (e.g., `docs/project/stories`)
21
21
 
22
22
  optional:
23
- - story_title: '{title}' # derive from story H1 if missing
24
- - story_slug: '{slug}' # derive from title (lowercase, hyphenated) if missing
23
+ - story_title: "{title}" # derive from story H1 if missing
24
+ - story_slug: "{slug}" # derive from title (lowercase, hyphenated) if missing
25
25
  ```
26
26
 
27
27
  ## QA Sources to Read
@@ -73,7 +73,7 @@ prioritization_algorithm:
73
73
  - implementation_risk: 实现风险评估
74
74
 
75
75
  priority_calculation:
76
- formula: 'business_value * user_impact / (dependency_weight + risk_factor)'
76
+ formula: "business_value * user_impact / (dependency_weight + risk_factor)"
77
77
 
78
78
  priority_levels:
79
79
  - p0_critical: 关键路径故事
@@ -181,12 +181,12 @@ enhanced_story_generation:
181
181
  dependency_graph:
182
182
  nodes:
183
183
  - id: US001
184
- title: '用户注册与登录'
184
+ title: "用户注册与登录"
185
185
  priority: P0
186
186
  estimated_effort: 3
187
187
 
188
188
  - id: US002
189
- title: '权限管理基础'
189
+ title: "权限管理基础"
190
190
  priority: P0
191
191
  estimated_effort: 5
192
192
 
@@ -194,26 +194,26 @@ dependency_graph:
194
194
  - from: US001
195
195
  to: US002
196
196
  type: technical_dependency
197
- description: '权限管理需要用户身份认证'
197
+ description: "权限管理需要用户身份认证"
198
198
 
199
199
  - from: US002
200
200
  to: US013
201
201
  type: business_flow_dependency
202
- description: '个人信息管理需要权限控制'
202
+ description: "个人信息管理需要权限控制"
203
203
 
204
204
  critical_paths:
205
205
  - path: [US001, US002, US013, US025]
206
206
  duration: 15
207
- description: '用户管理关键路径'
207
+ description: "用户管理关键路径"
208
208
 
209
209
  parallel_groups:
210
210
  - group_id: A
211
211
  stories: [US001, US002, US013]
212
- focus: '用户管理'
212
+ focus: "用户管理"
213
213
 
214
214
  - group_id: B
215
215
  stories: [US003, US014, US025]
216
- focus: '数据管理'
216
+ focus: "数据管理"
217
217
  ```
218
218
 
219
219
  ## Automation Integration
@@ -222,18 +222,18 @@ parallel_groups:
222
222
 
223
223
  ```yaml
224
224
  integration_points:
225
- trigger_command: '*generate-all-stories'
225
+ trigger_command: "*generate-all-stories"
226
226
 
227
227
  input_sources:
228
- - file: 'prd.md'
228
+ - file: "prd.md"
229
229
  validator: prd_completeness_check
230
- - file: 'database_design.md'
230
+ - file: "database_design.md"
231
231
  validator: schema_consistency_check
232
232
 
233
233
  output_handlers:
234
- - target: 'project_story_backlog.md'
234
+ - target: "project_story_backlog.md"
235
235
  post_processor: priority_validation
236
- - target: 'stories/'
236
+ - target: "stories/"
237
237
  post_processor: story_format_validation
238
238
  ```
239
239
 
@@ -296,19 +296,19 @@ dynamic_adjustment:
296
296
  ```yaml
297
297
  error_scenarios:
298
298
  incomplete_prd:
299
- detection: 'PRD缺少关键信息章节'
300
- handling: '生成缺失信息提示,暂停生成'
301
- recovery: '要求补充PRD信息后重新生成'
299
+ detection: "PRD缺少关键信息章节"
300
+ handling: "生成缺失信息提示,暂停生成"
301
+ recovery: "要求补充PRD信息后重新生成"
302
302
 
303
303
  conflicting_requirements:
304
- detection: '需求之间存在逻辑冲突'
305
- handling: '标记冲突点,生成冲突报告'
306
- recovery: '人工review和冲突解决'
304
+ detection: "需求之间存在逻辑冲突"
305
+ handling: "标记冲突点,生成冲突报告"
306
+ recovery: "人工review和冲突解决"
307
307
 
308
308
  circular_dependencies:
309
- detection: '故事间存在循环依赖'
310
- handling: '依赖环检测和报告'
311
- recovery: '自动依赖重构建议'
309
+ detection: "故事间存在循环依赖"
310
+ handling: "依赖环检测和报告"
311
+ recovery: "自动依赖重构建议"
312
312
  ```
313
313
 
314
314
  ### 质量保证措施
@@ -49,12 +49,12 @@
49
49
  #### 2.1 基础信息填写
50
50
 
51
51
  ```yaml
52
- epic_num: '{{epic_number}}'
53
- story_num: '{{story_number}}'
54
- story_title_short: '{{story_title}}'
55
- role: '{{user_role}}'
56
- action: '{{user_action}}'
57
- benefit: '{{user_benefit}}'
52
+ epic_num: "{{epic_number}}"
53
+ story_num: "{{story_number}}"
54
+ story_title_short: "{{story_title}}"
55
+ role: "{{user_role}}"
56
+ action: "{{user_action}}"
57
+ benefit: "{{user_benefit}}"
58
58
  ```
59
59
 
60
60
  #### 2.2 数据库设计部分填写
@@ -94,16 +94,16 @@ nfr_validation:
94
94
  _assessed: [security, performance, reliability, maintainability]
95
95
  security:
96
96
  status: CONCERNS
97
- notes: 'No rate limiting on auth endpoints'
97
+ notes: "No rate limiting on auth endpoints"
98
98
  performance:
99
99
  status: PASS
100
- notes: 'Response times < 200ms verified'
100
+ notes: "Response times < 200ms verified"
101
101
  reliability:
102
102
  status: PASS
103
- notes: 'Error handling and retries implemented'
103
+ notes: "Error handling and retries implemented"
104
104
  maintainability:
105
105
  status: CONCERNS
106
- notes: 'Test coverage at 65%, target is 80%'
106
+ notes: "Test coverage at 65%, target is 80%"
107
107
  ```
108
108
 
109
109
  ## Deterministic Status Rules
@@ -333,10 +333,10 @@ performance_deep_dive:
333
333
  p99: 350ms
334
334
  database:
335
335
  slow_queries: 2
336
- missing_indexes: ['users.email', 'orders.user_id']
336
+ missing_indexes: ["users.email", "orders.user_id"]
337
337
  caching:
338
338
  hit_rate: 0%
339
- recommendation: 'Add Redis for session data'
339
+ recommendation: "Add Redis for session data"
340
340
  load_test:
341
341
  max_rps: 150
342
342
  breaking_point: 200 rps
@@ -351,46 +351,46 @@ delivery_readiness:
351
351
  # integration_test_report.yaml
352
352
  test_report:
353
353
  executive_summary:
354
- overall_status: 'PASSED'
355
- system_readiness: 'READY_FOR_DEPLOYMENT'
354
+ overall_status: "PASSED"
355
+ system_readiness: "READY_FOR_DEPLOYMENT"
356
356
  critical_issues: 0
357
357
  total_test_cases: 2847
358
358
  pass_rate: 98.7%
359
359
 
360
360
  module_integration_results:
361
361
  user_management_module:
362
- status: 'PASSED'
362
+ status: "PASSED"
363
363
  test_cases: 456
364
364
  pass_rate: 99.1%
365
365
  critical_issues: 0
366
366
 
367
367
  data_management_module:
368
- status: 'PASSED'
368
+ status: "PASSED"
369
369
  test_cases: 623
370
370
  pass_rate: 98.9%
371
371
  critical_issues: 0
372
372
 
373
373
  performance_results:
374
374
  load_testing:
375
- baseline_load: 'PASSED'
376
- peak_load: 'PASSED'
377
- sustained_load: 'PASSED'
375
+ baseline_load: "PASSED"
376
+ peak_load: "PASSED"
377
+ sustained_load: "PASSED"
378
378
 
379
379
  response_time_analysis:
380
- average_api_response: '245ms'
381
- p95_response_time: '680ms'
382
- p99_response_time: '1.2s'
380
+ average_api_response: "245ms"
381
+ p95_response_time: "680ms"
382
+ p99_response_time: "1.2s"
383
383
 
384
384
  security_assessment:
385
- vulnerability_scan: 'PASSED'
386
- penetration_test: 'PASSED'
387
- compliance_check: 'PASSED'
385
+ vulnerability_scan: "PASSED"
386
+ penetration_test: "PASSED"
387
+ compliance_check: "PASSED"
388
388
  high_severity_issues: 0
389
389
 
390
390
  recommendations:
391
- - '优化数据库查询性能,减少p99响应时间'
392
- - '增加API监控告警机制'
393
- - '完善错误处理和用户友好提示'
391
+ - "优化数据库查询性能,减少p99响应时间"
392
+ - "增加API监控告警机制"
393
+ - "完善错误处理和用户友好提示"
394
394
  ```
395
395
 
396
396
  ### 交付清单
@@ -399,28 +399,28 @@ test_report:
399
399
  # delivery_checklist.yaml
400
400
  delivery_package:
401
401
  code_deliverables:
402
- - source_code: '完整源代码包'
403
- - build_artifacts: '构建产物'
404
- - database_scripts: '数据库部署脚本'
405
- - configuration_files: '配置文件模板'
402
+ - source_code: "完整源代码包"
403
+ - build_artifacts: "构建产物"
404
+ - database_scripts: "数据库部署脚本"
405
+ - configuration_files: "配置文件模板"
406
406
 
407
407
  documentation:
408
- - api_documentation: 'API接口文档'
409
- - deployment_guide: '部署指南'
410
- - user_manual: '用户使用手册'
411
- - maintenance_guide: '维护运营指南'
408
+ - api_documentation: "API接口文档"
409
+ - deployment_guide: "部署指南"
410
+ - user_manual: "用户使用手册"
411
+ - maintenance_guide: "维护运营指南"
412
412
 
413
413
  test_artifacts:
414
- - test_suites: '完整测试套件'
415
- - test_data: '测试数据集'
416
- - performance_benchmarks: '性能基准报告'
417
- - security_audit_report: '安全审计报告'
414
+ - test_suites: "完整测试套件"
415
+ - test_data: "测试数据集"
416
+ - performance_benchmarks: "性能基准报告"
417
+ - security_audit_report: "安全审计报告"
418
418
 
419
419
  operational_requirements:
420
- - infrastructure_specifications: '基础设施规格'
421
- - monitoring_configuration: '监控配置'
422
- - backup_procedures: '备份程序'
423
- - disaster_recovery_plan: '灾难恢复计划'
420
+ - infrastructure_specifications: "基础设施规格"
421
+ - monitoring_configuration: "监控配置"
422
+ - backup_procedures: "备份程序"
423
+ - disaster_recovery_plan: "灾难恢复计划"
424
424
  ```
425
425
 
426
426
  ## Integration with Full Requirement Orchestrator
@@ -430,21 +430,21 @@ delivery_package:
430
430
  ```yaml
431
431
  orchestrator_integration:
432
432
  trigger_conditions:
433
- all_stories_completed: '所有用户故事状态为Done'
434
- individual_story_tests_passed: '所有故事单元测试通过'
435
- dependency_integration_ready: '依赖集成就绪'
433
+ all_stories_completed: "所有用户故事状态为Done"
434
+ individual_story_tests_passed: "所有故事单元测试通过"
435
+ dependency_integration_ready: "依赖集成就绪"
436
436
 
437
- execution_command: '*execute-project-integration'
437
+ execution_command: "*execute-project-integration"
438
438
 
439
439
  success_criteria:
440
- integration_tests_passed: '集成测试100%通过'
441
- performance_benchmarks_met: '性能基准达标'
442
- security_validation_complete: '安全验证完成'
440
+ integration_tests_passed: "集成测试100%通过"
441
+ performance_benchmarks_met: "性能基准达标"
442
+ security_validation_complete: "安全验证完成"
443
443
 
444
444
  failure_handling:
445
- rollback_strategy: '回滚到最后稳定版本'
446
- issue_triage: '问题分级和分配'
447
- remediation_planning: '修复计划制定'
445
+ rollback_strategy: "回滚到最后稳定版本"
446
+ issue_triage: "问题分级和分配"
447
+ remediation_planning: "修复计划制定"
448
448
  ```
449
449
 
450
450
  ## Usage Examples
@@ -29,11 +29,11 @@ Slug rules:
29
29
 
30
30
  ```yaml
31
31
  schema: 1
32
- story: '{epic}.{story}'
32
+ story: "{epic}.{story}"
33
33
  gate: PASS|CONCERNS|FAIL|WAIVED
34
- status_reason: '1-2 sentence explanation of gate decision'
35
- reviewer: 'Quinn'
36
- updated: '{ISO-8601 timestamp}'
34
+ status_reason: "1-2 sentence explanation of gate decision"
35
+ reviewer: "Quinn"
36
+ updated: "{ISO-8601 timestamp}"
37
37
  top_issues: [] # Empty array if no issues
38
38
  waiver: { active: false } # Only set active: true if WAIVED
39
39
  ```
@@ -42,20 +42,20 @@ waiver: { active: false } # Only set active: true if WAIVED
42
42
 
43
43
  ```yaml
44
44
  schema: 1
45
- story: '1.3'
45
+ story: "1.3"
46
46
  gate: CONCERNS
47
- status_reason: 'Missing rate limiting on auth endpoints poses security risk.'
48
- reviewer: 'Quinn'
49
- updated: '2025-01-12T10:15:00Z'
47
+ status_reason: "Missing rate limiting on auth endpoints poses security risk."
48
+ reviewer: "Quinn"
49
+ updated: "2025-01-12T10:15:00Z"
50
50
  top_issues:
51
- - id: 'SEC-001'
51
+ - id: "SEC-001"
52
52
  severity: high # ONLY: low|medium|high
53
- finding: 'No rate limiting on login endpoint'
54
- suggested_action: 'Add rate limiting middleware before production'
55
- - id: 'TEST-001'
53
+ finding: "No rate limiting on login endpoint"
54
+ suggested_action: "Add rate limiting middleware before production"
55
+ - id: "TEST-001"
56
56
  severity: medium
57
- finding: 'No integration tests for auth flow'
58
- suggested_action: 'Add integration test coverage'
57
+ finding: "No integration tests for auth flow"
58
+ suggested_action: "Add integration test coverage"
59
59
  waiver: { active: false }
60
60
  ```
61
61
 
@@ -63,20 +63,20 @@ waiver: { active: false }
63
63
 
64
64
  ```yaml
65
65
  schema: 1
66
- story: '1.3'
66
+ story: "1.3"
67
67
  gate: WAIVED
68
- status_reason: 'Known issues accepted for MVP release.'
69
- reviewer: 'Quinn'
70
- updated: '2025-01-12T10:15:00Z'
68
+ status_reason: "Known issues accepted for MVP release."
69
+ reviewer: "Quinn"
70
+ updated: "2025-01-12T10:15:00Z"
71
71
  top_issues:
72
- - id: 'PERF-001'
72
+ - id: "PERF-001"
73
73
  severity: low
74
- finding: 'Dashboard loads slowly with 1000+ items'
75
- suggested_action: 'Implement pagination in next sprint'
74
+ finding: "Dashboard loads slowly with 1000+ items"
75
+ suggested_action: "Implement pagination in next sprint"
76
76
  waiver:
77
77
  active: true
78
- reason: 'MVP release - performance optimization deferred'
79
- approved_by: 'Product Owner'
78
+ reason: "MVP release - performance optimization deferred"
79
+ approved_by: "Product Owner"
80
80
  ```
81
81
 
82
82
  ## Gate Decision Criteria