aodw-skill 0.7.3

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 (188) hide show
  1. package/.aodw/01-core/ai-interaction-rules.md +218 -0
  2. package/.aodw/01-core/ai-knowledge-rules.md +302 -0
  3. package/.aodw/01-core/ai-project-overview-rules.md +284 -0
  4. package/.aodw/01-core/aodw-constitution-summary.md +20 -0
  5. package/.aodw/01-core/aodw-constitution.md +419 -0
  6. package/.aodw/01-core/csf-thinking-framework.md +373 -0
  7. package/.aodw/01-core/git-discipline.md +226 -0
  8. package/.aodw/01-core/module-doc-rules.md +90 -0
  9. package/.aodw/02-workflow/aodw-development-stages.md +235 -0
  10. package/.aodw/02-workflow/rt-id-generation-rules.md +267 -0
  11. package/.aodw/02-workflow/rt-manager-summary.md +15 -0
  12. package/.aodw/02-workflow/rt-manager.md +399 -0
  13. package/.aodw/02-workflow/spec-full-profile-summary.md +13 -0
  14. package/.aodw/02-workflow/spec-full-profile.md +391 -0
  15. package/.aodw/02-workflow/spec-lite-profile.md +313 -0
  16. package/.aodw/02-workflow/ui-workflow-rules.md +334 -0
  17. package/.aodw/03-standards/ai-coding-rules-common.md +89 -0
  18. package/.aodw/03-standards/ai-coding-rules.md +370 -0
  19. package/.aodw/03-standards/stacks/java-springboot/ai-coding-rules-backend.md +100 -0
  20. package/.aodw/03-standards/stacks/python-fastapi/ai-coding-rules-backend.md +612 -0
  21. package/.aodw/03-standards/stacks/react-typescript/ai-coding-rules-frontend.md +291 -0
  22. package/.aodw/03-standards/stacks/vue2/ai-coding-rules-frontend.md +97 -0
  23. package/.aodw/03-standards/ui-kit/ui-kit.md +163 -0
  24. package/.aodw/04-auditors/aodw-development-auditor-rules.md +470 -0
  25. package/.aodw/04-auditors/aodw-full-auditor-rules.md +365 -0
  26. package/.aodw/04-auditors/aodw-requirement-auditor-rules.md +408 -0
  27. package/.aodw/05-tooling/ai-tools-init-rules.md +465 -0
  28. package/.aodw/06-project/ai-overview.md +116 -0
  29. package/.aodw/06-project/modules-index.yaml +11 -0
  30. package/.aodw/07-optimization/token-usage-analysis.md +253 -0
  31. package/.aodw/README.md +26 -0
  32. package/.aodw/RELEASE-CHECKLIST.md +144 -0
  33. package/.aodw/config.yaml +2 -0
  34. package/.aodw/manifest.yaml +98 -0
  35. package/.aodw/templates/SOURCE-TO-DISTRIBUTION-GUIDE.md +276 -0
  36. package/.aodw/templates/TEMPLATE-APPLICATION-GUIDE.md +246 -0
  37. package/.aodw/templates/aodw-kernel-loader-template.md +70 -0
  38. package/.aodw/templates/audit-report-template.md +232 -0
  39. package/.aodw/templates/changelog-template.md +16 -0
  40. package/.aodw/templates/checklists/coding-standards-template.md +110 -0
  41. package/.aodw/templates/csf-review-template.md +201 -0
  42. package/.aodw/templates/impact-template.md +17 -0
  43. package/.aodw/templates/invariants-template.md +12 -0
  44. package/.aodw/templates/module-readme-template.md +39 -0
  45. package/.aodw/templates/plan-lite-template.md +11 -0
  46. package/.aodw/templates/rt-decision-template.md +13 -0
  47. package/.aodw/templates/rt-intake-template.md +33 -0
  48. package/.aodw/templates/rt-meta-template.yaml +43 -0
  49. package/.aodw/templates/spec-lite-template.md +17 -0
  50. package/.aodw/templates/tests-template.md +13 -0
  51. package/.aodw/templates/tools-config/README.md +80 -0
  52. package/.aodw/templates/tools-config/backend/black.config.template.toml +6 -0
  53. package/.aodw/templates/tools-config/backend/pre-commit.config.template.yaml +16 -0
  54. package/.aodw/templates/tools-config/backend/ruff.config.template.toml +23 -0
  55. package/.aodw/templates/tools-config/frontend/eslint.config.template.json +113 -0
  56. package/.aodw/templates/tools-config/frontend/prettier.config.template.json +10 -0
  57. package/.aodw/templates/tools-config/frontend/tsconfig.paths.template.json +11 -0
  58. package/.aodw/workflow-guide.md +51 -0
  59. package/AODW_Adapters/README.md +143 -0
  60. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-check.md +7 -0
  61. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-done.md +7 -0
  62. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-full.md +7 -0
  63. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-governance.md +7 -0
  64. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-impact.md +7 -0
  65. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-init.md +7 -0
  66. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-invariants.md +7 -0
  67. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-lite.md +7 -0
  68. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-module.md +7 -0
  69. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-new.md +7 -0
  70. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-open.md +7 -0
  71. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-pause.md +7 -0
  72. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-resume.md +7 -0
  73. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-tests.md +7 -0
  74. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-upgrade.md +7 -0
  75. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw.md +35 -0
  76. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-check.md +16 -0
  77. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-done.md +16 -0
  78. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-full.md +14 -0
  79. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-governance.md +13 -0
  80. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-impact.md +13 -0
  81. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-init.md +13 -0
  82. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-invariants.md +13 -0
  83. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-lite.md +14 -0
  84. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-module.md +13 -0
  85. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-new.md +30 -0
  86. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-open.md +10 -0
  87. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-pause.md +12 -0
  88. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-resume.md +12 -0
  89. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-tests.md +13 -0
  90. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-upgrade.md +12 -0
  91. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw.md +18 -0
  92. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/claude/CLAUDE.md +17 -0
  93. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-check.md +30 -0
  94. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-done.md +52 -0
  95. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-full.md +31 -0
  96. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-governance.md +34 -0
  97. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-impact.md +25 -0
  98. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-init.md +75 -0
  99. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-invariants.md +29 -0
  100. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-lite.md +23 -0
  101. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-module.md +24 -0
  102. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-new.md +70 -0
  103. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-open.md +19 -0
  104. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-pause.md +19 -0
  105. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-resume.md +20 -0
  106. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-tests.md +26 -0
  107. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-upgrade.md +27 -0
  108. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw.md +69 -0
  109. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/deploypromote.md +20 -0
  110. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/featuretotester.md +32 -0
  111. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/deploy/feature_to_master_push_test_local.sh +390 -0
  112. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/deploy/promote_only.sh +210 -0
  113. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/deploy/rollback_prod.sh +99 -0
  114. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/rules/aodw.mdc +26 -0
  115. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-check.md +29 -0
  116. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-done.md +52 -0
  117. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-full.md +30 -0
  118. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-governance.md +33 -0
  119. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-impact.md +24 -0
  120. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-init.md +75 -0
  121. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-invariants.md +28 -0
  122. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-lite.md +22 -0
  123. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-module.md +23 -0
  124. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-new.md +92 -0
  125. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-open.md +18 -0
  126. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-pause.md +18 -0
  127. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-resume.md +19 -0
  128. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-tests.md +25 -0
  129. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-upgrade.md +26 -0
  130. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw.md +68 -0
  131. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/GEMINI.md +17 -0
  132. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/.agent/rules/aodw-analyze.md +15 -0
  133. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/.agent/rules/aodw-complete.md +15 -0
  134. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/.agent/rules/aodw-control.md +14 -0
  135. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/.agent/rules/aodw-decide.md +16 -0
  136. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/.agent/rules/aodw-governance.md +7 -0
  137. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/.agent/rules/aodw-implement.md +16 -0
  138. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/.agent/rules/aodw-init.md +7 -0
  139. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/.agent/rules/aodw-intake.md +15 -0
  140. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/.agent/rules/aodw-open.md +7 -0
  141. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/.agent/rules/aodw-simplified.md +107 -0
  142. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/.agent/rules/aodw-verify.md +14 -0
  143. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/global_workflows/aodw-analyze.md +24 -0
  144. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/global_workflows/aodw-complete.md +23 -0
  145. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/global_workflows/aodw-control.md +21 -0
  146. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/global_workflows/aodw-decide.md +26 -0
  147. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/global_workflows/aodw-governance.md +13 -0
  148. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/global_workflows/aodw-implement.md +21 -0
  149. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/global_workflows/aodw-init.md +13 -0
  150. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/global_workflows/aodw-intake.md +28 -0
  151. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/global_workflows/aodw-open.md +10 -0
  152. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/global_workflows/aodw-verify.md +20 -0
  153. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/global_workflows/aodw.md +18 -0
  154. package/AODW_Adapters/antigravity/.agent/rules/aodw.md +74 -0
  155. package/AODW_Adapters/claude/CLAUDE.md +70 -0
  156. package/AODW_Adapters/cursor/.cursor/commands/README.md +37 -0
  157. package/AODW_Adapters/cursor/.cursor/rules/aodw.mdc +77 -0
  158. package/AODW_Adapters/gemini/.agent/rules/aodw-analyze.md +15 -0
  159. package/AODW_Adapters/gemini/.agent/rules/aodw-complete.md +15 -0
  160. package/AODW_Adapters/gemini/.agent/rules/aodw-control.md +14 -0
  161. package/AODW_Adapters/gemini/.agent/rules/aodw-decide.md +16 -0
  162. package/AODW_Adapters/gemini/.agent/rules/aodw-governance.md +33 -0
  163. package/AODW_Adapters/gemini/.agent/rules/aodw-implement.md +16 -0
  164. package/AODW_Adapters/gemini/.agent/rules/aodw-init.md +75 -0
  165. package/AODW_Adapters/gemini/.agent/rules/aodw-intake.md +15 -0
  166. package/AODW_Adapters/gemini/.agent/rules/aodw-open.md +18 -0
  167. package/AODW_Adapters/gemini/.agent/rules/aodw-verify.md +14 -0
  168. package/AODW_Adapters/gemini/.agent/rules/aodw.md +70 -0
  169. package/AODW_Adapters/gemini/GEMINI.md +17 -0
  170. package/AODW_Adapters/general/.github/copilot-instructions.md +34 -0
  171. package/AODW_Adapters/general/AGENTS.md +70 -0
  172. package/README.md +118 -0
  173. package/bin/aodw.js +627 -0
  174. package/bin/commands/init-overview.js +801 -0
  175. package/bin/commands/init-tools.js +811 -0
  176. package/bin/commands/new.js +235 -0
  177. package/bin/commands/serve.js +79 -0
  178. package/bin/processors/index.js +109 -0
  179. package/bin/update-adapters-from-template.js +89 -0
  180. package/bin/utils/config.js +56 -0
  181. package/docs/README.md +26 -0
  182. package/docs/adapter-evaluation.md +55 -0
  183. package/docs/backend-guidelines.md +335 -0
  184. package/docs/frontend-guidelines.md +266 -0
  185. package/docs/installation-variants.md +88 -0
  186. package/docs/migration-guide-0.2.0.md +250 -0
  187. package/docs/platform-matrix.md +83 -0
  188. package/package.json +40 -0
@@ -0,0 +1,232 @@
1
+ # 需求阶段审计报告:RT-XXX - <title>
2
+
3
+ ## 审计元数据
4
+ - **审计时间**:YYYY-MM-DD HH:MM:SS(必须使用系统真实时间)
5
+ - **审计阶段**:intake / decision / spec / plan / impact / invariants
6
+ - **审计文档**:<文档名称>
7
+ - **审计人**:AODW 需求阶段审计官
8
+ - **RT 状态**:created / intaking / decided / in-progress
9
+
10
+ ---
11
+
12
+ ## 审计项跟踪表
13
+
14
+ | ID | 类型 | 严重程度 | 状态 | 描述 | 修复说明 | 修复时间 |
15
+ |----|------|---------|------|------|---------|---------|
16
+ | AUDIT-001 | 需求完整性 | Blocking | Open | [审计项描述] | - | - |
17
+ | AUDIT-002 | 需求一致性 | Critical | Fixed | [审计项描述] | [修复说明] | YYYY-MM-DD HH:MM:SS |
18
+
19
+ **状态说明**:
20
+ - **Open**:未修复
21
+ - **In-Progress**:修复中
22
+ - **Fixed**:已修复
23
+ - **Verified**:已验证修复
24
+
25
+ **严重程度说明**:
26
+ - **Blocking**:阻断性问题,必须修复后才能继续
27
+ - **Critical**:严重问题,强烈建议修复
28
+ - **Warning**:警告性问题,建议修复
29
+
30
+ ---
31
+
32
+ ## 审计结果详情
33
+
34
+ ### 1. 需求完整性缺陷(Requirement Completeness Issues)
35
+
36
+ 针对需求文档结构缺失、目标不明确、需求不可验证等问题。
37
+
38
+ #### 1.1 [缺陷类型:文档结构缺失]
39
+
40
+ **细节**:
41
+ - 您的 `spec.md` 中缺少"非功能需求"章节。
42
+
43
+ **疑问与挑战**:
44
+ - 如果性能、安全性、可用性等非功能需求未明确,您如何确保技术方案能够满足这些要求?
45
+
46
+ **修复建议**:
47
+ - 在 `spec.md` 中补充"非功能需求"章节,明确性能、安全性、可用性等要求。
48
+
49
+ ---
50
+
51
+ #### 1.2 [缺陷类型:需求不可验证]
52
+
53
+ **细节**:
54
+ - 您的功能需求 FR-001 描述为"提升用户体验",但未提供可验证的指标。
55
+
56
+ **疑问与挑战**:
57
+ - 请明确"提升用户体验"的具体指标(如:页面加载时间 < 2 秒、用户满意度 > 90%),否则无法验证需求是否达成。
58
+
59
+ **修复建议**:
60
+ - 将功能需求 FR-001 修改为可验证的描述,例如:"页面加载时间从当前 5 秒降低到 2 秒以内"。
61
+
62
+ ---
63
+
64
+ ### 2. 需求一致性缺陷(Requirement Consistency Issues)
65
+
66
+ 针对文档间矛盾、术语不一致、方案与需求不匹配等问题。
67
+
68
+ #### 2.1 [缺陷类型:文档间矛盾]
69
+
70
+ **细节**:
71
+ - 您的 `intake.md` 中描述的影响模块为 `user` 和 `order`,但 `spec.md` 中只提到了 `user` 模块。
72
+
73
+ **疑问与挑战**:
74
+ - 请明确 `order` 模块是否真的受影响,如果受影响,为什么 `spec.md` 中没有提及?如果不受影响,为什么 `intake.md` 中会列出?
75
+
76
+ **修复建议**:
77
+ - 检查 `order` 模块是否真的受影响,如果受影响,在 `spec.md` 中补充;如果不受影响,从 `intake.md` 中移除。
78
+
79
+ ---
80
+
81
+ #### 2.2 [缺陷类型:方案与需求不匹配]
82
+
83
+ **细节**:
84
+ - 您的 `spec.md` 中要求"支持批量导入",但 `plan.md` 中的技术方案只实现了单条导入。
85
+
86
+ **疑问与挑战**:
87
+ - 请说明技术方案如何满足批量导入的需求,或者修改 `spec.md` 移除批量导入的要求。
88
+
89
+ **修复建议**:
90
+ - 如果确实需要批量导入,在 `plan.md` 中补充批量导入的技术方案;如果不需要,从 `spec.md` 中移除批量导入的要求。
91
+
92
+ ---
93
+
94
+ ### 3. 需求可执行性缺陷(Requirement Executability Issues)
95
+
96
+ 针对技术方案不完整、代码结构不明确、技术风险未识别等问题。
97
+
98
+ #### 3.1 [缺陷类型:技术方案不完整]
99
+
100
+ **细节**:
101
+ - 您的 `plan.md` 中提到了"新增 API 路由",但未明确具体的文件路径和函数名称。
102
+
103
+ **疑问与挑战**:
104
+ - 请明确 API 路由的具体路径(如:`app/api/v1/users.py`)和函数名称(如:`create_user`),否则无法执行开发。
105
+
106
+ **修复建议**:
107
+ - 在 `plan.md` 中补充具体的文件路径和函数名称,例如:
108
+ - 文件路径:`app/api/v1/users.py`
109
+ - 函数名称:`create_user`
110
+ - 路由路径:`POST /api/v1/users`
111
+
112
+ ---
113
+
114
+ #### 3.2 [缺陷类型:代码结构不符合规范]
115
+
116
+ **细节**:
117
+ - 您的 `plan.md` 中设计的代码结构显示,API 层直接导入了 `models`,违反了后端分层架构的依赖倒置原则。
118
+
119
+ **疑问与挑战**:
120
+ - 这种设计明确违反了后端分层架构的**不可破坏原则**,您是否计划在 `invariants.md` 中记录打破此约束的理由,并将其升级为 Spec-Full 流程?
121
+
122
+ **修复建议**:
123
+ - 修改 `plan.md` 中的代码结构,确保符合后端分层架构规范(api → services → repositories)。
124
+ - 如果确实需要打破约束,在 `invariants.md` 中记录理由,并考虑升级为 Spec-Full 流程。
125
+
126
+ ---
127
+
128
+ ### 4. 战略漏洞与 CSF 检查失败(Strategic Gaps & CSF Failures)
129
+
130
+ 针对方案在目标对齐、结构化分解和决策客观性方面的缺失。
131
+
132
+ #### 4.1 [战略漏洞:以终为始失效]
133
+
134
+ **细节**:
135
+ - 您的方案侧重于实现技术细节,但未能明确说明本次 RT 如何直接缩小 **[当前现状]** 与 **[期望状态]** 之间的核心差距。
136
+
137
+ **疑问与挑战**:
138
+ - 请指出方案中的 **哪 1-2 个步骤** 属于无效工作(不贡献于目标的工作),并说明其移除后对目标达成的影响。
139
+
140
+ **修复建议**:
141
+ - 在 `plan.md` 中补充"目标对齐分析"章节,明确说明每个步骤如何贡献于 RT 目标。
142
+ - 识别并移除无效工作。
143
+
144
+ ---
145
+
146
+ #### 4.2 [分解缺陷:MECE 验证失败]
147
+
148
+ **细节**:
149
+ - 您对 [关键流程/模块] 的分解似乎存在 **[重叠/遗漏]** 的风险。
150
+
151
+ **疑问与挑战**:
152
+ - 请使用**静态分解(组成部分)**和**动态分解(流程步骤)**两种视角,重新验证方案是否符合 **不重不漏(MECE)原则**。
153
+
154
+ **修复建议**:
155
+ - 在 `plan.md` 中补充"分解结构验证"章节,使用静态分解和动态分解两种视角验证 MECE 原则。
156
+
157
+ ---
158
+
159
+ #### 4.3 [决策缺陷:多维评估不足]
160
+
161
+ **细节**:
162
+ - 您仅提出了一个方案(方案 A)或仅从单一维度(例如"性能")证明其优越性,未能进行 **多维决策矩阵评估**。
163
+
164
+ **疑问与挑战**:
165
+ - 请补充一个**备选方案 B**(例如使用不同的技术栈或更简化的 Lite 方案),并使用至少 **复杂度、风险、可维护性** 三个维度进行对比,以证明当前方案 A 是客观最优解。
166
+
167
+ **修复建议**:
168
+ - 在 `plan.md` 中补充"方案对比分析"章节,包含至少 2-3 个备选方案,并使用多维度评估矩阵进行对比。
169
+
170
+ ---
171
+
172
+ ## 综合评估
173
+
174
+ ### 关键发现总结
175
+ 1. [发现 1]
176
+ 2. [发现 2]
177
+ 3. [发现 3]
178
+
179
+ ### 阻断性问题(Blocking Issues)
180
+ - [ ] [阻断性问题 1]:必须修复后才能继续
181
+ - [ ] [阻断性问题 2]:必须修复后才能继续
182
+
183
+ ### 审计结论
184
+ - [ ] **通过**:需求文档完整、一致、可执行,可以继续
185
+ - [ ] **有条件通过**:存在非阻断性问题,建议修复后继续
186
+ - [ ] **不通过**:存在阻断性问题,必须修复后才能继续
187
+
188
+ **结论说明**:[说明审计结论的理由]
189
+
190
+ ---
191
+
192
+ ## 后续行动
193
+
194
+ ### 需要修复的问题
195
+ - [ ] [问题 1]
196
+ - [ ] [问题 2]
197
+
198
+ ### 需要补充的内容
199
+ - [ ] [补充项 1]
200
+ - [ ] [补充项 2]
201
+
202
+ ### 需要用户确认的事项
203
+ - [ ] [确认项 1]
204
+ - [ ] [确认项 2]
205
+
206
+ ---
207
+
208
+ ## 历史审计记录
209
+
210
+ ### 审计记录 #1(YYYY-MM-DD HH:MM:SS)
211
+ - **审计文档**:`intake.md`
212
+ - **审计结论**:不通过
213
+ - **主要问题**:[问题摘要]
214
+ - **修复状态**:已修复 / 未修复
215
+
216
+ ### 审计记录 #2(YYYY-MM-DD HH:MM:SS)
217
+ - **审计文档**:`spec.md`
218
+ - **审计结论**:有条件通过
219
+ - **主要问题**:[问题摘要]
220
+ - **修复状态**:已修复 / 未修复
221
+
222
+ ---
223
+
224
+ ## 附录:CSF 审查结果(如执行)
225
+
226
+ ### CSF 审查摘要
227
+ - **审查时间**:YYYY-MM-DD HH:MM:SS
228
+ - **审查结论**:通过 / 有条件通过 / 不通过
229
+ - **关键发现**:[CSF 审查的关键发现]
230
+
231
+ ### CSF 审查详情
232
+ 详见:`RT/RT-XXX/csf-review.md`(如单独执行了 CSF Review)
@@ -0,0 +1,16 @@
1
+ # Changelog: RT-XXX - <short title>
2
+
3
+ ## 1. 变更摘要(Summary)
4
+ - 概述本次改动对系统行为带来的变化:
5
+
6
+ ## 2. 用户可感知变化(User-visible Changes)
7
+ - UI / 文案 / 流程的变更:
8
+
9
+ ## 3. 不可见但重要的变化(Non-visible but Important)
10
+ - 内部逻辑重构:
11
+ - 性能 / 稳定性提升:
12
+ - 错误处理方式的变化:
13
+
14
+ ## 4. 与其他 RT / 模块的关系
15
+ - 依赖的其他 RT:
16
+ - 未来跟进的 RT:
@@ -0,0 +1,110 @@
1
+ # 编码规范验收清单
2
+
3
+ > **注意**:本清单用于检查代码是否符合项目编码规范(`.aodw/03-standards/stacks/react-typescript/ai-coding-rules-frontend.md` 和 `.aodw/03-standards/stacks/python-fastapi/ai-coding-rules-backend.md`)。
4
+
5
+ ---
6
+
7
+ ## 前端编码规范验收(如涉及)
8
+
9
+ ### 工具检查
10
+ - [ ] ESLint 检查全部通过(`npm run lint` 或 `npx eslint .`)
11
+ - [ ] Prettier 格式化已运行(`npm run format` 或 `npx prettier --write .`)
12
+ - [ ] 工具初始化状态正常(检查 `.aodw/tools-status.yaml`)
13
+
14
+ ### 目录结构检查
15
+ - [ ] 目录结构符合规范(pages / features / shared)
16
+ - [ ] 页面放在 `src/pages/<PageName>/` 下
17
+ - [ ] 可复用业务逻辑放在 `src/features/<domain>/` 下
18
+ - [ ] 通用组件/hooks/工具放在 `src/shared/` 下
19
+ - [ ] 依赖关系符合规范(pages → features/shared, features → shared)
20
+
21
+ ### 代码质量检查
22
+ - [ ] 文件大小符合规范:
23
+ - [ ] 页面入口组件(index.tsx)≤ 300 行
24
+ - [ ] 普通组件/hooks/store 文件 ≤ 200 行
25
+ - [ ] 函数大小符合规范:
26
+ - [ ] 单个函数 ≤ 60 行
27
+ - [ ] 复杂度符合规范:
28
+ - [ ] 复杂度 ≤ 10
29
+
30
+ ### TypeScript 规范检查
31
+ - [ ] 是否启用严格模式
32
+ - [ ] 是否避免使用 any
33
+ - [ ] API 层是否使用 DTO 类型和 Response 类型
34
+
35
+ ### React 编码规范检查
36
+ - [ ] 是否使用函数组件 + Hooks
37
+ - [ ] 数据请求是否封装在 features/*/api 或页面专用 hooks
38
+ - [ ] 是否不在组件中直接调用 fetch/axios
39
+
40
+ ---
41
+
42
+ ## 后端编码规范验收(如涉及)
43
+
44
+ ### 依赖管理检查
45
+ - [ ] 使用 `uv + pip-tools` 管理依赖
46
+ - [ ] 存在 `requirements.in` 和 `requirements-dev.in` 文件
47
+ - [ ] 只编辑 `.in` 文件,不直接编辑 `.txt` 文件
48
+ - [ ] 添加依赖时使用版本约束(如 `package>=1.0.0,<2.0.0`)
49
+ - [ ] 通过 `make compile-deps && make sync` 更新依赖
50
+
51
+ ### 工具检查
52
+ - [ ] Ruff 检查全部通过(`ruff check .`)
53
+ - [ ] Black 格式化已运行(`black .`)
54
+ - [ ] pre-commit hooks 已安装(如适用)
55
+ - [ ] 工具初始化状态正常(检查 `.aodw/tools-status.yaml`)
56
+
57
+ ### 分层架构检查
58
+ - [ ] 分层架构符合规范(api → services → repositories)
59
+ - [ ] API 层未直接导入 models(如适用)
60
+ - [ ] Services 层未直接导入 api
61
+ - [ ] 依赖关系符合规范(不跨层调用)
62
+
63
+ ### 代码质量检查
64
+ - [ ] 文件大小符合规范:
65
+ - [ ] Python 模块 ≤ 300 行(Ruff 自动检查)
66
+ - [ ] 函数大小符合规范:
67
+ - [ ] 单个函数 ≤ 60 行(Ruff PLR0915 自动拦截)
68
+ - [ ] 复杂度符合规范:
69
+ - [ ] 复杂度 ≤ 10(Ruff PLR 规则自动检查)
70
+
71
+ ### API 设计检查
72
+ - [ ] API 端点是否符合 RESTful 规范
73
+ - [ ] 请求/响应格式是否统一
74
+ - [ ] 错误处理是否完善
75
+
76
+ ### 安全检查
77
+ - [ ] 输入数据是否已验证
78
+ - [ ] 是否防止 SQL 注入、XSS 等安全漏洞
79
+ - [ ] 认证和授权是否正确实现
80
+
81
+ ---
82
+
83
+ ## 通用编码规范验收
84
+
85
+ ### 文件大小检查
86
+ - [ ] 文件大小符合规范(参考 `.aodw/03-standards/ai-coding-rules-common.md`)
87
+
88
+ ### 函数/方法长度检查
89
+ - [ ] 函数/方法长度符合规范
90
+
91
+ ### 复杂度检查
92
+ - [ ] 复杂度符合规范
93
+
94
+ ### 命名规范检查
95
+ - [ ] 命名规范符合要求(参考具体编码规范文件)
96
+
97
+ ---
98
+
99
+ ## 验收结果
100
+
101
+ - [ ] 所有检查项已通过
102
+ - [ ] 如有未通过项,已记录原因并说明:
103
+ - 未通过项:
104
+ - 原因说明:
105
+ - 后续处理计划:
106
+
107
+ ---
108
+
109
+ **验收人**:_________________
110
+ **验收日期**:_________________
@@ -0,0 +1,201 @@
1
+ # CSF Review: RT-XXX - <title>
2
+
3
+ ## 审查元数据
4
+ - **审查时间**:YYYY-MM-DD HH:MM:SS
5
+ - **审查阶段**:Decision / Spec-Plan / Implementation / Verification
6
+ - **审查类型**:快速审查 / 深度审查
7
+ - **审查人**:AI + 用户(如参与)
8
+ - **RT 状态**:created / intaking / decided / in-progress / reviewing
9
+
10
+ ---
11
+
12
+ ## 1. 以终为始检查(Begin with the End)
13
+
14
+ ### 1.1 目标定义
15
+ - **明确目标**:[用一句话描述本 RT 的目标]
16
+ - **当前现状**:[描述当前存在的问题/痛点/缺失]
17
+ - **期望状态**:[描述成功后的期望状态]
18
+ - **差距分析**:[现状与期望的差距是什么?]
19
+
20
+ ### 1.2 目标贡献度评估
21
+ - [ ] 当前工作是否直接贡献于缩小差距?
22
+ - [ ] 是否存在无效工作?(不贡献于目标的工作)
23
+ - 无效工作列表:[如有,列出]
24
+ - [ ] 目标是否可衡量?(有明确的成功标准)
25
+
26
+ ### 1.3 发现与建议
27
+ - **关键发现**:[记录发现的问题]
28
+ - **改进建议**:[如有无效工作,建议如何调整]
29
+
30
+ ---
31
+
32
+ ## 2. 结构化分解检查(Structured Decomposition)
33
+
34
+ ### 2.1 分解结构
35
+ - **静态分解**(组成部分):
36
+ ```
37
+ [用树状图或列表展示组成部分]
38
+ ```
39
+
40
+ - **动态分解**(流程步骤):
41
+ ```
42
+ [用流程图或列表展示流程步骤]
43
+ ```
44
+
45
+ ### 2.2 MECE 验证
46
+ - [ ] 分解是否符合 MECE 原则?(不重不漏)
47
+ - [ ] 分解粒度是否合适?(不过细也不过粗)
48
+ - [ ] 子目标/子模块之间是否存在重叠?
49
+ - [ ] 是否存在遗漏的关键部分?
50
+
51
+ ### 2.3 依赖关系
52
+ - **依赖关系图**:[描述或绘制依赖关系]
53
+ - **关键依赖**:[标注关键依赖,如存在单点故障]
54
+
55
+ ### 2.4 发现与建议
56
+ - **关键发现**:[记录发现的问题]
57
+ - **改进建议**:[如有 MECE 问题或依赖问题,建议如何调整]
58
+
59
+ ---
60
+
61
+ ## 3. 关键要素识别检查(Identify CSFs)
62
+
63
+ ### 3.1 关键成功要素(CSF)清单
64
+ | 优先级 | CSF 描述 | 影响程度 | 当前状态 |
65
+ |--------|----------|----------|----------|
66
+ | P0 | [CSF 1] | 高/中/低 | 已识别/未识别 |
67
+ | P1 | [CSF 2] | 高/中/低 | 已识别/未识别 |
68
+ | P2 | [CSF 3] | 高/中/低 | 已识别/未识别 |
69
+
70
+ ### 3.2 关键控制变量
71
+ - **控制变量列表**:[列出可以影响结果的关键变量]
72
+ - **变量影响分析**:[分析各变量的影响程度]
73
+
74
+ ### 3.3 瓶颈识别
75
+ - **瓶颈点列表**:[列出限制目标达成的关键点]
76
+ - **瓶颈影响分析**:[分析各瓶颈的影响程度]
77
+
78
+ ### 3.4 资源分配评估
79
+ - [ ] 是否聚焦于 CSF?(而非平均分配资源)
80
+ - [ ] 关键控制变量是否已识别并监控?
81
+ - [ ] 瓶颈点是否有缓解策略?
82
+
83
+ ### 3.5 发现与建议
84
+ - **关键发现**:[记录发现的问题]
85
+ - **改进建议**:[如有资源分配问题,建议如何调整]
86
+
87
+ ---
88
+
89
+ ## 4. 流程与系统观检查(Process & Systems View)
90
+
91
+ ### 4.1 端到端流程分析
92
+ - **流程图**:[描述或引用端到端流程图]
93
+ - **关键路径**:[标注从触发到完成的关键路径]
94
+ - **路径长度**:[估算关键路径的时间/复杂度]
95
+
96
+ ### 4.2 瓶颈识别
97
+ - **流程瓶颈**:[标注流程中的瓶颈点]
98
+ - **瓶颈影响**:[分析瓶颈对整体流程的影响]
99
+
100
+ ### 4.3 系统交互分析
101
+ - **组件交互图**:[描述系统各组件之间的交互]
102
+ - **单点故障**:[识别是否存在单点故障]
103
+ - **上下游影响**:[分析对上下游系统的影响]
104
+
105
+ ### 4.4 发现与建议
106
+ - **关键发现**:[记录发现的问题]
107
+ - **改进建议**:[如有流程或系统问题,建议如何调整]
108
+
109
+ ---
110
+
111
+ ## 5. 多维决策检查(Multi-dimensional Decision)
112
+
113
+ ### 5.1 评估维度
114
+ - **维度列表**:[列出评估维度,如:性能、成本、复杂度、可维护性、风险、时间等]
115
+
116
+ ### 5.2 评估矩阵
117
+ | 方案 | 维度1 | 维度2 | 维度3 | 维度4 | 维度5 | 总分 | 排名 |
118
+ |------|-------|-------|-------|-------|-------|------|------|
119
+ | 方案A | 评分 | 评分 | 评分 | 评分 | 评分 | 总分 | 1 |
120
+ | 方案B | 评分 | 评分 | 评分 | 评分 | 评分 | 总分 | 2 |
121
+ | 方案C | 评分 | 评分 | 评分 | 评分 | 评分 | 总分 | 3 |
122
+
123
+ **权重说明**:[说明各维度的权重分配理由]
124
+
125
+ ### 5.3 决策标准
126
+ - **决策标准**:[明确说明决策标准]
127
+ - **最终决策**:[记录最终选择的方案]
128
+ - **决策理由**:[说明选择该方案的理由]
129
+
130
+ ### 5.4 备选方案评估
131
+ - [ ] 备选方案是否充分?
132
+ - [ ] 是否进行了多维度评估?(而非非黑即白)
133
+ - [ ] 各维度权重是否合理?
134
+
135
+ ### 5.5 发现与建议
136
+ - **关键发现**:[记录发现的问题]
137
+ - **改进建议**:[如有决策问题,建议如何调整]
138
+
139
+ ---
140
+
141
+ ## 6. 综合评估
142
+
143
+ ### 6.1 关键发现总结
144
+ 1. [发现 1]
145
+ 2. [发现 2]
146
+ 3. [发现 3]
147
+
148
+ ### 6.2 风险点识别
149
+ | 风险 | 影响程度 | 可能性 | 缓解策略 |
150
+ |------|----------|--------|----------|
151
+ | 风险1 | 高/中/低 | 高/中/低 | [缓解策略] |
152
+ | 风险2 | 高/中/低 | 高/中/低 | [缓解策略] |
153
+
154
+ ### 6.3 改进建议
155
+ 1. [建议 1]
156
+ 2. [建议 2]
157
+ 3. [建议 3]
158
+
159
+ ### 6.4 审查结论
160
+ - [ ] **通过**:当前方向正确,可以继续
161
+ - [ ] **有条件通过**:需要调整后继续
162
+ - [ ] **不通过**:需要重新审视方向
163
+
164
+ **结论说明**:[说明审查结论的理由]
165
+
166
+ ---
167
+
168
+ ## 7. 后续行动
169
+
170
+ ### 7.1 需要调整的方向
171
+ - [ ] [调整项 1]
172
+ - [ ] [调整项 2]
173
+
174
+ ### 7.2 需要补充的工作
175
+ - [ ] [补充项 1]
176
+ - [ ] [补充项 2]
177
+
178
+ ### 7.3 需要用户确认的事项
179
+ - [ ] [确认项 1]
180
+ - [ ] [确认项 2]
181
+
182
+ ### 7.4 下次审查计划
183
+ - **下次审查时间**:[如需要,计划下次审查时间]
184
+ - **审查重点**:[如需要,说明下次审查的重点]
185
+
186
+ ---
187
+
188
+ ## 8. 审查记录
189
+
190
+ ### 8.1 审查过程
191
+ - **审查步骤**:[记录审查的执行步骤]
192
+ - **审查耗时**:[记录审查耗时]
193
+
194
+ ### 8.2 用户反馈
195
+ - **用户意见**:[记录用户的反馈意见]
196
+ - **用户决策**:[记录用户的最终决策]
197
+
198
+ ### 8.3 审查历史
199
+ - **上次审查时间**:[如有,记录上次审查时间]
200
+ - **上次审查结论**:[如有,记录上次审查结论]
201
+ - **本次改进**:[如有,说明本次相比上次的改进]
@@ -0,0 +1,17 @@
1
+ # Impact Analysis: RT-XXX - <short title>
2
+
3
+ ## 1. 问题触发点(Trigger)
4
+ - 描述用户或系统如何触发问题:
5
+
6
+ ## 2. 直接影响(Direct Impact)
7
+ - 受影响的模块 / 文件:
8
+ - 直接受影响的行为:
9
+
10
+ ## 3. 间接影响(Indirect Impact)
11
+ - 可能受影响的上下游模块 / 功能:
12
+
13
+ ## 4. 风险评估(Risk Evaluation)
14
+ - 数据风险:
15
+ - 安全风险:
16
+ - 性能风险:
17
+ - 用户体验风险:
@@ -0,0 +1,12 @@
1
+ # Invariants: RT-XXX - <short title>
2
+
3
+ > 本文件列出在本次改动中必须保持不变的行为与约束。
4
+
5
+ ## 1. 业务行为 Invariants
6
+ - 不改变的业务规则:
7
+
8
+ ## 2. 接口 Invariants
9
+ - 不改变的 API 路径 / 请求 / 响应格式:
10
+
11
+ ## 3. 技术结构 Invariants
12
+ - 不允许破坏的工程结构约束(如不得跨层访问):
@@ -0,0 +1,39 @@
1
+ ---
2
+ module: <module-key>
3
+ files:
4
+ - <path/glob/to/code>
5
+ related_rts: []
6
+ ---
7
+
8
+ # <模块名称>
9
+
10
+ ## 1. 职责(Responsibilities)
11
+ - 核心职责:
12
+ - 解决的问题域:
13
+
14
+ ## 2. 目录映射(Files / Mapping)
15
+ - 关键文件 / 目录:
16
+ - <path 1>
17
+ - <path 2>
18
+ - 如有需要,补充 frontmatter 中的 files 列表,保持与实际代码路径一致。
19
+
20
+ ## 3. 不可破坏原则(Invariants)
21
+ - 业务行为:
22
+ - API / 接口:
23
+ - 数据结构与存储:
24
+ - 性能 / 安全约束:
25
+
26
+ ## 4. 依赖关系(Dependencies)
27
+ ### 上游(依赖的模块 / 服务)
28
+ - <module-a>
29
+
30
+ ### 下游(被依赖的模块 / 服务)
31
+ - <module-b>
32
+
33
+ ## 5. 常见流程(Workflows)
34
+ - 典型流程 1:<描述关键步骤与入口/出口>
35
+ - 典型流程 2:
36
+
37
+ ## 6. 历史记录(History / related_rts)
38
+ - RT-XXX:<变更摘要>
39
+ - RT-YYY:
@@ -0,0 +1,11 @@
1
+ # Plan-Lite: RT-XXX - <short title>
2
+
3
+ ## 1. 修改点(Change Points)
4
+ - 计划修改的文件 / 模块列表:
5
+
6
+ ## 2. 方案描述(Solution Outline)
7
+ - 拟采取的技术方案:
8
+
9
+ ## 3. 风险与注意事项(Risks & Caveats)
10
+ - 潜在风险:
11
+ - 需要注意的边界情形:
@@ -0,0 +1,13 @@
1
+ # RT Decision - RT-XXX
2
+
3
+ ## 1. 流程选择(Chosen Profile)
4
+ - 选用:Spec-Full / Spec-Lite
5
+ - AI 推荐理由:
6
+ - 用户最终选择:
7
+
8
+ ## 2. 备选方案(Alternatives)
9
+ - 其他可行流程及未采用原因:
10
+
11
+ ## 3. 分支与目录
12
+ - 计划分支名:feature/RT-XXX-short-name
13
+ - 目录:RT/RT-XXX/
@@ -0,0 +1,33 @@
1
+ # RT Intake - RT-XXX
2
+
3
+ ## 1. 原始描述(Raw Description)
4
+ - 用户原话:
5
+
6
+ ## 2. 类型与范围(Type & Scope)
7
+ - 类型(Feature / Bug / Enhancement / Refactor / Research / Other):
8
+ - 预估影响范围:
9
+
10
+ ## 3. 初步模块猜测(Initial Modules)
11
+ - 可能涉及的模块:
12
+
13
+ ## 4. 风险评估(Initial Risk)
14
+ - 低 / 中 / 高,简要理由:
15
+
16
+ ## 5. AI 问题与用户回答摘要(Q&A Summary)
17
+ - Q1: ...
18
+ - 用户回答:
19
+ - Q2: ...
20
+ - 用户回答:
21
+
22
+ ## 6. 相关技术约束 / 规范(可选)
23
+ > **注意**:AI 根据需求内容判断是否涉及前端/后端开发,如涉及则填写本节。
24
+
25
+ - **是否涉及前端开发**?
26
+ - [ ] 是 → 参考 `.aodw/03-standards/stacks/react-typescript/ai-coding-rules-frontend.md`
27
+ - [ ] 否
28
+ - **是否涉及后端开发**?
29
+ - [ ] 是 → 参考 `.aodw/03-standards/stacks/python-fastapi/ai-coding-rules-backend.md`
30
+ - [ ] 否
31
+ - **技术栈要求**(如已知):
32
+ - 前端:[React / Vue / Angular 等]
33
+ - 后端:[Python / Node.js / Go 等]