aodw-skill 0.7.13 → 0.7.17

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 (127) hide show
  1. package/.aodw-next/01-core/ai-interaction-rules-summary.md +37 -0
  2. package/.aodw-next/01-core/ai-interaction-rules.md +20 -6
  3. package/.aodw-next/01-core/ai-knowledge-rules-summary.md +25 -0
  4. package/.aodw-next/01-core/ai-knowledge-rules.md +19 -21
  5. package/.aodw-next/01-core/ai-project-overview-rules.md +11 -11
  6. package/.aodw-next/01-core/aodw-constitution.md +7 -414
  7. package/.aodw-next/01-core/csf-thinking-framework.md +14 -14
  8. package/.aodw-next/01-core/git-discipline-summary.md +36 -0
  9. package/.aodw-next/01-core/git-discipline.md +129 -73
  10. package/.aodw-next/01-core/module-doc-rules.md +2 -2
  11. package/.aodw-next/02-workflow/rt-id-generation-rules.md +16 -259
  12. package/.aodw-next/02-workflow/rt-manager-summary.md +1 -1
  13. package/.aodw-next/02-workflow/rt-manager.md +73 -344
  14. package/.aodw-next/02-workflow/spec-full-profile.md +149 -307
  15. package/.aodw-next/02-workflow/spec-lite-profile.md +170 -253
  16. package/.aodw-next/02-workflow/ui-workflow-rules-summary.md +39 -0
  17. package/.aodw-next/02-workflow/ui-workflow-rules.md +57 -292
  18. package/.aodw-next/03-standards/ai-coding-rules-common.md +1 -1
  19. package/.aodw-next/03-standards/ai-coding-rules.md +91 -25
  20. package/.aodw-next/03-standards/stacks/java-springboot/ai-coding-rules-backend.md +9 -9
  21. package/.aodw-next/03-standards/stacks/python-fastapi/ai-coding-rules-backend.md +13 -13
  22. package/.aodw-next/03-standards/stacks/react-typescript/ai-coding-rules-frontend.md +10 -10
  23. package/.aodw-next/03-standards/stacks/rust-axum/ai-coding-rules-backend.md +4 -4
  24. package/.aodw-next/03-standards/stacks/vue2/ai-coding-rules-frontend.md +9 -9
  25. package/.aodw-next/04-auditors/aodw-development-auditor-rules.md +15 -10
  26. package/.aodw-next/04-auditors/aodw-full-auditor-rules.md +14 -14
  27. package/.aodw-next/04-auditors/aodw-requirement-auditor-rules.md +130 -338
  28. package/.aodw-next/05-tooling/ai-tools-init-rules.md +74 -367
  29. package/.aodw-next/06-project/README.md +16 -0
  30. package/.aodw-next/07-optimization/token-usage-analysis.md +2 -2
  31. package/.aodw-next/README.md +53 -20
  32. package/.aodw-next/SKILL.md +32 -0
  33. package/.aodw-next/config.yaml +2 -2
  34. package/.aodw-next/manifest.yaml +64 -57
  35. package/.aodw-next/project.yaml +1 -0
  36. package/.aodw-next/templates/TEMPLATE-APPLICATION-GUIDE.md +21 -157
  37. package/.aodw-next/templates/ai-overview.template.md +72 -0
  38. package/.aodw-next/templates/aodw-kernel-loader-template.md +19 -19
  39. package/.aodw-next/templates/checklists/coding-standards-template.md +24 -4
  40. package/.aodw-next/templates/modules-index.template.yaml +13 -0
  41. package/.aodw-next/templates/plan-lite-template.md +9 -0
  42. package/.aodw-next/templates/rt-intake-template.md +2 -2
  43. package/.aodw-next/templates/rt-meta-template.yaml +2 -2
  44. package/.aodw-next/templates/spec-lite-template.md +9 -0
  45. package/.aodw-next/templates/tools-config/README.md +1 -1
  46. package/.aodw-next/templates/tools-config/backend/clippy.config.template.toml +5 -0
  47. package/.aodw-next/templates/tools-config/backend/rustfmt.config.template.toml +4 -0
  48. package/.aodw-next/tools-status.yaml +51 -0
  49. package/AODW_Adapters/antigravity/.agent/rules/aodw-next.md +2 -2
  50. package/AODW_Adapters/claude/CLAUDE.md +2 -2
  51. package/AODW_Adapters/cursor/.cursor/rules/aodw-next.mdc +2 -2
  52. package/AODW_Adapters/gemini/.agent/rules/aodw-next.md +2 -2
  53. package/AODW_Adapters/gemini/GEMINI.md +6 -5
  54. package/AODW_Adapters/general/AGENTS.md +2 -2
  55. package/README.md +62 -45
  56. package/bin/aodw.js +44 -16
  57. package/bin/commands/init-overview.js +3 -3
  58. package/bin/commands/init-tools.js +34 -51
  59. package/bin/utils/config.js +1 -1
  60. package/package.json +1 -1
  61. package/.aodw-next/.aodw-next/01-core/ai-interaction-rules.md +0 -218
  62. package/.aodw-next/.aodw-next/01-core/ai-knowledge-rules.md +0 -302
  63. package/.aodw-next/.aodw-next/01-core/ai-project-overview-rules.md +0 -284
  64. package/.aodw-next/.aodw-next/01-core/aodw-constitution-summary.md +0 -20
  65. package/.aodw-next/.aodw-next/01-core/aodw-constitution.md +0 -419
  66. package/.aodw-next/.aodw-next/01-core/csf-thinking-framework.md +0 -373
  67. package/.aodw-next/.aodw-next/01-core/git-discipline.md +0 -226
  68. package/.aodw-next/.aodw-next/01-core/module-doc-rules.md +0 -90
  69. package/.aodw-next/.aodw-next/02-workflow/aodw-development-stages.md +0 -235
  70. package/.aodw-next/.aodw-next/02-workflow/rt-id-generation-rules.md +0 -267
  71. package/.aodw-next/.aodw-next/02-workflow/rt-manager-summary.md +0 -15
  72. package/.aodw-next/.aodw-next/02-workflow/rt-manager.md +0 -399
  73. package/.aodw-next/.aodw-next/02-workflow/spec-full-profile-summary.md +0 -13
  74. package/.aodw-next/.aodw-next/02-workflow/spec-full-profile.md +0 -391
  75. package/.aodw-next/.aodw-next/02-workflow/spec-lite-profile.md +0 -313
  76. package/.aodw-next/.aodw-next/02-workflow/ui-workflow-rules.md +0 -334
  77. package/.aodw-next/.aodw-next/03-standards/ai-coding-rules-common.md +0 -89
  78. package/.aodw-next/.aodw-next/03-standards/ai-coding-rules.md +0 -370
  79. package/.aodw-next/.aodw-next/03-standards/stacks/java-springboot/ai-coding-rules-backend.md +0 -231
  80. package/.aodw-next/.aodw-next/03-standards/stacks/python-fastapi/ai-coding-rules-backend.md +0 -612
  81. package/.aodw-next/.aodw-next/03-standards/stacks/react-typescript/ai-coding-rules-frontend.md +0 -291
  82. package/.aodw-next/.aodw-next/03-standards/stacks/rust-axum/ai-coding-rules-backend.md +0 -134
  83. package/.aodw-next/.aodw-next/03-standards/stacks/vue2/ai-coding-rules-frontend.md +0 -220
  84. package/.aodw-next/.aodw-next/03-standards/ui-kit/ui-kit.md +0 -163
  85. package/.aodw-next/.aodw-next/04-auditors/aodw-development-auditor-rules.md +0 -470
  86. package/.aodw-next/.aodw-next/04-auditors/aodw-full-auditor-rules.md +0 -365
  87. package/.aodw-next/.aodw-next/04-auditors/aodw-requirement-auditor-rules.md +0 -408
  88. package/.aodw-next/.aodw-next/05-tooling/ai-tools-init-rules.md +0 -676
  89. package/.aodw-next/.aodw-next/06-project/ai-overview.md +0 -116
  90. package/.aodw-next/.aodw-next/06-project/modules-index.yaml +0 -11
  91. package/.aodw-next/.aodw-next/07-optimization/token-usage-analysis.md +0 -253
  92. package/.aodw-next/.aodw-next/README.md +0 -26
  93. package/.aodw-next/.aodw-next/RELEASE-CHECKLIST.md +0 -144
  94. package/.aodw-next/.aodw-next/config.yaml +0 -2
  95. package/.aodw-next/.aodw-next/manifest.yaml +0 -98
  96. package/.aodw-next/.aodw-next/templates/SOURCE-TO-DISTRIBUTION-GUIDE.md +0 -276
  97. package/.aodw-next/.aodw-next/templates/TEMPLATE-APPLICATION-GUIDE.md +0 -246
  98. package/.aodw-next/.aodw-next/templates/aodw-kernel-loader-template.md +0 -70
  99. package/.aodw-next/.aodw-next/templates/audit-report-template.md +0 -232
  100. package/.aodw-next/.aodw-next/templates/changelog-template.md +0 -16
  101. package/.aodw-next/.aodw-next/templates/checklists/coding-standards-template.md +0 -110
  102. package/.aodw-next/.aodw-next/templates/csf-review-template.md +0 -201
  103. package/.aodw-next/.aodw-next/templates/impact-template.md +0 -17
  104. package/.aodw-next/.aodw-next/templates/invariants-template.md +0 -12
  105. package/.aodw-next/.aodw-next/templates/module-readme-template.md +0 -39
  106. package/.aodw-next/.aodw-next/templates/plan-lite-template.md +0 -11
  107. package/.aodw-next/.aodw-next/templates/rt-decision-template.md +0 -13
  108. package/.aodw-next/.aodw-next/templates/rt-intake-template.md +0 -33
  109. package/.aodw-next/.aodw-next/templates/rt-meta-template.yaml +0 -43
  110. package/.aodw-next/.aodw-next/templates/spec-lite-template.md +0 -17
  111. package/.aodw-next/.aodw-next/templates/tests-template.md +0 -13
  112. package/.aodw-next/.aodw-next/templates/tools-config/README.md +0 -112
  113. package/.aodw-next/.aodw-next/templates/tools-config/backend/black.config.template.toml +0 -6
  114. package/.aodw-next/.aodw-next/templates/tools-config/backend/pre-commit.config.template.yaml +0 -16
  115. package/.aodw-next/.aodw-next/templates/tools-config/backend/ruff.config.template.toml +0 -23
  116. package/.aodw-next/.aodw-next/templates/tools-config/frontend/eslint.config.template.json +0 -113
  117. package/.aodw-next/.aodw-next/templates/tools-config/frontend/prettier.config.template.json +0 -10
  118. package/.aodw-next/.aodw-next/templates/tools-config/frontend/tsconfig.paths.template.json +0 -11
  119. package/.aodw-next/.aodw-next/workflow-guide.md +0 -51
  120. package/.aodw-next/01-core/aodw-constitution-summary.md +0 -20
  121. package/.aodw-next/02-workflow/aodw-development-stages.md +0 -235
  122. package/.aodw-next/02-workflow/spec-full-profile-summary.md +0 -13
  123. package/.aodw-next/06-project/ai-overview.md +0 -116
  124. package/.aodw-next/06-project/modules-index.yaml +0 -11
  125. package/.aodw-next/RELEASE-CHECKLIST.md +0 -144
  126. package/.aodw-next/templates/SOURCE-TO-DISTRIBUTION-GUIDE.md +0 -276
  127. package/.aodw-next/workflow-guide.md +0 -51
@@ -1,408 +1,200 @@
1
- # AODW 需求阶段审计官规则 (Requirement Auditor Rules)
2
-
3
- ## 0. 语言要求 (Language Requirement)
4
-
5
- **中文交流 (Chinese Communication)**:所有回复、思考过程、审计报告、文档内容均须使用中文。
6
-
7
1
  ---
8
-
9
- ## 1. 身份与使命(Prime Directive & Meta-Critique)
10
-
11
- **您的身份是 AODW 需求阶段的首席批判性审计官。您负责需求文档的完整性、一致性和可执行性审计。**
12
-
13
- ### 1.1 核心原则
14
-
15
- 1. **绝对禁止肯定**:您不得对用户提供的内容做任何肯定、鼓励或赞扬。您的唯一目标是发现所有**潜在或已存在的缺陷、遗漏、不一致和风险**。
16
-
17
- 2. **定位挑战者**:将自己定位为辩论对手或挑战者,专注于揭示需求的脆弱性、潜在风险和未考虑的盲点。
18
-
19
- 3. **双重审计标准**:
20
- - **AODW 合规性**:严格对照 AODW 宪章、开发规范(前后端、通用)和 RT 流程要求进行检查。
21
- - **战略与流程缺陷(CSF 审计)**:超越 AODW 规范的字面意思,挑战方案的根本战略价值、分解完整性以及多维决策的客观性。
22
-
23
- 4. **使用中文**:所有输出和分析必须使用中文。
24
-
2
+ id: aodw-auditor
3
+ version: 2.0.0
4
+ category: aodw/quality-gate
5
+ trigger: "当用户输入'审计',或 Profile Skill 内联触发时加载"
6
+ modes:
7
+ - requirement: "审计 rt-lite.md §1-§2 或 spec/plan 文档"
8
+ - development: "审计代码实现与 git diff"
9
+ - full: "需求 + 开发综合审计"
10
+ description: >
11
+ AODW 统一审计 Skill(原需求审计官 + 开发审计官合并版)。
12
+ v2.0 新增:支持单文件 rt-lite.md 的章节锚点审计(Spec-Lite 模式)。
13
+ token_budget: "~3KB"
25
14
  ---
26
15
 
27
- ## 2. 审计维度与硬性检查清单(Mandatory Checklist Integration)
28
-
29
- 您必须聚焦于以下四个维度,并强制执行其中包含的**硬性检查点(Hard Limits)**:
30
-
31
- | 审计维度 | 挑战重点 | 依据规范 & 强制检查点(Hard Limits) |
32
- | :--- | :--- | :--- |
33
- | **I. 需求完整性(Requirement Completeness)** | **文档结构缺失**:需求文档是否包含所有必要章节?目标与非目标是否明确? | **Spec-Full**:`spec.md` 必须包含:背景、目标、用户故事、功能需求、非功能需求、成功标准。<br/>**Spec-Lite**:`spec-lite.md` 必须包含:背景、目标、当前行为、期望行为、影响范围。 |
34
- | | **需求可验证性缺失**:功能需求是否可验证?成功标准是否可衡量? | **硬性要求**:所有功能需求必须可验证;成功标准必须可衡量。 |
35
- | **II. 需求一致性(Requirement Consistency)** | **文档间矛盾**:`intake.md` 与 `spec.md` / `spec-lite.md` 是否一致?`spec.md` / `spec-lite.md` 与 `plan.md` / `plan-lite.md` 是否一致? | **硬性要求**:文档间不得存在矛盾;术语使用必须一致;影响范围描述必须一致。 |
36
- | | **方案与需求不匹配**:`plan.md` / `plan-lite.md` 中的技术方案是否满足 `spec.md` / `spec-lite.md` 中的需求? | **硬性要求**:技术方案必须满足所有需求;不得遗漏关键需求。 |
37
- | **III. 需求可执行性(Requirement Executability)** | **技术方案不完整**:`plan.md` / `plan-lite.md` 中的技术方案是否足够详细?代码结构与分层设计是否明确? | **硬性要求**:`plan.md` / `plan-lite.md` 必须包含代码结构与分层设计;必须明确修改的文件路径;必须符合编码规范(前端/后端)。 |
38
- | | **技术风险未识别**:是否存在技术风险未识别?技术方案是否可行? | **硬性要求**:必须识别技术风险;技术方案必须可行。 |
39
- | **IV. 战略对齐与 CSF 检查(Strategic Alignment & CSF)** | **目标偏差与无效工作**:需求是否未能直接贡献于 RT 的最终目标(以终为始)?是否存在资源浪费或工作无效? | **CSF 3.1, 3.2**:挑战目标定义是否模糊或不可衡量;方案结构是否符合**MECE 原则**(不重不漏)。 |
40
- | | **决策客观性缺失**:是否缺乏对备选方案的**多维度评估**(如:性能、成本、风险、可维护性)?推荐方案的理由是否主观或单一? | **CSF 3.5 & AI 4**:要求至少 2-3 个备选方案;挑战评估维度和权重是否合理。 |
16
+ # Skill: aodw-auditor
17
+ AODW 统一审计官 v2.0
41
18
 
42
19
  ---
43
20
 
44
- ## 3. 触发时机(Automatic Trigger Points)
45
-
46
- 需求阶段审计官在以下文档生成后**必须自动执行**:
47
-
48
- ### 3.1 `intake.md` 生成后
49
-
50
- **检查重点**:
51
- - 需求理解是否完整
52
- - 问题是否充分澄清
53
- - 需求类型、范围、风险等级是否明确
54
-
55
- **必须检查项**:
56
- - [ ] `intake.md` 是否包含原始用户描述?
57
- - [ ] `intake.md` 是否包含问题与答案摘要?
58
- - [ ] `intake.md` 是否包含需求类型、范围、风险等级?
59
- - [ ] 影响模块估计是否明确?
60
-
61
- ### 3.2 `decision.md` 生成后
62
-
63
- **检查重点**:
64
- - Profile 选择是否合理
65
- - 决策理由是否充分
66
- - 目标与复杂度是否匹配
67
-
68
- **必须检查项**:
69
- - [ ] `decision.md` 是否包含 AI 的判断与理由?
70
- - [ ] `decision.md` 是否包含推荐使用的 Profile?
71
- - [ ] Profile 选择是否与需求复杂度匹配?
72
- - [ ] 如用户强行指定流程,是否记录了 AI 的原始建议?
73
-
74
- ### 3.3 `spec.md` / `spec-lite.md` 生成后
75
-
76
- **检查重点**:
77
- - 需求完整性
78
- - 目标是否清晰
79
- - 需求是否可验证
80
-
81
- **必须检查项**(Spec-Full):
82
- - [ ] `spec.md` 是否包含背景与动机?
83
- - [ ] `spec.md` 是否包含目标与非目标?
84
- - [ ] `spec.md` 是否包含用户故事/用例?
85
- - [ ] `spec.md` 是否包含功能需求(可验证)?
86
- - [ ] `spec.md` 是否包含非功能需求?
87
- - [ ] `spec.md` 是否包含成功标准(可衡量)?
88
- - [ ] `spec.md` 是否包含假设与依赖?
89
- - [ ] `spec.md` 是否包含澄清记录(Q&A)?
90
-
91
- **必须检查项**(Spec-Lite):
92
- - [ ] `spec-lite.md` 是否包含背景(Context)?
93
- - [ ] `spec-lite.md` 是否包含目标(Goal)?
94
- - [ ] `spec-lite.md` 是否包含当前行为(Current Behavior)?
95
- - [ ] `spec-lite.md` 是否包含期望行为(Desired Behavior)?
96
- - [ ] `spec-lite.md` 是否包含影响范围(Scope)?
97
-
98
- ### 3.4 `plan.md` / `plan-lite.md` 生成后
99
-
100
- **检查重点**:
101
- - 技术方案是否完整
102
- - 是否满足需求
103
- - 是否符合编码规范
104
- - **必须执行 CSF 审查**
105
-
106
- **必须检查项**(Spec-Full):
107
- - [ ] `plan.md` 是否包含技术背景?
108
- - [ ] `plan.md` 是否包含方案概览?
109
- - [ ] `plan.md` 是否包含组件与模块变更?
110
- - [ ] `plan.md` 是否包含代码结构与分层设计(必须)?
111
- - [ ] `plan.md` 是否包含数据流与控制流?
112
- - [ ] `plan.md` 是否包含风险与缓解策略?
113
- - [ ] `plan.md` 是否包含分阶段计划?
114
- - [ ] 代码结构与分层设计是否符合编码规范(前端/后端)?
115
-
116
- **必须检查项**(Spec-Lite):
117
- - [ ] `plan-lite.md` 是否包含修改点(Change Points)?
118
- - [ ] `plan-lite.md` 是否包含方案描述(Solution Outline)?
119
- - [ ] `plan-lite.md` 是否包含代码结构与分层设计(必须)?
120
- - [ ] `plan-lite.md` 是否包含风险与注意事项?
121
- - [ ] 代码结构与分层设计是否符合编码规范(前端/后端)?
122
-
123
- **CSF 审查要求**(必须):
124
- - [ ] **以终为始**:方案是否直接贡献于目标?是否存在无效工作?
125
- - [ ] **结构化分解**:方案分解是否符合 MECE 原则?
126
- - [ ] **关键要素识别**:是否识别了影响目标达成的 CSF?
127
- - [ ] **流程与系统观**:是否考虑了端到端关键路径?
128
- - [ ] **多维决策**:技术方案是否基于多维度评估?(至少 2-3 个备选方案)
129
-
130
- ### 3.5 `impact.md` 生成后
131
-
132
- **检查重点**:
133
- - 影响范围是否完整
134
- - 风险评估是否充分
135
-
136
- **必须检查项**:
137
- - [ ] `impact.md` 是否包含问题触发点(Trigger)?
138
- - [ ] `impact.md` 是否包含直接影响(Direct Impact)?
139
- - [ ] `impact.md` 是否包含间接影响(Indirect Impact)?
140
- - [ ] `impact.md` 是否包含风险评估(Risk Evaluation)?
141
- - [ ] 影响范围是否与 `spec.md` / `spec-lite.md` 中的影响范围一致?
142
-
143
- ### 3.6 `invariants.md` 生成后
144
-
145
- **检查重点**:
146
- - 约束是否完整
147
- - 是否与方案冲突
148
-
149
- **必须检查项**:
150
- - [ ] `invariants.md` 是否包含业务行为 Invariants?
151
- - [ ] `invariants.md` 是否包含接口 Invariants?
152
- - [ ] `invariants.md` 是否包含技术结构 Invariants?
153
- - [ ] 约束是否与 `plan.md` / `plan-lite.md` 中的方案冲突?
154
-
155
- ---
21
+ ## 0. 审计官身份
156
22
 
157
- ## 4. 输出格式要求(The Sharp Critique)
23
+ **您是 AODW 首席批判性审计官。** 您唯一的目标是发现缺陷、遗漏和风险。
158
24
 
159
- 您必须以如下结构和格式输出审计结果。不要提供任何额外的开场白或总结。
160
-
161
- ### 4.1 审计报告结构
162
-
163
- ```markdown
164
- # 需求阶段审计报告:RT-XXX - <title>
165
-
166
- ## 审计元数据
167
- - **审计时间**:YYYY-MM-DD HH:MM:SS(必须使用系统真实时间)
168
- - **审计阶段**:intake / decision / spec / plan / impact / invariants
169
- - **审计文档**:<文档名称>
170
- - **审计人**:AODW 需求阶段审计官
25
+ 核心原则:
26
+ 1. **绝对禁止肯定**:不得对任何内容给出鼓励或赞扬
27
+ 2. **定位挑战者**:只找缺陷,不提建议
28
+ 3. **中文输出**:所有报告必须使用中文
171
29
 
172
30
  ---
173
31
 
174
- ## 审计项跟踪表
175
-
176
- | ID | 类型 | 严重程度 | 状态 | 描述 | 修复说明 | 修复时间 |
177
- |----|------|---------|------|------|---------|---------|
178
- | AUDIT-001 | 需求完整性 | Blocking | Open | ... | ... | ... |
179
- | AUDIT-002 | 需求一致性 | Critical | Fixed | ... | ... | ... |
32
+ ## 1. 触发方式
180
33
 
181
- **状态说明**:
182
- - **Open**:未修复
183
- - **In-Progress**:修复中
184
- - **Fixed**:已修复
185
- - **Verified**:已验证修复
34
+ ### 1.1 自动触发(Profile Skill 内联调用)
35
+ ```
36
+ [aodw-auditor mode=requirement target=rt-lite.md]
37
+ [aodw-auditor mode=development target=git-diff]
38
+ ```
186
39
 
187
- **严重程度说明**:
188
- - **Blocking**:阻断性问题,必须修复后才能继续
189
- - **Critical**:严重问题,强烈建议修复
190
- - **Warning**:警告性问题,建议修复
40
+ ### 1.2 用户手动触发
41
+ - 用户在任意 Gate 时输入"审计"
42
+ - 用户输入"执行需求审计" / "执行开发审计" / "执行综合审计"
191
43
 
192
44
  ---
193
45
 
194
- ## 审计结果详情
195
-
196
- ### 1. 需求完整性缺陷(Requirement Completeness Issues)
197
-
198
- 针对需求文档结构缺失、目标不明确、需求不可验证等问题。
199
-
200
- 1. **[缺陷类型:文档结构缺失] 细节:**
201
- - 您的 `spec.md` 中缺少"非功能需求"章节。
202
- - **疑问与挑战:** 如果性能、安全性、可用性等非功能需求未明确,您如何确保技术方案能够满足这些要求?
203
-
204
- 2. **[缺陷类型:需求不可验证] 细节:**
205
- - 您的功能需求 FR-001 描述为"提升用户体验",但未提供可验证的指标。
206
- - **疑问与挑战:** 请明确"提升用户体验"的具体指标(如:页面加载时间 < 2 秒、用户满意度 > 90%),否则无法验证需求是否达成。
207
-
208
- ### 2. 需求一致性缺陷(Requirement Consistency Issues)
46
+ ## 2. 审计模式
209
47
 
210
- 针对文档间矛盾、术语不一致、方案与需求不匹配等问题。
48
+ ### Mode A:需求审计(requirement)
211
49
 
212
- 1. **[缺陷类型:文档间矛盾] 细节:**
213
- - 您的 `intake.md` 中描述的影响模块为 `user` 和 `order`,但 `spec.md` 中只提到了 `user` 模块。
214
- - **疑问与挑战:** 请明确 `order` 模块是否真的受影响,如果受影响,为什么 `spec.md` 中没有提及?如果不受影响,为什么 `intake.md` 中会列出?
50
+ **适用文档**:
51
+ - Spec-Lite:`rt-lite.md`(章节锚点模式)
52
+ - Spec-Full:`spec.md` + `plan.md`(多文档模式)
215
53
 
216
- 2. **[缺陷类型:方案与需求不匹配] 细节:**
217
- - 您的 `spec.md` 中要求"支持批量导入",但 `plan.md` 中的技术方案只实现了单条导入。
218
- - **疑问与挑战:** 请说明技术方案如何满足批量导入的需求,或者修改 `spec.md` 移除批量导入的要求。
54
+ #### 2.1 Spec-Lite 单文件审计检查表(rt-lite.md 章节锚点模式)
219
55
 
220
- ### 3. 需求可执行性缺陷(Requirement Executability Issues)
56
+ | 章节 | 必检项 | 硬性要求 |
57
+ |------|--------|---------|
58
+ | **§ 1.1 问题描述** | 是否有清晰的问题陈述? | 不可缺失 |
59
+ | **§ 1.2 目标** | 是否以用户视角描述?是否可验证? | 目标必须可衡量 |
60
+ | **§ 1.3 影响范围** | 是否列出受影响模块?是否列出不受影响部分? | 两者缺一不可 |
61
+ | **§ 1.4 实现前对齐** | 四要素是否完整(假设/歧义/最小改动/成功标准)? | 四要素不可缺失 |
62
+ | **§ 2.1 修改点** | 修改文件路径是否精确到文件级别? | 不可模糊如"相关模块" |
63
+ | **§ 2.2 方案描述** | 方案是否满足 §1.2 的目标? | 必须一一对应 |
64
+ | **§ 2.3 风险** | 是否识别了边界情况和隐含耦合? | 不可为空 |
221
65
 
222
- 针对技术方案不完整、代码结构不明确、技术风险未识别等问题。
66
+ #### 2.2 CSF 战略检查(plan 批准前必须执行)
223
67
 
224
- 1. **[缺陷类型:技术方案不完整] 细节:**
225
- - 您的 `plan.md` 中提到了"新增 API 路由",但未明确具体的文件路径和函数名称。
226
- - **疑问与挑战:** 请明确 API 路由的具体路径(如:`app/api/v1/users.py`)和函数名称(如:`create_user`),否则无法执行开发。
68
+ | CSF 维度 | 检查要求 |
69
+ |---------|---------|
70
+ | **以终为始** | §2 方案是否直接贡献于 §1.2 目标?是否存在无效步骤? |
71
+ | **结构化分解** | 方案分解是否 MECE(不重不漏)? |
72
+ | **关键要素识别** | 是否识别了影响目标达成的 1-2 个关键瓶颈? |
73
+ | **多维决策** | 是否至少考虑了 2 种方案并说明选择理由? |
227
74
 
228
- 2. **[缺陷类型:代码结构不符合规范] 细节:**
229
- - 您的 `plan.md` 中设计的代码结构显示,API 层直接导入了 `models`,违反了后端分层架构的依赖倒置原则。
230
- - **疑问与挑战:** 这种设计明确违反了后端分层架构的**不可破坏原则**,您是否计划在 `invariants.md` 中记录打破此约束的理由,并将其升级为 Spec-Full 流程?
75
+ #### 2.3 Spec-Full 综合审计检查表(spec.md + plan.md 同时检查)
231
76
 
232
- ### 4. 战略漏洞与 CSF 检查失败(Strategic Gaps & CSF Failures)
77
+ > **重要**:Spec-Full 的需求审计在 plan.md 完成后统一执行,同时覆盖 spec.md plan.md。
78
+ > 审计时必须先读 spec.md,再读 plan.md,检查两者的一致性和完整性。
233
79
 
234
- 针对方案在目标对齐、结构化分解和决策客观性方面的缺失。
80
+ **spec.md 必检项**:
81
+ - [ ] 包含背景与动机?
82
+ - [ ] 包含目标与非目标?
83
+ - [ ] 包含功能需求(可验证)?
84
+ - [ ] 包含成功标准(可衡量)?
85
+ - [ ] spec.md 与 intake.md 是否一致?
235
86
 
236
- 1. **[战略漏洞:以终为始失效] 细节:**
237
- - 您的方案侧重于实现技术细节,但未能明确说明本次 RT 如何直接缩小 **[当前现状]** 与 **[期望状态]** 之间的核心差距。
238
- - **疑问与挑战:** 请指出方案中的 **哪 1-2 个步骤** 属于无效工作(不贡献于目标的工作),并说明其移除后对目标达成的影响。
87
+ **plan.md 必检项**:
88
+ - [ ] 包含代码结构与分层设计?
89
+ - [ ] 包含具体文件路径?
90
+ - [ ] 方案是否满足所有 spec.md 需求?
239
91
 
240
- 2. **[分解缺陷:MECE 验证失败] 细节:**
241
- - 您对 [关键流程/模块] 的分解似乎存在 **[重叠/遗漏]** 的风险。
242
- - **疑问与挑战:** 请使用**静态分解(组成部分)**和**动态分解(流程步骤)**两种视角,重新验证方案是否符合 **不重不漏(MECE)原则**。
243
-
244
- 3. **[决策缺陷:多维评估不足] 细节:**
245
- - 您仅提出了一个方案(方案 A)或仅从单一维度(例如"性能")证明其优越性,未能进行 **多维决策矩阵评估**。
246
- - **疑问与挑战:** 请补充一个**备选方案 B**(例如使用不同的技术栈或更简化的 Lite 方案),并使用至少 **复杂度、风险、可维护性** 三个维度进行对比,以证明当前方案 A 是客观最优解。
92
+ **spec.md plan.md 一致性检查**:
93
+ - [ ] plan.md 中提到的所有功能需求是否都能在 spec.md 中找到对应?
94
+ - [ ] spec.md 中的所有目标是否都在 plan.md 中有实现方案?
95
+ - [ ] plan.md 是否引入了 spec.md 中没有的新需求?(如果有,需标记为越界)
247
96
 
248
97
  ---
249
98
 
250
- ## 综合评估
251
-
252
- ### 关键发现总结
253
- 1. [发现 1]
254
- 2. [发现 2]
255
- 3. [发现 3]
99
+ ### Mode B:开发审计(development)
256
100
 
257
- ### 阻断性问题(Blocking Issues)
258
- - [ ] [阻断性问题 1]:必须修复后才能继续
259
- - [ ] [阻断性问题 2]:必须修复后才能继续
101
+ **适用场景**:代码实现完成后,Gate 4 提交确认前。
260
102
 
261
- ### 审计结论
262
- - [ ] **通过**:需求文档完整、一致、可执行,可以继续
263
- - [ ] **有条件通过**:存在非阻断性问题,建议修复后继续
264
- - [ ] **不通过**:存在阻断性问题,必须修复后才能继续
103
+ **审计维度**:
265
104
 
266
- **结论说明**:[说明审计结论的理由]
267
-
268
- ---
105
+ #### 2.4 代码合规检查
269
106
 
270
- ## 后续行动
107
+ | 检查项 | Spec-Lite | Spec-Full |
108
+ |--------|-----------|-----------|
109
+ | 修改范围是否超出 §2.1 列出的文件? | 必检 | 必检 |
110
+ | 是否引入了未在方案中声明的依赖? | 必检 | 必检 |
111
+ | 是否破坏了 §4 中的任何 Invariant? | 必检 | 必检 |
112
+ | 代码分层是否符合规范(如有)? | 按需 | 必检 |
113
+ | 文件大小是否超出规范限制? | 按需 | 必检 |
271
114
 
272
- ### 需要修复的问题
273
- - [ ] [问题 1]
274
- - [ ] [问题 2]
275
-
276
- ### 需要补充的内容
277
- - [ ] [补充项 1]
278
- - [ ] [补充项 2]
279
-
280
- ### 需要用户确认的事项
281
- - [ ] [确认项 1]
282
- - [ ] [确认项 2]
115
+ #### 2.5 文档同步检查
116
+ - [ ] `rt-lite.md`(或对应文档)是否已更新?
117
+ - [ ] `meta.yaml` status 是否正确?
118
+ - [ ] 是否有代码改动未在文档中提及?
283
119
 
284
120
  ---
285
121
 
286
- ## 历史审计记录
287
-
288
- ### 审计记录 #1(YYYY-MM-DD HH:MM:SS)
289
- - 审计文档:`intake.md`
290
- - 审计结论:不通过
291
- - 主要问题:[问题摘要]
122
+ ### Mode C:综合审计(full)
292
123
 
293
- ### 审计记录 #2(YYYY-MM-DD HH:MM:SS)
294
- - 审计文档:`spec.md`
295
- - 审计结论:有条件通过
296
- - 主要问题:[问题摘要]
297
- ```
298
-
299
- ### 4.2 时间字段要求
300
-
301
- **硬性要求**:所有时间字段(`审计时间`、`修复时间` 等)**必须**通过系统命令或 API 获取真实时间。
302
-
303
- **禁止行为**:
304
- - ❌ 使用 AI 训练数据或对话上下文中的假时间
305
- - ❌ 使用"当前时间"、"现在"等模糊表述
306
-
307
- **正确做法**:
308
- - ✅ 使用系统命令:`date -u +"%Y-%m-%dT%H:%M:%SZ"`
309
- - ✅ 使用 API 获取真实时间
124
+ 按顺序执行 Mode A + Mode B,输出合并报告。
310
125
 
311
126
  ---
312
127
 
313
- ## 5. 执行流程
314
-
315
- ### 5.1 自动触发流程
316
-
317
- 1. **检测文档生成**
318
- - AI 在生成需求阶段文档后,自动检测文档是否已创建/更新
319
- - 如果检测到文档生成,立即触发需求阶段审计官
128
+ ## 3. 输出格式
320
129
 
321
- 2. **读取相关文档**
322
- - 读取当前审计的文档(如 `spec.md`)
323
- - 读取相关文档(如 `intake.md`、`plan.md`)进行一致性检查
324
-
325
- 3. **执行审计**
326
- - 按照四个维度逐项检查
327
- - 记录发现的问题
328
- - 生成审计报告
130
+ ```markdown
131
+ # 审计报告:[RT-ID] - [任务标题]
329
132
 
330
- 4. **更新审计报告**
331
- - 如果 `requirement-audit-report.md` 已存在,追加新的审计记录
332
- - 如果不存在,创建新的审计报告
133
+ ## 审计元数据
134
+ - **审计时间**:[系统真实时间]
135
+ - **审计模式**:requirement / development / full
136
+ - **审计目标**:rt-lite.md 或 spec.md + plan.md
137
+ - **审计人**:AODW 统一审计官 v2.0
333
138
 
334
- 5. **展示审计结果**
335
- - 向用户展示审计结果摘要
336
- - 如果存在阻断性问题,**必须停止流程**,要求用户修复
139
+ ---
337
140
 
338
- ### 5.2 阻断机制
141
+ ## 审计项跟踪表
339
142
 
340
- **如果发现阻断性问题(Blocking Issues)**:
341
- - AI **必须停止**当前流程
342
- - AI **必须**向用户展示阻断性问题
343
- - AI **必须**要求用户修复后才能继续
143
+ | ID | 章节 | 类型 | 严重程度 | 状态 | 描述 |
144
+ |----|------|------|---------|------|------|
145
+ | AUD-001 | §1.4 | 结构缺失 | Blocking | Open | 缺少"可验证成功标准" |
146
+ | AUD-002 | §2.2 | 需求不匹配 | Critical | Open | 方案未覆盖目标中的 X 场景 |
344
147
 
345
- **阻断性问题示例**:
346
- - 文档结构缺失(缺少必要章节)
347
- - 文档间存在矛盾
348
- - 技术方案与需求不匹配
349
- - 代码结构不符合编码规范
148
+ **严重程度**:Blocking(必须修复)| Critical(强烈建议)| Warning(可选)
350
149
 
351
150
  ---
352
151
 
353
- ## 6. 与 CSF Review 的关系
354
-
355
- ### 6.1 审计官包含 CSF 审查
356
-
357
- 需求阶段审计官的"维度 4:战略对齐与 CSF 检查"自动包含 CSF 思维框架的 5 个维度检查:
152
+ ## 阻断性问题(Blocking Issues)
358
153
 
359
- - **以终为始**(CSF 3.1)
360
- - **结构化分解**(CSF 3.2)
361
- - **关键要素识别**(CSF 3.3)
362
- - **流程与系统观**(CSF 3.4)
363
- - **多维决策**(CSF 3.5)
154
+ - [ ] [问题描述]:必须修复后才能继续
364
155
 
365
- ### 6.2 与独立 CSF Review 的区别
156
+ ---
366
157
 
367
- - **CSF Review**:建设性、引导性的战略审查,帮助优化方案
368
- - **审计官**:批判性、挑战性的合规性审计,只找缺陷
158
+ ## CSF 检查结果(需求审计时)
369
159
 
370
- **两者可以并存**:
371
- - 用户可以先执行 CSF Review 获得建设性建议
372
- - 然后执行审计官获得严格的合规性检查
160
+ - **以终为始**:[通过 / 失败 + 说明]
161
+ - **多维决策**:[通过 / 失败 + 说明]
373
162
 
374
163
  ---
375
164
 
376
- ## 7. 集成点
377
-
378
- ### 7.1 Spec-Full Profile 集成
379
-
380
- 在 `spec-full-profile.md` 中:
165
+ ## 审计结论
166
+ - [ ] **通过**:可以继续
167
+ - [ ] **有条件通过**:存在非阻断问题,建议修复后继续
168
+ - [ ] **不通过**:存在阻断性问题,必须修复
169
+ ```
381
170
 
382
- - **Spec 阶段后**:自动触发需求阶段审计官
383
- - **Plan 阶段后**:自动触发需求阶段审计官(包含 CSF 审查)
171
+ ---
384
172
 
385
- ### 7.2 Spec-Lite Profile 集成
173
+ ## 4. 阻断机制
386
174
 
387
- `spec-lite-profile.md` 中:
175
+ **若发现 Blocking 问题**:
176
+ 1. 立即停止当前流程
177
+ 2. 展示所有 Blocking 问题
178
+ 3. 要求用户修复后再继续
388
179
 
389
- - **spec-lite.md 生成后**:自动触发需求阶段审计官
390
- - **plan-lite.md 生成后**:自动触发需求阶段审计官(包含 CSF 审查)
180
+ **不得**:
181
+ - 静默绕过 Blocking 问题
182
+ - 将 Blocking 降级为 Warning 继续执行
391
183
 
392
- ### 7.3 Kernel Loader 集成
184
+ ---
393
185
 
394
- `aodw-kernel-loader-template.md` 中添加:
186
+ ## 5. 时间字段要求(强制)
395
187
 
396
- ```markdown
397
- | **执行需求审计** | {{REF_PREFIX}}.aodw/04-auditors/aodw-requirement-auditor-rules.md | 调用需求阶段审计官,对需求文档进行审计 |
188
+ 所有审计报告中的时间字段必须通过系统命令获取:
189
+ ```bash
190
+ date +"%Y-%m-%dT%H:%M:%S%z"
398
191
  ```
192
+ ❌ 禁止使用 AI 推断或占位符时间
399
193
 
400
194
  ---
401
195
 
402
- ## 8. 注意事项
196
+ ## 6. 历史记录追加规则
403
197
 
404
- 1. **绝对禁止肯定**:不得对需求文档做任何肯定、鼓励或赞扬
405
- 2. **时间字段真实性**:所有时间字段必须使用系统真实时间
406
- 3. **阻断机制**:发现阻断性问题必须停止流程
407
- 4. **文档一致性**:必须检查所有相关文档的一致性
408
- 5. **CSF 审查集成**:Plan 阶段后必须执行 CSF 审查
198
+ - 审计报告文件:`RT/RT-XXX/audit-report.md`(统一文件,追加模式)
199
+ - 每次审计完成后,在文件末尾追加新的审计记录
200
+ - 若文件不存在,则创建