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.
- package/.aodw-next/01-core/ai-interaction-rules-summary.md +37 -0
- package/.aodw-next/01-core/ai-interaction-rules.md +20 -6
- package/.aodw-next/01-core/ai-knowledge-rules-summary.md +25 -0
- package/.aodw-next/01-core/ai-knowledge-rules.md +19 -21
- package/.aodw-next/01-core/ai-project-overview-rules.md +11 -11
- package/.aodw-next/01-core/aodw-constitution.md +7 -414
- package/.aodw-next/01-core/csf-thinking-framework.md +14 -14
- package/.aodw-next/01-core/git-discipline-summary.md +36 -0
- package/.aodw-next/01-core/git-discipline.md +129 -73
- package/.aodw-next/01-core/module-doc-rules.md +2 -2
- package/.aodw-next/02-workflow/rt-id-generation-rules.md +16 -259
- package/.aodw-next/02-workflow/rt-manager-summary.md +1 -1
- package/.aodw-next/02-workflow/rt-manager.md +73 -344
- package/.aodw-next/02-workflow/spec-full-profile.md +149 -307
- package/.aodw-next/02-workflow/spec-lite-profile.md +170 -253
- package/.aodw-next/02-workflow/ui-workflow-rules-summary.md +39 -0
- package/.aodw-next/02-workflow/ui-workflow-rules.md +57 -292
- package/.aodw-next/03-standards/ai-coding-rules-common.md +1 -1
- package/.aodw-next/03-standards/ai-coding-rules.md +91 -25
- package/.aodw-next/03-standards/stacks/java-springboot/ai-coding-rules-backend.md +9 -9
- package/.aodw-next/03-standards/stacks/python-fastapi/ai-coding-rules-backend.md +13 -13
- package/.aodw-next/03-standards/stacks/react-typescript/ai-coding-rules-frontend.md +10 -10
- package/.aodw-next/03-standards/stacks/rust-axum/ai-coding-rules-backend.md +4 -4
- package/.aodw-next/03-standards/stacks/vue2/ai-coding-rules-frontend.md +9 -9
- package/.aodw-next/04-auditors/aodw-development-auditor-rules.md +15 -10
- package/.aodw-next/04-auditors/aodw-full-auditor-rules.md +14 -14
- package/.aodw-next/04-auditors/aodw-requirement-auditor-rules.md +130 -338
- package/.aodw-next/05-tooling/ai-tools-init-rules.md +74 -367
- package/.aodw-next/06-project/README.md +16 -0
- package/.aodw-next/07-optimization/token-usage-analysis.md +2 -2
- package/.aodw-next/README.md +53 -20
- package/.aodw-next/SKILL.md +32 -0
- package/.aodw-next/config.yaml +2 -2
- package/.aodw-next/manifest.yaml +64 -57
- package/.aodw-next/project.yaml +1 -0
- package/.aodw-next/templates/TEMPLATE-APPLICATION-GUIDE.md +21 -157
- package/.aodw-next/templates/ai-overview.template.md +72 -0
- package/.aodw-next/templates/aodw-kernel-loader-template.md +19 -19
- package/.aodw-next/templates/checklists/coding-standards-template.md +24 -4
- package/.aodw-next/templates/modules-index.template.yaml +13 -0
- package/.aodw-next/templates/plan-lite-template.md +9 -0
- package/.aodw-next/templates/rt-intake-template.md +2 -2
- package/.aodw-next/templates/rt-meta-template.yaml +2 -2
- package/.aodw-next/templates/spec-lite-template.md +9 -0
- package/.aodw-next/templates/tools-config/README.md +1 -1
- package/.aodw-next/templates/tools-config/backend/clippy.config.template.toml +5 -0
- package/.aodw-next/templates/tools-config/backend/rustfmt.config.template.toml +4 -0
- package/.aodw-next/tools-status.yaml +51 -0
- package/AODW_Adapters/antigravity/.agent/rules/aodw-next.md +2 -2
- package/AODW_Adapters/claude/CLAUDE.md +2 -2
- package/AODW_Adapters/cursor/.cursor/rules/aodw-next.mdc +2 -2
- package/AODW_Adapters/gemini/.agent/rules/aodw-next.md +2 -2
- package/AODW_Adapters/gemini/GEMINI.md +6 -5
- package/AODW_Adapters/general/AGENTS.md +2 -2
- package/README.md +62 -45
- package/bin/aodw.js +44 -16
- package/bin/commands/init-overview.js +3 -3
- package/bin/commands/init-tools.js +34 -51
- package/bin/utils/config.js +1 -1
- package/package.json +1 -1
- package/.aodw-next/.aodw-next/01-core/ai-interaction-rules.md +0 -218
- package/.aodw-next/.aodw-next/01-core/ai-knowledge-rules.md +0 -302
- package/.aodw-next/.aodw-next/01-core/ai-project-overview-rules.md +0 -284
- package/.aodw-next/.aodw-next/01-core/aodw-constitution-summary.md +0 -20
- package/.aodw-next/.aodw-next/01-core/aodw-constitution.md +0 -419
- package/.aodw-next/.aodw-next/01-core/csf-thinking-framework.md +0 -373
- package/.aodw-next/.aodw-next/01-core/git-discipline.md +0 -226
- package/.aodw-next/.aodw-next/01-core/module-doc-rules.md +0 -90
- package/.aodw-next/.aodw-next/02-workflow/aodw-development-stages.md +0 -235
- package/.aodw-next/.aodw-next/02-workflow/rt-id-generation-rules.md +0 -267
- package/.aodw-next/.aodw-next/02-workflow/rt-manager-summary.md +0 -15
- package/.aodw-next/.aodw-next/02-workflow/rt-manager.md +0 -399
- package/.aodw-next/.aodw-next/02-workflow/spec-full-profile-summary.md +0 -13
- package/.aodw-next/.aodw-next/02-workflow/spec-full-profile.md +0 -391
- package/.aodw-next/.aodw-next/02-workflow/spec-lite-profile.md +0 -313
- package/.aodw-next/.aodw-next/02-workflow/ui-workflow-rules.md +0 -334
- package/.aodw-next/.aodw-next/03-standards/ai-coding-rules-common.md +0 -89
- package/.aodw-next/.aodw-next/03-standards/ai-coding-rules.md +0 -370
- package/.aodw-next/.aodw-next/03-standards/stacks/java-springboot/ai-coding-rules-backend.md +0 -231
- package/.aodw-next/.aodw-next/03-standards/stacks/python-fastapi/ai-coding-rules-backend.md +0 -612
- package/.aodw-next/.aodw-next/03-standards/stacks/react-typescript/ai-coding-rules-frontend.md +0 -291
- package/.aodw-next/.aodw-next/03-standards/stacks/rust-axum/ai-coding-rules-backend.md +0 -134
- package/.aodw-next/.aodw-next/03-standards/stacks/vue2/ai-coding-rules-frontend.md +0 -220
- package/.aodw-next/.aodw-next/03-standards/ui-kit/ui-kit.md +0 -163
- package/.aodw-next/.aodw-next/04-auditors/aodw-development-auditor-rules.md +0 -470
- package/.aodw-next/.aodw-next/04-auditors/aodw-full-auditor-rules.md +0 -365
- package/.aodw-next/.aodw-next/04-auditors/aodw-requirement-auditor-rules.md +0 -408
- package/.aodw-next/.aodw-next/05-tooling/ai-tools-init-rules.md +0 -676
- package/.aodw-next/.aodw-next/06-project/ai-overview.md +0 -116
- package/.aodw-next/.aodw-next/06-project/modules-index.yaml +0 -11
- package/.aodw-next/.aodw-next/07-optimization/token-usage-analysis.md +0 -253
- package/.aodw-next/.aodw-next/README.md +0 -26
- package/.aodw-next/.aodw-next/RELEASE-CHECKLIST.md +0 -144
- package/.aodw-next/.aodw-next/config.yaml +0 -2
- package/.aodw-next/.aodw-next/manifest.yaml +0 -98
- package/.aodw-next/.aodw-next/templates/SOURCE-TO-DISTRIBUTION-GUIDE.md +0 -276
- package/.aodw-next/.aodw-next/templates/TEMPLATE-APPLICATION-GUIDE.md +0 -246
- package/.aodw-next/.aodw-next/templates/aodw-kernel-loader-template.md +0 -70
- package/.aodw-next/.aodw-next/templates/audit-report-template.md +0 -232
- package/.aodw-next/.aodw-next/templates/changelog-template.md +0 -16
- package/.aodw-next/.aodw-next/templates/checklists/coding-standards-template.md +0 -110
- package/.aodw-next/.aodw-next/templates/csf-review-template.md +0 -201
- package/.aodw-next/.aodw-next/templates/impact-template.md +0 -17
- package/.aodw-next/.aodw-next/templates/invariants-template.md +0 -12
- package/.aodw-next/.aodw-next/templates/module-readme-template.md +0 -39
- package/.aodw-next/.aodw-next/templates/plan-lite-template.md +0 -11
- package/.aodw-next/.aodw-next/templates/rt-decision-template.md +0 -13
- package/.aodw-next/.aodw-next/templates/rt-intake-template.md +0 -33
- package/.aodw-next/.aodw-next/templates/rt-meta-template.yaml +0 -43
- package/.aodw-next/.aodw-next/templates/spec-lite-template.md +0 -17
- package/.aodw-next/.aodw-next/templates/tests-template.md +0 -13
- package/.aodw-next/.aodw-next/templates/tools-config/README.md +0 -112
- package/.aodw-next/.aodw-next/templates/tools-config/backend/black.config.template.toml +0 -6
- package/.aodw-next/.aodw-next/templates/tools-config/backend/pre-commit.config.template.yaml +0 -16
- package/.aodw-next/.aodw-next/templates/tools-config/backend/ruff.config.template.toml +0 -23
- package/.aodw-next/.aodw-next/templates/tools-config/frontend/eslint.config.template.json +0 -113
- package/.aodw-next/.aodw-next/templates/tools-config/frontend/prettier.config.template.json +0 -10
- package/.aodw-next/.aodw-next/templates/tools-config/frontend/tsconfig.paths.template.json +0 -11
- package/.aodw-next/.aodw-next/workflow-guide.md +0 -51
- package/.aodw-next/01-core/aodw-constitution-summary.md +0 -20
- package/.aodw-next/02-workflow/aodw-development-stages.md +0 -235
- package/.aodw-next/02-workflow/spec-full-profile-summary.md +0 -13
- package/.aodw-next/06-project/ai-overview.md +0 -116
- package/.aodw-next/06-project/modules-index.yaml +0 -11
- package/.aodw-next/RELEASE-CHECKLIST.md +0 -144
- package/.aodw-next/templates/SOURCE-TO-DISTRIBUTION-GUIDE.md +0 -276
- package/.aodw-next/workflow-guide.md +0 -51
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# AI Coding Rules - Backend Development
|
|
2
2
|
|
|
3
|
-
> **注意**:本文件是 `.aodw/03-standards/ai-coding-rules.md` 的子规范文件。
|
|
3
|
+
> **注意**:本文件是 `.aodw-next/03-standards/ai-coding-rules.md` 的子规范文件。
|
|
4
4
|
> 请先阅读主文件了解通用编码原则,再阅读本文件了解后端特定规范。
|
|
5
5
|
|
|
6
6
|
**适用场景**:
|
|
@@ -10,9 +10,9 @@
|
|
|
10
10
|
- 后端工具配置
|
|
11
11
|
|
|
12
12
|
**必须与以下规范配合使用**:
|
|
13
|
-
- `.aodw/03-standards/ai-coding-rules.md`(主文件,包含通用原则)
|
|
14
|
-
- `.aodw/03-standards/ai-coding-rules-common.md`(通用编码规范)
|
|
15
|
-
- `.aodw/05-tooling/ai-tools-init-rules.md`(工具初始化规则,如果通过 AI 方式初始化工具)
|
|
13
|
+
- `.aodw-next/03-standards/ai-coding-rules.md`(主文件,包含通用原则)
|
|
14
|
+
- `.aodw-next/03-standards/ai-coding-rules-common.md`(通用编码规范)
|
|
15
|
+
- `.aodw-next/05-tooling/ai-tools-init-rules.md`(工具初始化规则,如果通过 AI 方式初始化工具)
|
|
16
16
|
|
|
17
17
|
**⚠️ 强制要求**:所有后端开发必须严格遵守 `docs/backend-guidelines.md` 中的规范(如果存在)。
|
|
18
18
|
|
|
@@ -49,10 +49,10 @@
|
|
|
49
49
|
|
|
50
50
|
**AI 必须检查**:
|
|
51
51
|
- [ ] 是否已运行工具初始化?
|
|
52
|
-
- [ ] `.aodw/tools-status.yaml` 中 `initialized: true` 且后端工具状态为 `configured: true`?
|
|
52
|
+
- [ ] `.aodw-next/tools-status.yaml` 中 `initialized: true` 且后端工具状态为 `configured: true`?
|
|
53
53
|
|
|
54
54
|
**检查方法**:
|
|
55
|
-
1. 读取 `.aodw/tools-status.yaml` 文件
|
|
55
|
+
1. 读取 `.aodw-next/tools-status.yaml` 文件
|
|
56
56
|
2. 检查 `tools_init.initialized` 是否为 `true`
|
|
57
57
|
3. 检查 `tools_init.backend.dependency_manager.configured` 是否为 `true`(uv + pip-tools)
|
|
58
58
|
4. 检查 `tools_init.backend.ruff.configured` 是否为 `true`
|
|
@@ -86,14 +86,14 @@
|
|
|
86
86
|
**如果工具未初始化或未配置**:
|
|
87
87
|
1. **AI 必须立即停止编码**
|
|
88
88
|
2. **AI 必须提示用户运行工具初始化**:
|
|
89
|
-
- **CLI 方式**:运行 `aodw` 选择"工具初始化",或运行 `aodw init-tools`
|
|
89
|
+
- **CLI 方式**:运行 `aodw-skill` 选择"工具初始化",或运行 `aodw-skill init-tools`
|
|
90
90
|
- **AI 方式**:说"初始化工具"或"设置开发工具"
|
|
91
91
|
3. **AI 必须说明**:工具初始化会引导用户完成工具的安装和配置
|
|
92
92
|
4. **在工具初始化完成前,不能开始编码**
|
|
93
93
|
|
|
94
94
|
### 2.4 工具配置参考
|
|
95
95
|
|
|
96
|
-
**配置模板位置**:`.aodw/templates/tools-config/backend/`
|
|
96
|
+
**配置模板位置**:`.aodw-next/templates/tools-config/backend/`
|
|
97
97
|
- Ruff 配置模板:`ruff.config.template.toml`(需要合并到 `pyproject.toml`)
|
|
98
98
|
- Black 配置模板:`black.config.template.toml`(需要合并到 `pyproject.toml`)
|
|
99
99
|
- pre-commit 配置模板:`pre-commit.config.template.yaml`
|
|
@@ -455,17 +455,17 @@ AI 在编写后端代码时必须遵守以下流程和规则:
|
|
|
455
455
|
|
|
456
456
|
在提交后端代码前,必须完成以下检查:
|
|
457
457
|
|
|
458
|
-
### 11.1 工具初始化检查(参考 `.aodw/03-standards/stacks/python-fastapi/ai-coding-rules-backend.md` 第 2 节)
|
|
458
|
+
### 11.1 工具初始化检查(参考 `.aodw-next/03-standards/stacks/python-fastapi/ai-coding-rules-backend.md` 第 2 节)
|
|
459
459
|
|
|
460
460
|
- [ ] **工具是否已初始化**:
|
|
461
|
-
- [ ] 检查 `.aodw/tools-status.yaml` 中 `initialized: true`
|
|
461
|
+
- [ ] 检查 `.aodw-next/tools-status.yaml` 中 `initialized: true`
|
|
462
462
|
- [ ] **依赖管理工具**(uv + pip-tools)是否已安装并配置?
|
|
463
463
|
- [ ] Ruff 是否已安装并配置?
|
|
464
464
|
- [ ] Black 是否已安装并配置?
|
|
465
465
|
- [ ] pre-commit 是否已安装并配置?
|
|
466
466
|
- [ ] pre-commit hooks 是否已安装?
|
|
467
467
|
|
|
468
|
-
### 11.2 依赖管理检查(参考 `.aodw/03-standards/stacks/python-fastapi/ai-coding-rules-backend.md` 第 3 节)
|
|
468
|
+
### 11.2 依赖管理检查(参考 `.aodw-next/03-standards/stacks/python-fastapi/ai-coding-rules-backend.md` 第 3 节)
|
|
469
469
|
|
|
470
470
|
- [ ] **依赖管理规范**:
|
|
471
471
|
- [ ] 是否使用 `uv + pip-tools` 管理依赖?
|
|
@@ -579,7 +579,7 @@ package==1.0.0 # 除非有特殊原因
|
|
|
579
579
|
|
|
580
580
|
### 13.1 配置模板位置
|
|
581
581
|
|
|
582
|
-
**配置模板**:`.aodw/templates/tools-config/backend/`
|
|
582
|
+
**配置模板**:`.aodw-next/templates/tools-config/backend/`
|
|
583
583
|
- Ruff 配置模板:`ruff.config.template.toml`(需要合并到 `pyproject.toml`)
|
|
584
584
|
- Black 配置模板:`black.config.template.toml`(需要合并到 `pyproject.toml`)
|
|
585
585
|
- pre-commit 配置模板:`pre-commit.config.template.yaml`
|
|
@@ -607,6 +607,6 @@ CI/CD 再次验证(可选)
|
|
|
607
607
|
### 13.3 工具初始化
|
|
608
608
|
|
|
609
609
|
**如果工具未初始化**:
|
|
610
|
-
- 运行 `aodw init-tools` 或通过 AI 命令"初始化工具"
|
|
610
|
+
- 运行 `aodw-skill init-tools` 或通过 AI 命令"初始化工具"
|
|
611
611
|
- 工具初始化会引导您完成工具的安装和配置
|
|
612
612
|
- 配置模板会自动应用到项目中
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# AI Coding Rules - Frontend Development
|
|
2
2
|
|
|
3
|
-
> **注意**:本文件是 `.aodw/03-standards/ai-coding-rules.md` 的子规范文件。
|
|
3
|
+
> **注意**:本文件是 `.aodw-next/03-standards/ai-coding-rules.md` 的子规范文件。
|
|
4
4
|
> 请先阅读主文件了解通用编码原则,再阅读本文件了解前端特定规范。
|
|
5
5
|
|
|
6
6
|
**适用场景**:
|
|
@@ -9,9 +9,9 @@
|
|
|
9
9
|
- 前端工具配置
|
|
10
10
|
|
|
11
11
|
**必须与以下规范配合使用**:
|
|
12
|
-
- `.aodw/03-standards/ai-coding-rules.md`(主文件,包含通用原则)
|
|
13
|
-
- `.aodw/03-standards/ai-coding-rules-common.md`(通用编码规范)
|
|
14
|
-
- `.aodw/05-tooling/ai-tools-init-rules.md`(工具初始化规则,如果通过 AI 方式初始化工具)
|
|
12
|
+
- `.aodw-next/03-standards/ai-coding-rules.md`(主文件,包含通用原则)
|
|
13
|
+
- `.aodw-next/03-standards/ai-coding-rules-common.md`(通用编码规范)
|
|
14
|
+
- `.aodw-next/05-tooling/ai-tools-init-rules.md`(工具初始化规则,如果通过 AI 方式初始化工具)
|
|
15
15
|
|
|
16
16
|
**⚠️ 强制要求**:所有前端开发必须严格遵守 `docs/frontend-guidelines.md` 中的规范。
|
|
17
17
|
|
|
@@ -39,10 +39,10 @@
|
|
|
39
39
|
|
|
40
40
|
**AI 必须检查**:
|
|
41
41
|
- [ ] 是否已运行工具初始化?
|
|
42
|
-
- [ ] `.aodw/tools-status.yaml` 中 `initialized: true` 且前端工具状态为 `configured: true`?
|
|
42
|
+
- [ ] `.aodw-next/tools-status.yaml` 中 `initialized: true` 且前端工具状态为 `configured: true`?
|
|
43
43
|
|
|
44
44
|
**检查方法**:
|
|
45
|
-
1. 读取 `.aodw/tools-status.yaml` 文件
|
|
45
|
+
1. 读取 `.aodw-next/tools-status.yaml` 文件
|
|
46
46
|
2. 检查 `tools_init.initialized` 是否为 `true`
|
|
47
47
|
3. 检查 `tools_init.frontend.eslint.configured` 是否为 `true`
|
|
48
48
|
4. 检查 `tools_init.frontend.prettier.configured` 是否为 `true`
|
|
@@ -72,7 +72,7 @@
|
|
|
72
72
|
|
|
73
73
|
### 2.4 工具配置参考
|
|
74
74
|
|
|
75
|
-
**配置模板位置**:`.aodw/templates/tools-config/frontend/`
|
|
75
|
+
**配置模板位置**:`.aodw-next/templates/tools-config/frontend/`
|
|
76
76
|
- ESLint 配置模板:`eslint.config.template.json`
|
|
77
77
|
- Prettier 配置模板:`prettier.config.template.json`
|
|
78
78
|
- TypeScript Path Alias 模板:`tsconfig.paths.template.json`
|
|
@@ -257,8 +257,8 @@ AI 在编写前端代码时必须遵守以下流程:
|
|
|
257
257
|
|
|
258
258
|
在提交前端代码前,必须完成以下检查:
|
|
259
259
|
|
|
260
|
-
- [ ] **工具初始化检查**(参考 `.aodw/03-standards/stacks/react-typescript/ai-coding-rules-frontend.md` 第 2 节):
|
|
261
|
-
- [ ] 工具是否已初始化?(检查 `.aodw/tools-status.yaml`)
|
|
260
|
+
- [ ] **工具初始化检查**(参考 `.aodw-next/03-standards/stacks/react-typescript/ai-coding-rules-frontend.md` 第 2 节):
|
|
261
|
+
- [ ] 工具是否已初始化?(检查 `.aodw-next/tools-status.yaml`)
|
|
262
262
|
- [ ] ESLint 是否已安装并配置?
|
|
263
263
|
- [ ] Prettier 是否已安装并配置?
|
|
264
264
|
- [ ] TypeScript path alias 是否已配置?
|
|
@@ -267,7 +267,7 @@ AI 在编写前端代码时必须遵守以下流程:
|
|
|
267
267
|
- [ ] 可复用业务逻辑是否放在 `src/features/<domain>/` 下?
|
|
268
268
|
- [ ] 通用组件/hooks/工具是否放在 `src/shared/` 下?
|
|
269
269
|
- [ ] 依赖关系是否符合规范(pages → features/shared, features → shared)?
|
|
270
|
-
- [ ] **文件大小检查**(参考 `.aodw/03-standards/ai-coding-rules-common.md`):
|
|
270
|
+
- [ ] **文件大小检查**(参考 `.aodw-next/03-standards/ai-coding-rules-common.md`):
|
|
271
271
|
- [ ] 页面入口组件(index.tsx)是否 ≤ 300 行?
|
|
272
272
|
- [ ] 普通组件/hooks/store 文件是否 ≤ 200 行?
|
|
273
273
|
- [ ] 单个函数是否 ≤ 60 行?
|
|
@@ -89,7 +89,7 @@ backend/
|
|
|
89
89
|
|
|
90
90
|
在开始开发前,必须运行工具初始化:
|
|
91
91
|
- 通过 AI 命令:"初始化工具" 或 "设置开发工具"
|
|
92
|
-
- 通过 CLI 命令:`aodw init-tools`
|
|
92
|
+
- 通过 CLI 命令:`aodw-skill init-tools`
|
|
93
93
|
|
|
94
94
|
工具初始化会自动:
|
|
95
95
|
- 检测 rustfmt、clippy、cargo 是否已安装
|
|
@@ -99,7 +99,7 @@ backend/
|
|
|
99
99
|
### 5.2 配置文件
|
|
100
100
|
|
|
101
101
|
**rustfmt.toml**(从模板生成):
|
|
102
|
-
- 模板位置:`.aodw/templates/tools-config/backend/rustfmt.config.template.toml`
|
|
102
|
+
- 模板位置:`.aodw-next/templates/tools-config/backend/rustfmt.config.template.toml`
|
|
103
103
|
- 生成位置:项目根目录 `rustfmt.toml`
|
|
104
104
|
- 主要配置:
|
|
105
105
|
```toml
|
|
@@ -109,11 +109,11 @@ backend/
|
|
|
109
109
|
```
|
|
110
110
|
|
|
111
111
|
**clippy.toml**(从模板生成):
|
|
112
|
-
- 模板位置:`.aodw/templates/tools-config/backend/clippy.config.template.toml`
|
|
112
|
+
- 模板位置:`.aodw-next/templates/tools-config/backend/clippy.config.template.toml`
|
|
113
113
|
- 生成位置:项目根目录 `clippy.toml` 或 `Cargo.toml` 的 `[lints.clippy]` 部分
|
|
114
114
|
- 主要配置:
|
|
115
115
|
- 零警告策略:`warn = "all"`, `deny = ["warnings"]`
|
|
116
|
-
- 复杂度限制:`
|
|
116
|
+
- 复杂度限制:`cognitive-complexity-threshold = 15`(见模板 `clippy.config.template.toml`)
|
|
117
117
|
- 文件长度限制:`too_many_lines_threshold = 400`
|
|
118
118
|
|
|
119
119
|
### 5.3 提交前检查(必须)
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# AI Coding Rules - Frontend Development
|
|
2
2
|
|
|
3
|
-
> **注意**:本文件是 `.aodw/03-standards/ai-coding-rules.md` 的子规范文件。
|
|
3
|
+
> **注意**:本文件是 `.aodw-next/03-standards/ai-coding-rules.md` 的子规范文件。
|
|
4
4
|
> 请先阅读主文件了解通用编码原则,再阅读本文件了解前端特定规范。
|
|
5
5
|
|
|
6
6
|
**适用场景**:
|
|
@@ -9,9 +9,9 @@
|
|
|
9
9
|
- 前端工具配置
|
|
10
10
|
|
|
11
11
|
**必须与以下规范配合使用**:
|
|
12
|
-
- `.aodw/03-standards/ai-coding-rules.md`(主文件,包含通用原则)
|
|
13
|
-
- `.aodw/03-standards/ai-coding-rules-common.md`(通用编码规范)
|
|
14
|
-
- `.aodw/05-tooling/ai-tools-init-rules.md`(工具初始化规则,如果通过 AI 方式初始化工具)
|
|
12
|
+
- `.aodw-next/03-standards/ai-coding-rules.md`(主文件,包含通用原则)
|
|
13
|
+
- `.aodw-next/03-standards/ai-coding-rules-common.md`(通用编码规范)
|
|
14
|
+
- `.aodw-next/05-tooling/ai-tools-init-rules.md`(工具初始化规则,如果通过 AI 方式初始化工具)
|
|
15
15
|
|
|
16
16
|
**⚠️ 强制要求**:所有前端开发必须严格遵守 `docs/frontend-guidelines.md` 中的规范(如果存在)。
|
|
17
17
|
|
|
@@ -41,10 +41,10 @@
|
|
|
41
41
|
|
|
42
42
|
**AI 必须检查**:
|
|
43
43
|
- [ ] 是否已运行工具初始化?
|
|
44
|
-
- [ ] `.aodw/tools-status.yaml` 中 `initialized: true` 且前端工具状态为 `configured: true`?
|
|
44
|
+
- [ ] `.aodw-next/tools-status.yaml` 中 `initialized: true` 且前端工具状态为 `configured: true`?
|
|
45
45
|
|
|
46
46
|
**检查方法**:
|
|
47
|
-
1. 读取 `.aodw/tools-status.yaml` 文件
|
|
47
|
+
1. 读取 `.aodw-next/tools-status.yaml` 文件
|
|
48
48
|
2. 检查 `tools_init.initialized` 是否为 `true`
|
|
49
49
|
3. 检查 `tools_init.frontend.eslint.configured` 是否为 `true`
|
|
50
50
|
4. 检查 `tools_init.frontend.prettier.configured` 是否为 `true`
|
|
@@ -74,7 +74,7 @@
|
|
|
74
74
|
|
|
75
75
|
### 2.4 工具配置参考
|
|
76
76
|
|
|
77
|
-
**配置模板位置**:`.aodw/templates/tools-config/frontend/`
|
|
77
|
+
**配置模板位置**:`.aodw-next/templates/tools-config/frontend/`
|
|
78
78
|
- ESLint 配置模板:`eslint.config.template.json`(需要适配 Vue 2)
|
|
79
79
|
- Prettier 配置模板:`prettier.config.template.json`
|
|
80
80
|
|
|
@@ -165,10 +165,10 @@ frontend/
|
|
|
165
165
|
|
|
166
166
|
在提交 Vue 2 代码前,必须完成以下检查:
|
|
167
167
|
|
|
168
|
-
### 7.1 工具初始化检查(参考 `.aodw/03-standards/stacks/vue2/ai-coding-rules-frontend.md` 第 2 节)
|
|
168
|
+
### 7.1 工具初始化检查(参考 `.aodw-next/03-standards/stacks/vue2/ai-coding-rules-frontend.md` 第 2 节)
|
|
169
169
|
|
|
170
170
|
- [ ] **工具是否已初始化**:
|
|
171
|
-
- [ ] 检查 `.aodw/tools-status.yaml` 中 `initialized: true`
|
|
171
|
+
- [ ] 检查 `.aodw-next/tools-status.yaml` 中 `initialized: true`
|
|
172
172
|
- [ ] ESLint 是否已安装并配置?(必须支持 Vue 2)
|
|
173
173
|
- [ ] Prettier 是否已安装并配置?
|
|
174
174
|
- [ ] PostCSS 是否已配置?
|
|
@@ -26,18 +26,20 @@
|
|
|
26
26
|
|
|
27
27
|
## 2. 审计维度与硬性检查清单(Mandatory Checklist Integration)
|
|
28
28
|
|
|
29
|
-
|
|
29
|
+
您必须聚焦于以下五个维度,并强制执行其中包含的**硬性检查点(Hard Limits)**:
|
|
30
30
|
|
|
31
31
|
| 审计维度 | 挑战重点 | 依据规范 & 强制检查点(Hard Limits) |
|
|
32
32
|
| :--- | :--- | :--- |
|
|
33
33
|
| **I. 硬性技术约束(Hard Technical Constraints)** | **代码质量硬性违规**:是否违反了代码复杂度或文件长度的硬性限制?是否存在分层架构的依赖倒置问题? | **通用规范**:单个函数**最多 ≤ 60 行**;单个模块/文件**最多 ≤ 300 行**(Python/JS/TSX 页面)。<br/>**后端规范**:api → services → repositories,不得跨层调用。<br/>**前端规范**:pages / features / shared,不得违反目录结构规范。 |
|
|
34
34
|
| | **分支管理违规**:是否在 main/master 分支上修改了业务代码? | **硬性要求**:严禁在 main/master 分支直接修改业务代码;所有代码修改必须在 feature 分支上进行。 |
|
|
35
|
-
| **II. 工具前置检查(Tool Readiness)** | **工具未就绪阻断**:在编码开始前,是否检查到关键工具(ESLint, Ruff, uv + pip-tools)**未初始化**? | **Dev Ready 强制要求**:编码前必须检查 `.aodw/tools-status.yaml` 中 `initialized: true`;如果未初始化,AI **必须停止编码**。 |
|
|
35
|
+
| **II. 工具前置检查(Tool Readiness)** | **工具未就绪阻断**:在编码开始前,是否检查到关键工具(ESLint, Ruff, uv + pip-tools)**未初始化**? | **Dev Ready 强制要求**:编码前必须检查 `.aodw-next/tools-status.yaml` 中 `initialized: true`;如果未初始化,AI **必须停止编码**。 |
|
|
36
36
|
| | **工具检查失败**:代码是否通过静态检查工具? | **硬性要求**:代码必须通过 ESLint / Ruff 检查;必须通过格式化工具(Prettier / Black)检查。 |
|
|
37
37
|
| **III. 架构合规性(Architecture Compliance)** | **分层架构违规**:是否违反了分层架构的依赖关系?API 层是否直接导入 models/repositories? | **后端规范**:api → services → repositories,不得跨层调用;不允许在路由中直接写数据库查询。<br/>**前端规范**:pages / features / shared,不得违反目录结构规范。 |
|
|
38
38
|
| | **依赖管理违规**:是否违反了依赖管理的核心原则? | **uv + pip-tools 强制规则**:禁止使用 `pip install`;禁止直接编辑 `.txt` 文件;必须使用版本约束。 |
|
|
39
39
|
| **IV. 知识维护(Knowledge Maintenance)** | **文档与代码不一致**:代码变更是否同步更新了相关文档?模块 README 是否已更新? | **知识维护强制性**:文档与代码不一致视为 Bug;任何涉及行为/数据模型的变更都必须更新相关文档和模块 README。 |
|
|
40
40
|
| | **知识蒸馏失败**:是否涉及模块职责或 Invariants 变更,但未计划更新相关的**模块 README**或**系统级 Invariants** (`ai-overview.md`)? | **知识维护强制性**:文档与代码不一致视为 Bug;任何涉及行为/数据模型的变更都必须更新相关文档和模块 README。 |
|
|
41
|
+
| **V. LLM 行为合规性(LLM Behavior Compliance)** | **静默假设与歧义跳过**:是否在实现前显式声明假设、列出歧义解释并给出推荐? | **行为基线强制规则**:实现前必须完成“假设声明 + 歧义处理 + 成功标准 + 最小方案”四项对齐。 |
|
|
42
|
+
| | **过度实现与无关改动**:是否引入未请求功能、一次性逻辑抽象化、无关重构、无关格式化? | **行为基线强制规则**:最小必要修改;每一处变更应可追溯到用户请求;仅清理由本次改动引入的孤儿代码。 |
|
|
41
43
|
|
|
42
44
|
---
|
|
43
45
|
|
|
@@ -62,16 +64,19 @@
|
|
|
62
64
|
- [ ] 代码是否通过格式化工具检查?
|
|
63
65
|
- [ ] 文档与代码是否一致?
|
|
64
66
|
- [ ] 模块 README 是否已更新(如涉及)?
|
|
67
|
+
- [ ] 是否在实现前完成了假设声明、歧义处理、成功标准、最小方案四项对齐?
|
|
68
|
+
- [ ] 是否存在未被需求授权的额外功能、抽象或配置扩展?
|
|
69
|
+
- [ ] 是否存在与请求无关的重构、格式化、注释清理或风格“顺手优化”?
|
|
65
70
|
|
|
66
71
|
### 3.2 关键里程碑(自动触发)
|
|
67
72
|
|
|
68
73
|
**检查重点**:
|
|
69
74
|
- 阶段性成果是否符合规范
|
|
70
|
-
- 是否偏离了 `plan.md` / `
|
|
75
|
+
- 是否偏离了 `plan.md` / `rt-lite.md` 中的设计
|
|
71
76
|
|
|
72
77
|
**必须检查项**:
|
|
73
78
|
- [ ] 阶段性成果是否符合编码规范?
|
|
74
|
-
- [ ] 是否偏离了 `plan.md` / `
|
|
79
|
+
- [ ] 是否偏离了 `plan.md` / `rt-lite.md` 中的代码结构与分层设计?
|
|
75
80
|
- [ ] 是否引入了未计划的技术风险?
|
|
76
81
|
|
|
77
82
|
### 3.3 用户手动触发
|
|
@@ -153,7 +158,7 @@
|
|
|
153
158
|
针对工具未初始化、工具检查失败等问题。
|
|
154
159
|
|
|
155
160
|
1. **[缺陷类型:工具未就绪阻断] 细节:**
|
|
156
|
-
- 在开发准备阶段(Dev Ready),检测到 `.aodw/tools-status.yaml` 中 `initialized: false`,但您已经开始编写代码。
|
|
161
|
+
- 在开发准备阶段(Dev Ready),检测到 `.aodw-next/tools-status.yaml` 中 `initialized: false`,但您已经开始编写代码。
|
|
157
162
|
- **疑问与挑战:** 如果 Ruff/ESLint/Pre-commit 尚未配置,您如何确保代码不会违反 **函数 ≤ 60 行** 或 **模块 ≤ 300 行**的硬性限制?请立即停止编码,先初始化工具。
|
|
158
163
|
|
|
159
164
|
2. **[缺陷类型:工具检查失败] 细节:**
|
|
@@ -263,7 +268,7 @@
|
|
|
263
268
|
|
|
264
269
|
2. **读取相关文件**
|
|
265
270
|
- 读取修改的代码文件
|
|
266
|
-
- 读取 `plan.md` / `
|
|
271
|
+
- 读取 `plan.md` / `rt-lite.md` 进行设计一致性检查
|
|
267
272
|
- 读取相关文档(模块 README、`ai-overview.md` 等)进行知识维护检查
|
|
268
273
|
|
|
269
274
|
3. **执行审计**
|
|
@@ -274,7 +279,7 @@
|
|
|
274
279
|
- 生成审计报告
|
|
275
280
|
|
|
276
281
|
4. **更新审计报告**
|
|
277
|
-
- 如果 `
|
|
282
|
+
- 如果 `audit-report.md` 已存在,追加新的审计记录
|
|
278
283
|
- 如果不存在,创建新的审计报告
|
|
279
284
|
|
|
280
285
|
5. **展示审计结果**
|
|
@@ -331,7 +336,7 @@ black .
|
|
|
331
336
|
|
|
332
337
|
**检查工具初始化状态**:
|
|
333
338
|
```yaml
|
|
334
|
-
# .aodw/tools-status.yaml
|
|
339
|
+
# .aodw-next/tools-status.yaml
|
|
335
340
|
frontend:
|
|
336
341
|
eslint:
|
|
337
342
|
initialized: true
|
|
@@ -430,7 +435,7 @@ backend:
|
|
|
430
435
|
- 任何涉及模块职责或 Invariants 变更的代码,都必须更新相关文档
|
|
431
436
|
|
|
432
437
|
**检查方法**:
|
|
433
|
-
- 检查 `plan.md` / `
|
|
438
|
+
- 检查 `plan.md` / `rt-lite.md` 中是否包含知识蒸馏步骤
|
|
434
439
|
- 检查模块 README 是否已更新
|
|
435
440
|
|
|
436
441
|
---
|
|
@@ -456,7 +461,7 @@ backend:
|
|
|
456
461
|
在 `aodw-kernel-loader-template.md` 中添加:
|
|
457
462
|
|
|
458
463
|
```markdown
|
|
459
|
-
| **执行开发审计** | {{REF_PREFIX}}.aodw/04-auditors/aodw-development-auditor-rules.md | 调用开发阶段审计官,对代码进行审计 |
|
|
464
|
+
| **执行开发审计** | {{REF_PREFIX}}.aodw-next/04-auditors/aodw-development-auditor-rules.md | 调用开发阶段审计官,对代码进行审计 |
|
|
460
465
|
```
|
|
461
466
|
|
|
462
467
|
---
|
|
@@ -28,7 +28,7 @@
|
|
|
28
28
|
|
|
29
29
|
### 2.1 需求阶段审计
|
|
30
30
|
|
|
31
|
-
**执行方式**:调用需求阶段审计官(`.aodw/04-auditors/aodw-requirement-auditor-rules.md`)
|
|
31
|
+
**执行方式**:调用需求阶段审计官(`.aodw-next/04-auditors/aodw-requirement-auditor-rules.md`)
|
|
32
32
|
|
|
33
33
|
**审计内容**:
|
|
34
34
|
- 需求完整性(文档结构、目标明确性、需求可验证性)
|
|
@@ -40,7 +40,7 @@
|
|
|
40
40
|
|
|
41
41
|
### 2.2 开发阶段审计
|
|
42
42
|
|
|
43
|
-
**执行方式**:调用开发阶段审计官(`.aodw/04-auditors/aodw-development-auditor-rules.md`)
|
|
43
|
+
**执行方式**:调用开发阶段审计官(`.aodw-next/04-auditors/aodw-development-auditor-rules.md`)
|
|
44
44
|
|
|
45
45
|
**审计内容**:
|
|
46
46
|
- 硬性技术约束(函数长度、文件长度、代码复杂度、分层架构、分支管理)
|
|
@@ -87,18 +87,18 @@
|
|
|
87
87
|
1. **读取 RT 信息**
|
|
88
88
|
- 读取 `RT/RT-XXX/meta.yaml` 获取 RT 基本信息
|
|
89
89
|
- 读取 `RT/RT-XXX/intake.md`、`decision.md` 等需求阶段文档
|
|
90
|
-
- 读取 `RT/RT-XXX/spec.md
|
|
90
|
+
- 读取 `RT/RT-XXX/spec.md`、`plan.md` 或 `rt-lite.md` 等
|
|
91
91
|
- 读取代码文件(如已实现)
|
|
92
92
|
|
|
93
93
|
2. **执行需求阶段审计**
|
|
94
|
-
- 调用需求阶段审计官(`.aodw/04-auditors/aodw-requirement-auditor-rules.md`)
|
|
94
|
+
- 调用需求阶段审计官(`.aodw-next/04-auditors/aodw-requirement-auditor-rules.md`)
|
|
95
95
|
- 收集需求阶段审计结果
|
|
96
|
-
- 如果已存在 `
|
|
96
|
+
- 如果已存在 `audit-report.md`,读取并汇总
|
|
97
97
|
|
|
98
98
|
3. **执行开发阶段审计**
|
|
99
|
-
- 如果代码已实现,调用开发阶段审计官(`.aodw/04-auditors/aodw-development-auditor-rules.md`)
|
|
99
|
+
- 如果代码已实现,调用开发阶段审计官(`.aodw-next/04-auditors/aodw-development-auditor-rules.md`)
|
|
100
100
|
- 收集开发阶段审计结果
|
|
101
|
-
- 如果已存在 `
|
|
101
|
+
- 如果已存在 `audit-report.md`,读取并汇总
|
|
102
102
|
|
|
103
103
|
4. **生成综合审计报告**
|
|
104
104
|
- 合并需求阶段和开发阶段的审计结果
|
|
@@ -163,7 +163,7 @@
|
|
|
163
163
|
- **关键发现**:[需求阶段的关键发现摘要]
|
|
164
164
|
|
|
165
165
|
### 需求阶段审计详情
|
|
166
|
-
详见:`RT/RT-XXX/
|
|
166
|
+
详见:`RT/RT-XXX/audit-report.md`
|
|
167
167
|
|
|
168
168
|
**主要问题**:
|
|
169
169
|
1. [问题 1]
|
|
@@ -180,7 +180,7 @@
|
|
|
180
180
|
- **关键发现**:[开发阶段的关键发现摘要]
|
|
181
181
|
|
|
182
182
|
### 开发阶段审计详情
|
|
183
|
-
详见:`RT/RT-XXX/
|
|
183
|
+
详见:`RT/RT-XXX/audit-report.md`
|
|
184
184
|
|
|
185
185
|
**主要问题**:
|
|
186
186
|
1. [问题 1]
|
|
@@ -274,12 +274,12 @@
|
|
|
274
274
|
综合审计官通过调用需求阶段和开发阶段审计官来执行审计:
|
|
275
275
|
|
|
276
276
|
1. **需求阶段审计**:
|
|
277
|
-
- 调用 `.aodw/04-auditors/aodw-requirement-auditor-rules.md` 中的需求阶段审计官
|
|
278
|
-
- 或读取已存在的 `
|
|
277
|
+
- 调用 `.aodw-next/04-auditors/aodw-requirement-auditor-rules.md` 中的需求阶段审计官
|
|
278
|
+
- 或读取已存在的 `audit-report.md`
|
|
279
279
|
|
|
280
280
|
2. **开发阶段审计**:
|
|
281
|
-
- 如果代码已实现,调用 `.aodw/04-auditors/aodw-development-auditor-rules.md` 中的开发阶段审计官
|
|
282
|
-
- 或读取已存在的 `
|
|
281
|
+
- 如果代码已实现,调用 `.aodw-next/04-auditors/aodw-development-auditor-rules.md` 中的开发阶段审计官
|
|
282
|
+
- 或读取已存在的 `audit-report.md`
|
|
283
283
|
|
|
284
284
|
### 6.2 结果汇总
|
|
285
285
|
|
|
@@ -298,7 +298,7 @@
|
|
|
298
298
|
在 `aodw-kernel-loader-template.md` 中添加:
|
|
299
299
|
|
|
300
300
|
```markdown
|
|
301
|
-
| **执行综合审计** | {{REF_PREFIX}}.aodw/04-auditors/aodw-full-auditor-rules.md | 调用综合审计官,执行全流程审计(需求 + 开发) |
|
|
301
|
+
| **执行综合审计** | {{REF_PREFIX}}.aodw-next/04-auditors/aodw-full-auditor-rules.md | 调用综合审计官,执行全流程审计(需求 + 开发) |
|
|
302
302
|
```
|
|
303
303
|
|
|
304
304
|
### 7.2 使用场景
|