@boyingliu01/xp-gate 0.7.0 → 0.8.0

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 (197) hide show
  1. package/bin/xp-gate.js +4 -9
  2. package/lib/__tests__/audit-log.test.ts +107 -0
  3. package/lib/__tests__/detect-deps.test.js +212 -42
  4. package/lib/__tests__/doctor.test.js +1 -0
  5. package/lib/__tests__/gate-audit.test.ts +59 -0
  6. package/lib/__tests__/init.test.js +47 -1
  7. package/lib/__tests__/install-skill.test.js +1 -45
  8. package/lib/__tests__/ui-detector.test.ts +186 -26
  9. package/lib/__tests__/ui-review.test.ts +119 -0
  10. package/lib/__tests__/uninstall.test.js +1 -0
  11. package/lib/detect-deps.js +180 -37
  12. package/lib/doctor.js +7 -9
  13. package/lib/gate-audit.ts +26 -42
  14. package/lib/init.js +42 -13
  15. package/lib/install-skill.js +20 -48
  16. package/lib/rollback.js +1 -16
  17. package/lib/shared-paths.js +30 -0
  18. package/lib/shared-utils.js +25 -0
  19. package/lib/ui-detector.ts +20 -14
  20. package/lib/ui-review.ts +58 -53
  21. package/lib/uninstall.js +8 -9
  22. package/package.json +1 -1
  23. package/plugins/claude-code/.claude-plugin/plugin.json +1 -1
  24. package/plugins/claude-code/skills/admin-template-guidelines/SKILL.md +904 -0
  25. package/plugins/claude-code/skills/delphi-review/.delphi-config.json.example +45 -0
  26. package/plugins/claude-code/skills/delphi-review/AGENTS.md +66 -0
  27. package/plugins/claude-code/skills/delphi-review/INSTALL.md +152 -0
  28. package/plugins/claude-code/skills/delphi-review/SKILL.md +454 -0
  29. package/plugins/claude-code/skills/delphi-review/opencode.json.delphi.example +56 -0
  30. package/plugins/claude-code/skills/delphi-review/references/code-walkthrough.md +486 -0
  31. package/plugins/claude-code/skills/improve-codebase-architecture/SKILL.md +156 -0
  32. package/plugins/claude-code/skills/ralph-loop/SKILL.md +501 -0
  33. package/plugins/claude-code/skills/ralph-loop/references/components/memory.md +55 -0
  34. package/plugins/claude-code/skills/ralph-loop/references/components/middleware.md +54 -0
  35. package/plugins/claude-code/skills/ralph-loop/references/components/skill-invocations.md +39 -0
  36. package/plugins/claude-code/skills/ralph-loop/references/components/system-prompt.md +24 -0
  37. package/plugins/claude-code/skills/ralph-loop/references/components/tool-descriptions.md +32 -0
  38. package/plugins/claude-code/skills/ralph-loop/references/phase-2-build-ralph.md +89 -0
  39. package/plugins/claude-code/skills/ralph-loop/templates/progress-log.md +36 -0
  40. package/plugins/claude-code/skills/sprint-flow/AGENTS.md +68 -0
  41. package/plugins/claude-code/skills/sprint-flow/SKILL.md +1248 -0
  42. package/plugins/claude-code/skills/sprint-flow/references/components/memory.md +87 -0
  43. package/plugins/claude-code/skills/sprint-flow/references/components/middleware.md +72 -0
  44. package/plugins/claude-code/skills/sprint-flow/references/components/skill-invocations.md +104 -0
  45. package/plugins/claude-code/skills/sprint-flow/references/components/system-prompt.md +27 -0
  46. package/plugins/claude-code/skills/sprint-flow/references/components/tool-descriptions.md +96 -0
  47. package/plugins/claude-code/skills/sprint-flow/references/force-levels.md +203 -0
  48. package/plugins/claude-code/skills/sprint-flow/references/phase-0-think.md +115 -0
  49. package/plugins/claude-code/skills/sprint-flow/references/phase-1-plan.md +178 -0
  50. package/plugins/claude-code/skills/sprint-flow/references/phase-2-build.md +198 -0
  51. package/plugins/claude-code/skills/sprint-flow/references/phase-3-review.md +213 -0
  52. package/plugins/claude-code/skills/sprint-flow/references/phase-4-uat.md +125 -0
  53. package/plugins/claude-code/skills/sprint-flow/references/phase-5-feedback.md +100 -0
  54. package/plugins/claude-code/skills/sprint-flow/references/phase-6-ship.md +193 -0
  55. package/plugins/claude-code/skills/sprint-flow/references/phase-7-land.md +140 -0
  56. package/plugins/claude-code/skills/sprint-flow/references/phase-8-cleanup.md +192 -0
  57. package/plugins/claude-code/skills/sprint-flow/references/phase-minus-0-5-auto-estimate.md +257 -0
  58. package/plugins/claude-code/skills/sprint-flow/templates/auto-estimate-learning-log.md +136 -0
  59. package/plugins/claude-code/skills/sprint-flow/templates/auto-estimate-output-template.md +132 -0
  60. package/plugins/claude-code/skills/sprint-flow/templates/emergent-issues-template.md +120 -0
  61. package/plugins/claude-code/skills/sprint-flow/templates/pain-document-template.md +115 -0
  62. package/plugins/claude-code/skills/sprint-flow/templates/sprint-progress-template.md +151 -0
  63. package/plugins/claude-code/skills/sprint-flow/templates/sprint-summary-template.md +120 -0
  64. package/plugins/claude-code/skills/test-driven-development/SKILL.md +71 -0
  65. package/plugins/claude-code/skills/test-specification-alignment/AGENTS.md +56 -0
  66. package/plugins/claude-code/skills/test-specification-alignment/SKILL.md +702 -0
  67. package/plugins/claude-code/skills/test-specification-alignment/references/alignment-verification-algorithm.md +493 -0
  68. package/plugins/claude-code/skills/test-specification-alignment/references/phase2-constraint-enforcement.md +431 -0
  69. package/plugins/claude-code/skills/test-specification-alignment/references/specification-format.md +348 -0
  70. package/plugins/claude-code/skills/to-issues/SKILL.md +277 -0
  71. package/plugins/opencode/README.md +38 -0
  72. package/plugins/opencode/index.ts +85 -0
  73. package/plugins/opencode/package.json +18 -0
  74. package/plugins/opencode/skills/admin-template-guidelines/SKILL.md +904 -0
  75. package/plugins/opencode/skills/delphi-review/.delphi-config.json.example +45 -0
  76. package/plugins/opencode/skills/delphi-review/AGENTS.md +66 -0
  77. package/plugins/opencode/skills/delphi-review/INSTALL.md +152 -0
  78. package/plugins/opencode/skills/delphi-review/SKILL.md +454 -0
  79. package/plugins/opencode/skills/delphi-review/opencode.json.delphi.example +56 -0
  80. package/plugins/opencode/skills/delphi-review/references/code-walkthrough.md +486 -0
  81. package/plugins/opencode/skills/improve-codebase-architecture/SKILL.md +156 -0
  82. package/plugins/opencode/skills/ralph-loop/SKILL.md +501 -0
  83. package/plugins/opencode/skills/ralph-loop/references/components/memory.md +55 -0
  84. package/plugins/opencode/skills/ralph-loop/references/components/middleware.md +54 -0
  85. package/plugins/opencode/skills/ralph-loop/references/components/skill-invocations.md +39 -0
  86. package/plugins/opencode/skills/ralph-loop/references/components/system-prompt.md +24 -0
  87. package/plugins/opencode/skills/ralph-loop/references/components/tool-descriptions.md +32 -0
  88. package/plugins/opencode/skills/ralph-loop/references/phase-2-build-ralph.md +89 -0
  89. package/plugins/opencode/skills/ralph-loop/templates/progress-log.md +36 -0
  90. package/plugins/opencode/skills/sprint-flow/AGENTS.md +68 -0
  91. package/plugins/opencode/skills/sprint-flow/SKILL.md +1248 -0
  92. package/plugins/opencode/skills/sprint-flow/references/components/memory.md +87 -0
  93. package/plugins/opencode/skills/sprint-flow/references/components/middleware.md +72 -0
  94. package/plugins/opencode/skills/sprint-flow/references/components/skill-invocations.md +104 -0
  95. package/plugins/opencode/skills/sprint-flow/references/components/system-prompt.md +27 -0
  96. package/plugins/opencode/skills/sprint-flow/references/components/tool-descriptions.md +96 -0
  97. package/plugins/opencode/skills/sprint-flow/references/force-levels.md +203 -0
  98. package/plugins/opencode/skills/sprint-flow/references/phase-0-think.md +115 -0
  99. package/plugins/opencode/skills/sprint-flow/references/phase-1-plan.md +178 -0
  100. package/plugins/opencode/skills/sprint-flow/references/phase-2-build.md +198 -0
  101. package/plugins/opencode/skills/sprint-flow/references/phase-3-review.md +213 -0
  102. package/plugins/opencode/skills/sprint-flow/references/phase-4-uat.md +125 -0
  103. package/plugins/opencode/skills/sprint-flow/references/phase-5-feedback.md +100 -0
  104. package/plugins/opencode/skills/sprint-flow/references/phase-6-ship.md +193 -0
  105. package/plugins/opencode/skills/sprint-flow/references/phase-7-land.md +140 -0
  106. package/plugins/opencode/skills/sprint-flow/references/phase-8-cleanup.md +192 -0
  107. package/plugins/opencode/skills/sprint-flow/references/phase-minus-0-5-auto-estimate.md +257 -0
  108. package/plugins/opencode/skills/sprint-flow/templates/auto-estimate-learning-log.md +136 -0
  109. package/plugins/opencode/skills/sprint-flow/templates/auto-estimate-output-template.md +132 -0
  110. package/plugins/opencode/skills/sprint-flow/templates/emergent-issues-template.md +120 -0
  111. package/plugins/opencode/skills/sprint-flow/templates/pain-document-template.md +115 -0
  112. package/plugins/opencode/skills/sprint-flow/templates/sprint-progress-template.md +151 -0
  113. package/plugins/opencode/skills/sprint-flow/templates/sprint-summary-template.md +120 -0
  114. package/plugins/opencode/skills/test-driven-development/SKILL.md +71 -0
  115. package/plugins/opencode/skills/test-specification-alignment/AGENTS.md +56 -0
  116. package/plugins/opencode/skills/test-specification-alignment/SKILL.md +702 -0
  117. package/plugins/opencode/skills/test-specification-alignment/references/alignment-verification-algorithm.md +493 -0
  118. package/plugins/opencode/skills/test-specification-alignment/references/phase2-constraint-enforcement.md +431 -0
  119. package/plugins/opencode/skills/test-specification-alignment/references/specification-format.md +348 -0
  120. package/plugins/opencode/skills/to-issues/SKILL.md +277 -0
  121. package/plugins/opencode/tsconfig.json +15 -0
  122. package/plugins/qoder/skills/admin-template-guidelines/SKILL.md +904 -0
  123. package/plugins/qoder/skills/delphi-review/.delphi-config.json.example +45 -0
  124. package/plugins/qoder/skills/delphi-review/AGENTS.md +66 -0
  125. package/plugins/qoder/skills/delphi-review/INSTALL.md +152 -0
  126. package/plugins/qoder/skills/delphi-review/SKILL.md +454 -0
  127. package/plugins/qoder/skills/delphi-review/opencode.json.delphi.example +56 -0
  128. package/plugins/qoder/skills/delphi-review/references/code-walkthrough.md +486 -0
  129. package/plugins/qoder/skills/improve-codebase-architecture/SKILL.md +156 -0
  130. package/plugins/qoder/skills/ralph-loop/SKILL.md +501 -0
  131. package/plugins/qoder/skills/ralph-loop/references/components/memory.md +55 -0
  132. package/plugins/qoder/skills/ralph-loop/references/components/middleware.md +54 -0
  133. package/plugins/qoder/skills/ralph-loop/references/components/skill-invocations.md +39 -0
  134. package/plugins/qoder/skills/ralph-loop/references/components/system-prompt.md +24 -0
  135. package/plugins/qoder/skills/ralph-loop/references/components/tool-descriptions.md +32 -0
  136. package/plugins/qoder/skills/ralph-loop/references/phase-2-build-ralph.md +89 -0
  137. package/plugins/qoder/skills/ralph-loop/templates/progress-log.md +36 -0
  138. package/plugins/qoder/skills/sprint-flow/AGENTS.md +68 -0
  139. package/plugins/qoder/skills/sprint-flow/SKILL.md +1248 -0
  140. package/plugins/qoder/skills/sprint-flow/references/components/memory.md +87 -0
  141. package/plugins/qoder/skills/sprint-flow/references/components/middleware.md +72 -0
  142. package/plugins/qoder/skills/sprint-flow/references/components/skill-invocations.md +104 -0
  143. package/plugins/qoder/skills/sprint-flow/references/components/system-prompt.md +27 -0
  144. package/plugins/qoder/skills/sprint-flow/references/components/tool-descriptions.md +96 -0
  145. package/plugins/qoder/skills/sprint-flow/references/force-levels.md +203 -0
  146. package/plugins/qoder/skills/sprint-flow/references/phase-0-think.md +115 -0
  147. package/plugins/qoder/skills/sprint-flow/references/phase-1-plan.md +178 -0
  148. package/plugins/qoder/skills/sprint-flow/references/phase-2-build.md +198 -0
  149. package/plugins/qoder/skills/sprint-flow/references/phase-3-review.md +213 -0
  150. package/plugins/qoder/skills/sprint-flow/references/phase-4-uat.md +125 -0
  151. package/plugins/qoder/skills/sprint-flow/references/phase-5-feedback.md +100 -0
  152. package/plugins/qoder/skills/sprint-flow/references/phase-6-ship.md +193 -0
  153. package/plugins/qoder/skills/sprint-flow/references/phase-7-land.md +140 -0
  154. package/plugins/qoder/skills/sprint-flow/references/phase-8-cleanup.md +192 -0
  155. package/plugins/qoder/skills/sprint-flow/references/phase-minus-0-5-auto-estimate.md +257 -0
  156. package/plugins/qoder/skills/sprint-flow/templates/auto-estimate-learning-log.md +136 -0
  157. package/plugins/qoder/skills/sprint-flow/templates/auto-estimate-output-template.md +132 -0
  158. package/plugins/qoder/skills/sprint-flow/templates/emergent-issues-template.md +120 -0
  159. package/plugins/qoder/skills/sprint-flow/templates/pain-document-template.md +115 -0
  160. package/plugins/qoder/skills/sprint-flow/templates/sprint-progress-template.md +151 -0
  161. package/plugins/qoder/skills/sprint-flow/templates/sprint-summary-template.md +120 -0
  162. package/plugins/qoder/skills/test-driven-development/SKILL.md +71 -0
  163. package/plugins/qoder/skills/test-specification-alignment/AGENTS.md +56 -0
  164. package/plugins/qoder/skills/test-specification-alignment/SKILL.md +702 -0
  165. package/plugins/qoder/skills/test-specification-alignment/references/alignment-verification-algorithm.md +493 -0
  166. package/plugins/qoder/skills/test-specification-alignment/references/phase2-constraint-enforcement.md +431 -0
  167. package/plugins/qoder/skills/test-specification-alignment/references/specification-format.md +348 -0
  168. package/plugins/qoder/skills/to-issues/SKILL.md +277 -0
  169. package/skills/admin-template-guidelines/SKILL.md +904 -0
  170. package/skills/delphi-review/SKILL.md +112 -77
  171. package/skills/improve-codebase-architecture/SKILL.md +156 -0
  172. package/skills/ralph-loop/SKILL.md +165 -34
  173. package/skills/sprint-flow/SKILL.md +448 -107
  174. package/skills/sprint-flow/references/components/skill-invocations.md +1 -1
  175. package/skills/sprint-flow/references/components/tool-descriptions.md +1 -1
  176. package/skills/sprint-flow/references/force-levels.md +203 -0
  177. package/skills/sprint-flow/references/phase-1-plan.md +4 -4
  178. package/skills/sprint-flow/references/phase-minus-0-5-auto-estimate.md +20 -1
  179. package/skills/sprint-flow/templates/auto-estimate-output-template.md +7 -5
  180. package/skills/sprint-flow/templates/sprint-progress-template.md +151 -0
  181. package/skills/test-driven-development/SKILL.md +71 -0
  182. package/skills/test-specification-alignment/SKILL.md +98 -24
  183. package/skills/to-issues/SKILL.md +277 -0
  184. package/plugins/qoder/AGENTS.md +0 -93
  185. package/plugins/qoder/README.md +0 -87
  186. package/plugins/qoder/widgets/quality-report.html +0 -163
  187. package/plugins/qoder/widgets/sprint-dashboard.html +0 -172
  188. package/skills/delphi-review/evals/evals.json +0 -82
  189. package/skills/delphi-review/references/qoder-multi-model.md +0 -191
  190. package/skills/ralph-loop/evals/evals.json +0 -311
  191. package/skills/ralph-loop/evolution-history.json +0 -59
  192. package/skills/ralph-loop/evolution-log.md +0 -16
  193. package/skills/sprint-flow/evals/evals.json +0 -130
  194. package/skills/sprint-flow/evolution-history.json +0 -39
  195. package/skills/sprint-flow/evolution-log.md +0 -23
  196. package/skills/sprint-flow/references/qoder-adaptation.md +0 -173
  197. package/skills/test-specification-alignment/evals/evals.json +0 -75
@@ -0,0 +1,87 @@
1
+ # memory.md — Sprint State JSON Schema 与长期记忆(AHE 组件分解)
2
+
3
+ > **本文是 `skills/sprint-flow/SKILL.md` 中状态管理 JSON (L190-334) 的 AHE 对齐展开。**
4
+ > 用于 ablation 实验:AHE 论文显示 Memory 组件单独恢复全局增幅的 95%+。
5
+
6
+ ## 组件职责
7
+
8
+ 定义 Sprint 状态持久化 Schema、Phase 输出合同、长期记忆(learnings)结构。是 AHE 中最关键组件(记忆单独恢复 95%+ 全局增益)。
9
+
10
+ ---
11
+
12
+ ## Sprint State Schema(`.sprint-state/sprint-state.json`)
13
+
14
+ ```json
15
+ {
16
+ "id": "sprint-YYYY-MM-DD-NN",
17
+ "phase": 0,
18
+ "status": "running|paused|completed",
19
+ "outputs": {
20
+ "pain_document": "docs/pain-document.md",
21
+ "specification": "specification.yaml",
22
+ "mvp": "mvp-v1/",
23
+ "review_report": "review-report.md"
24
+ },
25
+ "metrics": {
26
+ "tests_passed": 15,
27
+ "tests_failed": 0,
28
+ "coverage_pct": 85
29
+ }
30
+ }
31
+ ```
32
+
33
+ ### 状态枚举
34
+
35
+ | 字段 | 允许值 | 说明 |
36
+ |------|-------|------|
37
+ | `phase` | 0-6 | 当前执行阶段 |
38
+ | `status` | `pending` / `running` / `paused` / `completed` / `failed` | 统一状态 |
39
+ | `pause_reason` | `none` / `wait_approved` / `wait_gate1` / `wait_uat` / `wait_ship` / `wait_user_confirm` | 暂停原因 |
40
+
41
+ ---
42
+
43
+ ## Phase Output 合同
44
+
45
+ | Phase | 输出文件 | 存储路径 | 必需字段 |
46
+ |-------|---------|---------|---------|
47
+ | Phase 0 | `pain-document.md` | `phase-outputs/pain-document.md` | 结构化设计文档 |
48
+ | Phase 1 | `specification.yaml` | `phase-outputs/specification.yaml` | user_stories[], requirements[], acceptance_criteria[] |
49
+ | Phase 2 | `mvp-v1/` | `phase-outputs/mvp-v1/` | 功能代码 + 测试 |
50
+ | Phase 3 | `review-report.md` | `phase-outputs/review-report.md` | delphi-review 共识报告 |
51
+ | Phase 4 | `emergent-issues.md` | `phase-outputs/emergent-issues.md` | 用户发现的 emergent requirements |
52
+ | Phase 5 | `feedback-log.md` | `phase-outputs/feedback-log.md` | 改进建议 + 调试记录 |
53
+ | Phase 6 | `sprint-summary.md` | `phase-outputs/sprint-summary.md` | 发布记录 + Sprint 2 触发判断 |
54
+
55
+ ---
56
+
57
+ ## Sprint 2 自动触发规则
58
+
59
+ ```
60
+ Phase 6 完成后:
61
+ IF emergent_issues_count == 0 → sprint_completed,结束
62
+ IF emergent_issues_count > 0 → sprint_2_needed:
63
+ ├─ IF 有 Critical → 自动启动 Sprint 2
64
+ ├─ IF 仅有 Major/Minor → 询问用户
65
+ └─ Sprint 2 Pain Document ← emergent-issues.md 转化
66
+ ```
67
+
68
+ ---
69
+
70
+ ## Learnings Schema(长期记忆)
71
+
72
+ ralph-loop 内部分类:
73
+ - `permanent`: 跨 REQ 持久化(通用约束、模式)
74
+ - `contextual`: 当前 REQ 生命周期内有效
75
+
76
+ gstack/learn 调用分类: permanent / contextual 通过 progress.log 持久化。
77
+
78
+ ---
79
+
80
+ ## AHE 分类
81
+
82
+ | 字段 | 值 |
83
+ |------|---|
84
+ | 组件类型 | Long-Term Memory |
85
+ | 修改频率预期 | 低(Schema 稳定) |
86
+ | 消融实验假设 | 移除 memory → Sprint pass rate 下降 5-10% |
87
+ | 参考证据 | AHE 论文: Memory 单独恢复 95%+ 全局增幅(事实性 > 策略性) |
@@ -0,0 +1,72 @@
1
+ # middleware.md — Sprint Flow 状态机与暂停点逻辑(AHE 组件分解)
2
+
3
+ > **本文是 `skills/sprint-flow/SKILL.md` 中完整流程 (L46-68) 和暂停点表 (L72-84) 的 AHE 对齐展开。**
4
+ > 用于 ablation 实验:AHE 论文显示 Middleware 组件贡献占 37%,单独修改可显著影响性能。
5
+
6
+ ## 组件职责
7
+
8
+ 定义 Sprint Flow 的状态机转换逻辑、暂停点(pause-point)触发条件和自动恢复规则。是 phase 间的"胶水层",负责在特定节点暂停等待用户决策。
9
+
10
+ ---
11
+
12
+ ## 完整状态机(7 Phase 流转)
13
+
14
+ ```
15
+ Phase 0: THINK → brainstorming → HARD-GATE: 设计未 APPROVED → 不可编码
16
+ Phase 1: PLAN → autoplan → delphi-review → spec.yaml
17
+ Phase 2: BUILD → GITHOOKS-GATE → ralph-loop/TDD → verification → MVP v1
18
+ Phase 3: REVIEW → code-walkthrough → test-alignment → browse QA
19
+ Phase 4: USER ACCEPTANCE → ⚠️ 必须人工 → Emergent Issues List
20
+ Phase 5: FEEDBACK → learn + retro + systematic-debugging
21
+ Phase 6: SHIP → finishing-a-development-branch → canary → Sprint Summary
22
+ ```
23
+
24
+ ## 暂停点矩阵
25
+
26
+ | Phase | 暂停点标识 | 触发条件 | 用户操作 | 自动恢复条件 |
27
+ |-------|-----------|---------|---------|-------------|
28
+ | Phase 0 | **HARD-GATE** | 设计未 APPROVED | 修改设计文档 | 设计 APPROVED 后继续 |
29
+ | Phase 1 | taste_decisions | autoplan 发现未决议事项 | 用户确认每个决策 | 确认后自动继续 |
30
+ | Phase 1 | delphi-review | 未 APPROVED(REQUEST_CHANGES) | 修复并重新评审 | APPROVED 后自动继续 |
31
+ | **Phase 2** | **DELPHI-GATE** | delphi-reviewed.json 不存在或 verdict != APPROVED | 返回 Phase 1 完成 delphi-review | APPROVED 后继续 |
32
+ | Phase 2 | 验证失败 | 超过 max 3 次失败 | 用户决定修复或放弃 | 验证通过后自动继续 |
33
+ | Phase 2 | 成本超阈值 | token 成本 > 阈值 | 用户决定继续或暂停 | 用户确认后自动继续 |
34
+ | Phase 3 | browse 发现问题 | QA 失败 | 回退 Phase 2 | 验证通过后自动继续 |
35
+ | **Phase 4** | **必须人工验收** | 进入 Phase 4 | 用户实际使用后确认 | **无法自动恢复** |
36
+ | **Phase 5** | **FEEDBACK 硬门禁** | Phase 4 完成后进入 | 执行 learn + retro → 生成 feedback-log.md | feedback-log.md 存在后继续 |
37
+ | **Phase 6** | **Phase 5 门禁验证** | Phase 5 未完成 | 验证 feedback-log.md → 不存在 → 返回 Phase 5 | feedback-log.md 存在后继续 |
38
+ | Phase 6 | finishing-a-branch | 分支收尾 | 用户 4 选 1 | 确认后自动继续 |
39
+ | Phase 6 | ship PR | PR 路径需要合并 | 用户确认合并 | 合并后自动继续 |
40
+
41
+ ## 状态转换规则
42
+
43
+ | 当前状态 | 下一状态 | 条件 |
44
+ |---------|---------|------|
45
+ | Phase N 完成 | Phase N+1 | 无阻塞条件 |
46
+ | Phase 0 HARD-GATE 未通过 | Phase 0 (重试) | 设计未 APPROVED |
47
+ | Phase 2 DELPHI-GATE 未通过 | Phase 1 (回退) | delphi-review not APPROVED |
48
+ | Phase 4 人工验收未完成 | Phase 4 (等待) | **永远不可自动跳过** |
49
+ | Phase 4 确认完成 | Phase 5 | **必须执行,不可跳过** |
50
+ | Phase 5 未完成 (feedback-log.md 不存在) | Phase 5 (等待) | **永远不可自动跳过** |
51
+ | Phase 2 验证失败 > 3 次 | BLOCK (用户决策) | 熔断机制 |
52
+ | Phase 2 成本超限 | BLOCK (用户决策) | 熔断机制 |
53
+
54
+ ## 熔断机制 (Circuit Breaker)
55
+
56
+ | 原 xp-consensus 状态 | 新处理方案 |
57
+ |---------------------|-----------|
58
+ | `CIRCUIT_BREAKER_TRIGGERED` | sprint-flow 编排层监控成本,超阈值 BLOCK + 用户决策 |
59
+ | `ROLLBACK_TO_ROUND1` | verification-before-completion 失败 → 修复 max 3 次 → 仍失败 BLOCK |
60
+ | `GATE1_FAILED`/`GATE1_COMPLETE` | verification-before-completion 内置此区分 |
61
+ | `GATE2_RUNNING` | `cso` (gstack) — Phase 1-6 安全审计 |
62
+
63
+ ---
64
+
65
+ ## AHE 分类
66
+
67
+ | 字段 | 值 |
68
+ |------|---|
69
+ | 组件类型 | Middleware |
70
+ | 修改频率预期 | 高(状态机调整频繁) |
71
+ | 消融实验假设 | 修改暂停点逻辑 → Sprint 执行时间变化 ±15% |
72
+ | 参考证据 | AHE 论文: Middleware 组件单独修改带来 +2.2% 总增益 |
@@ -0,0 +1,104 @@
1
+ # skill-invocations.md — Phase→Skill 调用链与参数路由(AHE 组件分解)
2
+
3
+ > **本文是 `skills/sprint-flow/SKILL.md` 中各 Phase 调用 Skills (L88-103, L155-167) 的 AHE 对齐展开。**
4
+ > 用于 ablation 实验:验证 phase→skill 映射完整性对 Sprint 成功率的影响。
5
+
6
+ ## 组件职责
7
+
8
+ 提供完整的 Phase→Skill 映射表,包括技能来源、参数路由规则、条件分支逻辑。确保每次 Skill 调用具有足够的上下文信息。
9
+
10
+ ---
11
+
12
+ ## 完整 Phase→Skill 映射矩阵
13
+
14
+ ### Phase 0: THINK
15
+
16
+ | Skill | 来源 | 触发条件 | 输出 |
17
+ |-------|------|---------|------|
18
+ | `brainstorming` | superpowers | 无条件(首个 Skill) | 结构化设计文档 |
19
+ | **硬闸门** | — | 设计未批准 → 停止 | 禁止进入 Plan |
20
+
21
+ ### Phase 1: PLAN
22
+
23
+ | Skill | 来源 | 触发条件 | 条件分支 |
24
+ |-------|------|---------|---------|
25
+ | `autoplan` | gstack | 进入 Phase 1 自动调用 | 输出 AUTO_APPROVED 或 NEEDS_REVIEW |
26
+ | `delphi-review` | xp-gate | Phase 1 强制调用;AUTO_APPROVED + 无 taste_decisions 使用 lightweight delphi-review | 必须产生 `.sprint-state/delphi-reviewed.json` 且 verdict=APPROVED |
27
+ | `to-issues` | xp-gate | delphi-review APPROVED 后 | 拆解为垂直切片 → slices-manifest.json |
28
+
29
+ ### Phase 2: BUILD
30
+
31
+ | 步骤 | Skill | 来源 | 参数注入 |
32
+ |------|-------|------|---------|
33
+ | -1 | `hooks-install` | githooks | 无 |
34
+ | 0 | `dispatching-parallel-agents` | superpowers | 仅分发 AFK 切片(dependency_graph 判定) |
35
+ | 1 | `test-driven-development` | superpowers | `--lang` 注入对应 TDD skill |
36
+ | 2 | `executing-plans` | superpowers | 隔离 session,review checkpoint |
37
+ | 3 | `freeze` | gstack | 锁定业务代码 |
38
+ | 4 | `requesting-code-review` | superpowers | 盲评 agent |
39
+ | 5 | `unfreeze` | gstack | 解锁 |
40
+ | 6 | `verification-before-completion` | superpowers | 运行测试 + lint |
41
+ | 7 | 成本监控 | sprint-flow 编排层 | token 阈值 |
42
+
43
+ ### Phase 3: REVIEW
44
+
45
+ | Skill | 模式 | 触发条件 |
46
+ |-------|------|---------|
47
+ | `delphi-review` | `--mode code-walkthrough` | 强制调用 |
48
+ | `test-specification-alignment` | 默认 | 强制调用 |
49
+ | `browse` | gstack | 强制调用 |
50
+ | `k6`/`locust`/`gatling` | 性能测试 | `--with-performance` 或 `--type backend-*` |
51
+
52
+ ### Phase 4: USER ACCEPTANCE
53
+
54
+ | Skill | 说明 |
55
+ |-------|------|
56
+ | **无 Skill** | 必须人工验收 |
57
+
58
+ ### Phase 5: FEEDBACK
59
+
60
+ | Skill | 来源 | 说明 |
61
+ |-------|------|------|
62
+ | `learn` | gstack | 模式记录 |
63
+ | `retro` | gstack | 工程回顾 |
64
+ | `systematic-debugging` | superpowers | 根因调试 |
65
+
66
+ ### Phase 6: SHIP
67
+
68
+ | Skill | 说明 |
69
+ |-------|------|
70
+ | `finishing-a-development-branch` | 4 选项 |
71
+ | `ship` | 创建 PR(可选) |
72
+ | `land-and-deploy` | 合并部署 |
73
+ | `canary` | 监控告警 |
74
+
75
+ ---
76
+
77
+ ## 参数路由规则
78
+
79
+ ### `--lang` 路由
80
+
81
+ | 值 | Phase 2 注入 | Phase 3 注入 |
82
+ |---|-------------|-------------|
83
+ | `springboot` | `springboot-tdd` | springboot-verification |
84
+ | `django` | `django-tdd` | django-verification |
85
+ | `golang` | `golang-testing` | golang-verification |
86
+
87
+ ### `--type` 路由
88
+
89
+ | 值 | 检测依据 | 额外 Skill |
90
+ |---|---------|-----------|
91
+ | `web-nextjs` | `next.config.js` / `app/` | `design-shotgun` |
92
+ | `backend-go` | `go.mod` | `k6` |
93
+ | `backend-springboot` | `pom.xml` | `gatling` |
94
+ | `backend-django` | `manage.py` | `locust` |
95
+
96
+ ---
97
+
98
+ ## AHE 分类
99
+
100
+ | 字段 | 值 |
101
+ |------|---|
102
+ | 组件类型 | Skill Invocation Chain |
103
+ | 修改频率预期 | 中(新 skill 注册时更新) |
104
+ | 消融实验假设 | 调用链中断 → Sprint 执行失败率 ↑ |
@@ -0,0 +1,27 @@
1
+ # system-prompt.md — Sprint Flow 行为定义(AHE 组件分解)
2
+
3
+ > **本文是 `skills/sprint-flow/SKILL.md` 核心原则部分 (L34-43) 的 AHE 对齐展开。**
4
+ > 用于 ablation 实验:单独修改本文件可观察核心原则对 Sprint pass rate 的影响。
5
+
6
+ ## 核心职责
7
+
8
+ 定义 Sprint Flow 的行为边界和全局约束。相当于 AHE 的 System Prompt 组件(虽 AHE 论文显示单独修改 System Prompt 不改善性能,但作为行为基准仍然必要)。
9
+
10
+ ## 核心原则 (AHE 对齐)
11
+
12
+ | # | AHE 概念 | 原则 | 说明 | 硬闸门 |
13
+ |---|---------|------|------|--------|
14
+ | 1 | 单一入口 | `/sprint-flow` | 用户只需一个命令,自动串联全流程 | Phase 0 HARD-GATE |
15
+ | 2 | 自动流水线 | Think → Ship | 类似 autoplan,自动执行多个阶段 | 无需用户手动调用中间技能 |
16
+ | 3 | 关键节点暂停 | APPROVED / Gate 1 / Phase 4 / Ship | 明确暂停点,不是随时停 | Phase 0 设计未 APPROVED → 禁止编码 |
17
+ | 4 | 承认 Emergent Requirements | 用户验收环节必须人工 | 78% 失败不可见,无法自动化 | Phase 4 MUST NOT 自动化 |
18
+ | 5 | 复用现有 Skills | 不重新发明 | 整合 brainstorming + autoplan + delphi-review + TDD 等 | 不创建新 skill,复用现有体系 |
19
+
20
+ ## AHE 分类
21
+
22
+ | 字段 | 值 |
23
+ |------|---|
24
+ | 组件类型 | System Prompt |
25
+ | 修改频率预期 | 低(行为基线稳定后极少改变) |
26
+ | 消融实验假设 | 修改核心原则 → Sprint pass rate 不变或下降(AHE 发现单独修改系统提示下降 2.3%) |
27
+ | 关键约束 | 不得删除 Phase 4 人工验收硬闸 |
@@ -0,0 +1,96 @@
1
+ # tool-descriptions.md — Sprint Flow 各 Phase 调用的 Skill 完整描述(AHE 组件分解)
2
+
3
+ > **本文是 `skills/sprint-flow/SKILL.md` 中 Phase 2-6 Skill 调用 (L120-298) 的 AHE 对齐展开。**
4
+ > 用于 ablation 实验:AHE 论文显示 Tool 组件贡献占 48%,单独修改可显著影响性能。
5
+
6
+ ## 组件职责
7
+
8
+ 完整描述 sprint-flow 在每个 Phase 中调用的 Skill,包括参数路由、`--lang`/`--type` 注入、条件分支逻辑。是 ablation 实验中**最可能产生显著增益**的组件。
9
+
10
+ ---
11
+
12
+ ## Phase 2: BUILD 工具链(核心贡献区 — 48%)
13
+
14
+ ### 默认模式: ralph-loop
15
+
16
+ | 步骤 | Skill | 来源 | 说明 |
17
+ |------|-------|------|------|
18
+ | -1 | `hooks-install` | githooks | `githooks/verify.sh` → 缺失则 `githooks/install.sh` |
19
+ | 0 | `dispatching-parallel-agents` | superpowers | 检测可并行任务 |
20
+ | 1 | `test-driven-development` | superpowers | RED → GREEN → REFACTOR |
21
+ | 2 | `executing-plans` | superpowers | 隔离 session,review checkpoint |
22
+ | 3 | `freeze` | gstack | 盲评隔离 |
23
+ | 4 | `requesting-code-review` | superpowers | 独立 agent 评审 |
24
+ | 5 | `unfreeze` | gstack | 解锁 |
25
+ | 6 | `verification-before-completion` | superpowers | 测试 + lint |
26
+ | 7 | 成本监控 | sprint-flow 编排层 | 超阈值 BLOCK |
27
+
28
+ ### GITHOOKS-GATE (Phase 1→2 闸门)
29
+
30
+ - 执行时机: Phase 1 完全通过、准备进入 Phase 2 BUILD 前
31
+ - `githooks/verify.sh` 全部存在 → 进入 BUILD 入口(仍必须先执行 DELPHI-GATE)
32
+ - 缺失 → `githooks/install.sh` 安装(hooks + adapter 基础设施)
33
+ - **核心原则**: 没有质量门禁的代码不可进入 BUILD。**失败 → 不可编码。**
34
+
35
+ ### 语言特定 TDD
36
+
37
+ 通过 `--lang` 参数注入:
38
+ - `springboot-tdd` → springboot-verification
39
+ - `django-tdd` → django-verification
40
+ - `golang-testing` → golang-verification
41
+
42
+ ---
43
+
44
+ ## Phase 3: REVIEW + TEST 工具链
45
+
46
+ | Skill | 模式 | 说明 |
47
+ |-------|------|------|
48
+ | `delphi-review` | `--mode code-walkthrough` | 多专家匿名代码走查 |
49
+ | `test-specification-alignment` | 默认 | 测试与 Spec 对齐验证 |
50
+ | `browse` | gstack | 浏览器自动化测试 |
51
+ | `k6` / `locust` / `gatling` | 可选 | 后端负载测试 |
52
+
53
+ ---
54
+
55
+ ## Phase 5: FEEDBACK 工具链
56
+
57
+ | Skill | 说明 |
58
+ |-------|------|
59
+ | `learn` | gstack,模式记录 |
60
+ | `retro` | gstack,工程回顾 |
61
+ | `systematic-debugging` | superpowers,根因调试 |
62
+
63
+ ---
64
+
65
+ ## Phase 6: SHIP 工具链
66
+
67
+ | Skill | 说明 |
68
+ |-------|------|
69
+ | `finishing-a-development-branch` | 4 选项: merge / PR / discard / keep |
70
+ | `ship` | gstack,创建 PR |
71
+ | `land-and-deploy` | 合并部署 |
72
+ | `canary` | 监控告警 |
73
+
74
+ ---
75
+
76
+ ## 项目类型 → Skill 注入映射
77
+
78
+ | Phase | Backend (default) | Web Frontend | Mobile |
79
+ |-------|------------------|-------------|--------|
80
+ | Phase 0 (THINK) | `brainstorming` | (同) | (同) |
81
+ | Phase 1 (PLAN) | `autoplan` + `delphi-review` | + `design-shotgun` | (同 web) |
82
+ | Phase 2 (BUILD) | TDD + blind-review | (同 backend) | + `vercel-react-native-skills` / `flutter-review` |
83
+ | Phase 3 (REVIEW) | `delphi-review --mode code-walkthrough` | + `qa` + `design-review` + `benchmark` | `flutter-test` / `detox E2E` |
84
+ | Phase 5 (FEEDBACK) | `learn` + `retro` | (同) | (同) |
85
+ | Phase 6 (SHIP) | `finishing-a-development-branch` + `ship` | (同) | + platform deploy |
86
+
87
+ ---
88
+
89
+ ## AHE 分类
90
+
91
+ | 字段 | 值 |
92
+ |------|---|
93
+ | 组件类型 | Tool Description |
94
+ | 修改频率预期 | 高(Phase 2 BUILD 工具链频繁调整) |
95
+ | 消融实验假设 | 增删 phase→skill 映射 → Sprint pass rate 变化 ±20%+ |
96
+ | 参考证据 | AHE 论文: Tool 组件单独修改带来 +3.3% 总增益 |
@@ -0,0 +1,203 @@
1
+ # Sprint Flow 执行级别定义
2
+
3
+ **执行时机**: Phase 0 THINK 之前,AUTO-ESTIMATE 完成后。
4
+
5
+ **目的**: 根据需求规模匹配适度评审流程,平衡质量保障与效率。
6
+
7
+ **核心原则**:
8
+ - 所有级别**必须经过 Delphi 评审**,不可跳过
9
+ - 轻量级采用**简化 Delphi**(2 专家、1 轮),仍需 2/2 批准
10
+ - 标准/复杂采用**完整 Delphi**(2-3 专家、多轮)
11
+ - 自动升级机制:当出现风险信号时强制升级级别
12
+
13
+ ---
14
+
15
+ ## 级别定义
16
+
17
+ | 级别 | 适用场景 | 专家数 | 最多轮数 | 通过条件 | 预计耗时 |
18
+ |------|---------|--------|---------|----------|---------|
19
+ | **轻量** | 小改动、局部修改、删除代码 | 2 | 1 | 2/2 批准 | 10-20 分钟 |
20
+ | **标准** | 常规功能开发、模块重构 | 2 | 2 | 2/2 批准 | 30-60 分钟 |
21
+ | **复杂** | 核心模块、跨模块变更、新增架构 | 3 | 3 | 3/3 批准 | 1-2 小时 |
22
+
23
+ ---
24
+
25
+ ## Token 成本预算
26
+
27
+ | 级别 | delphi-review 调用 | 预计 Token 消耗 | 成本说明 |
28
+ |------|-------------------|--------------|---------|
29
+ | **轻量** | 1 次(2 专家、1 轮) | ~8,000 | 简化流程,单轮评审 |
30
+ | **标准** | 1-2 次(2 专家、1-2 轮) | ~15,000-25,000 | 可能需要 1 轮反馈 |
31
+ | **复杂** | 1-3 次(3 专家、1-3 轮) | ~30,000-60,000 | 多轮深度评审 |
32
+
33
+ > **成本计算依据**: 基于实际 Sprint 历史数据,假设每次 delphi-review 调用平均消耗 8,000-10,000 Token(含 3 位专家的输入输出)。
34
+
35
+ ---
36
+
37
+ ## 测试与验证要求
38
+
39
+ | 级别 | 单元测试 | 测试覆盖率 | 验证方式 |
40
+ |------|---------|-----------|---------|
41
+ | **轻量** | 修改处必须有测试 | ≥75% | 自动运行 + 人工抽查 |
42
+ | **标准** | 新增功能必须有测试 | ≥80% | 自动运行 + 人工复核 |
43
+ | **复杂** | 全链路测试 + 边界用例 | ≥85% | 自动运行 + Delphi 验证 |
44
+
45
+ **强制规则**:
46
+ - 轻量级修改**不可跳过测试**,至少添加回归测试
47
+ - 所有级别必须通过 `test-specification-alignment` 验证
48
+ - 未添加测试 → 自动升级至标准级别
49
+
50
+ ---
51
+
52
+ ## 自动升级机制
53
+
54
+ 当出现以下任一情况时,**强制升级**至更高级别:
55
+
56
+ | 触发条件 | 原级别 | 升级至 | 说明 |
57
+ |---------|--------|--------|------|
58
+ | Delphi 评审出现 REQUEST_CHANGES | 轻量 | 标准 | 需要第二轮评审 |
59
+ | 专家意见分歧(1 票反对) | 轻量/标准 | 复杂 | 需要第 3 专家仲裁 |
60
+ | 涉及公共 API 变更 | 轻量 | 标准 | 影响外部调用方 |
61
+ | 修改文件数 > 5 或 LOC > 200 | 轻量 | 标准 | 改动规模超出轻量范围 |
62
+ | 存在循环依赖 | 轻量/标准 | 复杂 | 架构风险高 |
63
+ | 测试覆盖率 < 75% | 轻量 | 标准 | 质量不达标 |
64
+ | 修改核心模块(core/handlers) | 轻量/标准 | 复杂 | 关键路径 |
65
+
66
+ **升级流程**:
67
+ 1. 自动检测触发条件
68
+ 2. 输出升级警告:`[LEVEL_UPGRADE] 从 {原级别} 升级至 {新级别},原因:{触发条件}`
69
+ 3. 保存升级记录到 `.sprint-state/level-upgrade-log.json`
70
+ 4. 重新执行对应级别的评审流程
71
+
72
+ ---
73
+
74
+ ## 与 AUTO-ESTIMATE 的关系
75
+
76
+ AUTO-ESTIMATE 提供**初始级别建议**,Force Levels 定义**具体执行规则**:
77
+
78
+ ```
79
+ AUTO-ESTIMATE 输出 → Force Levels 执行 → 自动升级机制(如触发)
80
+ ```
81
+
82
+ | AUTO-ESTIMATE 指标 | 建议级别 | Force Levels 执行 |
83
+ |-------------------|---------|------------------|
84
+ | 引用计数 ≤ 3 + 跨模块 ≤ 1 | 轻量 | 2 专家、1 轮 Delphi |
85
+ | 引用计数 4-10 或 跨模块 2 | 标准 | 2 专家、最多 2 轮 Delphi |
86
+ | 引用计数 > 10 或 跨模块 ≥ 3 | 复杂 | 3 专家、最多 3 轮 Delphi |
87
+ | 存在循环依赖 | 强制复杂 | 3 专家、最多 3 轮 + 架构评审 |
88
+
89
+ **关键区别**:
90
+ - AUTO-ESTIMATE: **客观指标分析**(代码结构、引用计数)
91
+ - Force Levels: **执行规则定义**(评审流程、升级机制)
92
+
93
+ ---
94
+
95
+ ## 与 DELPHI-GATE 的关系
96
+
97
+ **DELPHI-GATE** 是 Phase 2 的**强制门禁**,检查 `.sprint-state/delphi-reviewed.json` 的 `verdict=APPROVED`。Force Levels 定义**产生该门禁文件的评审强度**:
98
+
99
+ | 场景 | DELPHI-GATE | Force Levels |
100
+ |------|------------|-------------|
101
+ | Phase 1 设计评审 | 3 专家、≥95% 共识、生成 specification.yaml | 不适用(设计阶段) |
102
+ | Phase 2 BUILD 入口 | **必须检查** `.sprint-state/delphi-reviewed.json` 中 `verdict=APPROVED` | 轻量/标准/复杂:通过对应强度的 delphi-review 生成该门禁文件 |
103
+ | 轻量级评审 | 生成 `delphi-reviewed.json`(2 专家、1 轮、2/2 批准) | 2 专家、1 轮、写入门禁文件 |
104
+ | 标准级评审 | 生成 `delphi-reviewed.json`(2 专家、最多 2 轮、2/2 批准) | 2 专家、最多 2 轮、写入门禁文件 |
105
+ | 复杂级评审 | 生成 `delphi-reviewed.json`(3 专家、最多 3 轮、3/3 批准) | 3 专家、最多 3 轮、写入门禁文件 |
106
+ | Phase 3 代码走查 | 再次检查 `delphi-reviewed.json` 或重新评审 | 复用 Force Levels 规则 |
107
+
108
+ **关键规则**:
109
+ - **DELPHI-GATE 永不跳过**:Phase 2 BUILD 入口必须检查 `.sprint-state/delphi-reviewed.json` 中 `verdict=APPROVED`
110
+ - **Force Levels 定义评审强度**:轻量/标准/复杂决定用 2 专家 1 轮还是 3 专家 3 轮来**产生**门禁文件
111
+ - **轻量级不是跳过评审**:而是简化流程(2 专家、1 轮),但仍需生成门禁文件
112
+ - **LIGHTWEIGHT ≠ ONE-EXPERT**: 1 专家违反 Delphi 核心原则,禁止
113
+
114
+ ---
115
+
116
+ ## 轻量级详细规则
117
+
118
+ **适用场景**:
119
+ - 删除已存在代码(如移除废弃模块)
120
+ - 小规模修改(≤ 5 个文件、≤ 200 行改动)
121
+ - 不涉及公共 API
122
+ - 无循环依赖
123
+
124
+ **执行流程**:
125
+ 1. 2 位专家独立评审(DeepSeek-v4-pro + Kimi-K2.6)
126
+ 2. 单轮评审,无需多轮迭代
127
+ 3. **2/2 批准**才通过(不允许 1/2 批准)
128
+ 4. 评审通过后写入 `.sprint-state/delphi-reviewed.json`
129
+
130
+ **输出文件** (`.sprint-state/delphi-reviewed.json`):
131
+ ```json
132
+ {
133
+ "sprint_id": "sprint-2026-06-05-01",
134
+ "level": "轻量",
135
+ "delphi_review": {
136
+ "experts": ["deepseek-v4-pro", "kimi-k2.6"],
137
+ "rounds": 1,
138
+ "votes": {
139
+ "expert_a": "APPROVED",
140
+ "expert_b": "APPROVED"
141
+ },
142
+ "consensus": "2/2 APPROVED",
143
+ "timestamp": "2026-06-05T10:30:00Z"
144
+ },
145
+ "status": "passed"
146
+ }
147
+ ```
148
+
149
+ **强制升级条件**(轻量级触发):
150
+ - 任一专家 REQUEST_CHANGES → 升级至标准级
151
+ - 涉及公共 API → 升级至标准级
152
+ - 修改文件 > 5 或 LOC > 200 → 升级至标准级
153
+
154
+ ---
155
+
156
+ ## 标准级详细规则
157
+
158
+ **适用场景**:
159
+ - 常规功能开发
160
+ - 模块重构(不涉及架构变更)
161
+ - 中等规模改动(5-15 个文件、200-500 行改动)
162
+
163
+ **执行流程**:
164
+ 1. 2 位专家独立评审(Round 1)
165
+ 2. 如有 REQUEST_CHANGES,进入 Round 2(最多 2 轮)
166
+ 3. **2/2 批准**才通过
167
+ 4. 评审通过后写入 `.sprint-state/delphi-reviewed.json`
168
+
169
+ **升级至复杂级条件**:
170
+ - Round 2 仍有分歧(1 票反对)→ 升级至复杂级(第 3 专家仲裁)
171
+ - 涉及核心模块(core/handlers)→ 升级至复杂级
172
+ - 存在循环依赖 → 升级至复杂级
173
+
174
+ ---
175
+
176
+ ## 复杂级详细规则
177
+
178
+ **适用场景**:
179
+ - 核心模块开发
180
+ - 跨模块变更(≥ 3 个目录)
181
+ - 架构调整
182
+ - 公共 API 重大变更
183
+
184
+ **执行流程**:
185
+ 1. 3 位专家独立评审(DeepSeek-v4-pro + Kimi-K2.6 + Qwen3.6-Plus)
186
+ 2. 最多 3 轮评审(Round 1-3)
187
+ 3. **3/3 批准**才通过
188
+ 4. 评审通过后写入 `.sprint-state/delphi-reviewed.json`
189
+
190
+ **仲裁机制**:
191
+ - Round 2 仍有分歧 → 第 3 专家(Qwen3.6-Plus)加入仲裁
192
+ - Round 3 必须达成一致,否则 BLOCK 进入 Phase 2
193
+
194
+ ---
195
+
196
+ ## 参见
197
+
198
+ - [Phase -0.5: AUTO-ESTIMATE](../references/phase-minus-0-5-auto-estimate.md) — 规模评估与流程路由
199
+ - [Phase 0: THINK](../references/phase-0-think.md) — 需求探索与设计
200
+ - [Phase 1: PLAN](../references/phase-1-plan.md) — 计划与 Delphi 设计评审
201
+ - [Phase 2: BUILD](../references/phase-2-build.md) — 编码与 Ralph Loop
202
+ - [Phase 3: REVIEW](../references/phase-3-review.md) — 代码走查与验证
203
+ - [Delphi Review Skill](../../../../skills/delphi-review/SKILL.md) — 多专家共识评审规范