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,334 +1,99 @@
|
|
|
1
1
|
# UI Workflow Rules
|
|
2
|
-
UI 设计与审查流程规范
|
|
3
2
|
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
当 RT 任务涉及 UI/界面/交互相关工作时,必须执行本流程。本流程确保:
|
|
7
|
-
- UI 设计符合项目统一审美标准(非 AI 风格)
|
|
8
|
-
- **在实现前先产出静态 HTML 原型供用户确认**(强制步骤)
|
|
9
|
-
- 通过严格的 UI 审查机制保证质量
|
|
10
|
-
|
|
11
|
-
### 0.1 核心要求
|
|
12
|
-
|
|
13
|
-
> ⚠️ **关键规则**:所有 UI 相关任务**必须**在 RT 目录中创建 HTML 版本的界面原型,并**必须**获得用户确认后才能进入实现阶段。
|
|
14
|
-
|
|
15
|
-
- **HTML 原型文件位置**:`RT/RT-XXX/docs/ui-prototype.html`
|
|
16
|
-
- **用户确认**:是强制门禁,不可跳过
|
|
17
|
-
- **实现代码**:仅在用户确认原型后才能生成
|
|
3
|
+
**适用场景**:UI/界面相关工作
|
|
18
4
|
|
|
19
5
|
---
|
|
20
6
|
|
|
21
|
-
##
|
|
22
|
-
|
|
23
|
-
在执行任何任务之前,AI 必须首先进行 **任务类型判断**。
|
|
24
|
-
|
|
25
|
-
### 1.1 UI 相关任务判定条件
|
|
26
|
-
|
|
27
|
-
以下任意条件满足,即视为 **UI 相关任务**:
|
|
28
|
-
|
|
29
|
-
- ✅ 涉及页面、界面、布局、组件、表单、Dashboard
|
|
30
|
-
- ✅ 涉及用户操作流程、交互体验、可视化
|
|
31
|
-
- ✅ 涉及前端 UI、样式、视觉呈现
|
|
32
|
-
- ✅ 用户明确提到"界面 / UI / 好看 / 丑 / 设计"
|
|
33
|
-
- ✅ 涉及 UI 改造、UI 新建、UI 优化
|
|
34
|
-
|
|
35
|
-
### 1.2 判断时机
|
|
36
|
-
|
|
37
|
-
- **RT 创建阶段**:在 `intake.md` 生成时进行判断
|
|
38
|
-
- **任务执行阶段**:在执行任何代码修改前进行判断
|
|
39
|
-
- **需求变更阶段**:当用户提出新需求时重新判断
|
|
40
|
-
- **用户主动触发**:用户明确要求执行 UI 流程时(见第 1.4 节)
|
|
41
|
-
|
|
42
|
-
### 1.3 判断结果处理
|
|
43
|
-
|
|
44
|
-
- **非 UI 相关任务**:按正常 AODW 流程执行
|
|
45
|
-
- **UI 相关任务**:**必须进入 UI 专用流程**(见第 2 节)
|
|
46
|
-
|
|
47
|
-
### 1.4 用户主动触发 UI 流程
|
|
48
|
-
|
|
49
|
-
用户可以在任何时候主动触发 UI 相关流程,AI 必须识别并执行。
|
|
50
|
-
|
|
51
|
-
#### 1.4.1 触发命令识别
|
|
52
|
-
|
|
53
|
-
AI 必须识别以下用户指令(支持多种表达方式):
|
|
54
|
-
|
|
55
|
-
| 触发类型 | 触发词示例 | 执行动作 |
|
|
56
|
-
|---------|-----------|---------|
|
|
57
|
-
| **UI 设计** | "请 AODW 规范,帮我就当前这个 RT 任务的界面进行设计"<br>"按 AODW 规范设计界面"<br>"设计 UI"<br>"生成界面原型" | 执行 UI 设计流程(第 2 节) |
|
|
58
|
-
| **UI 审计/审查** | "请 AODW 规范,帮我就当前这个 RT 任务的界面进行审计"<br>"审计界面"<br>"审查 UI"<br>"检查界面" | 执行 UI Critic 审查流程(第 3 节) |
|
|
59
|
-
| **UI 挑毛病** | "请 AODW 规范,帮我就当前这个 RT 任务的界面挑毛病"<br>"挑 UI 毛病"<br>"找界面问题"<br>"UI 有什么问题" | 执行 UI Critic 审查流程(第 3 节,严格模式) |
|
|
60
|
-
|
|
61
|
-
> **详细规则**:请参考 `.aodw/01-core/ai-interaction-rules.md` 第 5.5 节
|
|
62
|
-
|
|
63
|
-
#### 1.4.2 触发条件检查
|
|
64
|
-
|
|
65
|
-
当用户触发 UI 流程时,AI 必须:
|
|
66
|
-
|
|
67
|
-
1. **检查当前 RT 上下文**
|
|
68
|
-
- 确认是否存在当前 RT(检查 `RT/RT-XXX/` 目录)
|
|
69
|
-
- 如果不存在,提示用户:"未找到当前 RT,请先创建或打开一个 RT"
|
|
70
|
-
- 如果存在,读取 `intake.md` 或 `spec.md` / `spec-lite.md` 了解任务内容
|
|
71
|
-
|
|
72
|
-
2. **检查是否为 UI 相关任务**
|
|
73
|
-
- 如果 `intake.md` 中标注了 `ui_related: true`,直接进入 UI 流程
|
|
74
|
-
- 如果未标注,但任务涉及 UI(根据第 1.1 节判断),提示用户:"检测到当前 RT 可能涉及 UI,是否执行 UI 流程?"
|
|
75
|
-
- 如果完全不涉及 UI,提示用户:"当前 RT 不涉及 UI,是否仍要执行 UI 审查?"
|
|
76
|
-
|
|
77
|
-
3. **执行对应的 UI 流程**
|
|
78
|
-
- **UI 设计**:按照第 2 节执行
|
|
79
|
-
- **UI 审计/审查/挑毛病**:按照第 3 节执行
|
|
80
|
-
|
|
81
|
-
#### 1.4.3 执行优先级
|
|
7
|
+
## 0. 概述
|
|
82
8
|
|
|
83
|
-
|
|
84
|
-
- 如果用户主动触发 UI 流程,即使当前不在 UI 相关阶段,也应立即执行
|
|
85
|
-
- 执行完成后,询问用户是否继续原流程
|
|
9
|
+
> **关键规则**:所有 UI 相关任务**必须**在 RT 目录中创建 HTML 版本的界面原型,并**必须**获得用户确认后才能进入实现阶段。
|
|
86
10
|
|
|
87
11
|
---
|
|
88
12
|
|
|
89
|
-
##
|
|
90
|
-
|
|
91
|
-
当任务被判定为 UI 相关时,AI 必须严格按以下顺序执行:
|
|
92
|
-
|
|
93
|
-
### 2.1 规则文件读取(强制前置,但按需加载)
|
|
94
|
-
|
|
95
|
-
> ⚠️ **Token 优化**:UI-Kit 文件应该合并为单个文件(`.aodw/03-standards/ui-kit/ui-kit.md`),以减少加载次数和 token 消耗。
|
|
96
|
-
|
|
97
|
-
**加载时机**:在生成任何 UI 代码之前,AI **必须**先读取并理解 UI 设计规范文件。
|
|
98
|
-
|
|
99
|
-
**文件位置**:`.aodw/03-standards/ui-kit/` 目录
|
|
100
|
-
|
|
101
|
-
**加载方式**:
|
|
102
|
-
- **必须读取**:`.aodw/03-standards/ui-kit/ui-kit.md`(合并后的统一文件,包含所有 UI 设计规范)
|
|
103
|
-
- 第 1 节:UI 设计系统(统一审美与设计约束)
|
|
104
|
-
- 第 2 节:UI 生成提示词(所有 UI 生成的"总提示词")
|
|
105
|
-
- 第 3 节:禁止的 AI 风格(明确禁止的 AI 审美)
|
|
106
|
-
- 第 4 节:UI Critic Agent(UI 审查标准)
|
|
107
|
-
|
|
108
|
-
**关键规则**:
|
|
109
|
-
- ⚠️ 在未确认理解上述规则之前,**不允许生成任何 UI**
|
|
110
|
-
- ⚠️ 在未确认理解上述规则之前,**不允许输出任何代码**
|
|
111
|
-
- ⚠️ **只在 UI 任务时加载**,非 UI 任务不加载 UI-Kit 文件
|
|
112
|
-
- AI 必须明确告知用户:"已读取 UI 设计规范,准备开始设计"
|
|
113
|
-
|
|
114
|
-
### 2.2 UI 生成阶段规则
|
|
115
|
-
|
|
116
|
-
#### 2.2.1 设计原则
|
|
117
|
-
|
|
118
|
-
UI 生成必须遵守:
|
|
119
|
-
- ✅ 克制、非 AI 风格
|
|
120
|
-
- ✅ 禁止蓝 / 紫 / 红 AI 默认审美
|
|
121
|
-
- ✅ 更像真实成熟产品(Linear / Notion / Stripe),而非 Demo 或 AI 工具
|
|
122
|
-
- ✅ 严格遵循 `ui-kit.md` 第 1 节(UI 设计系统)中的规范
|
|
13
|
+
## 1. 强制要求
|
|
123
14
|
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
-
|
|
128
|
-
- 包括:布局结构、组件层次、交互流程、颜色方案
|
|
129
|
-
- 说明设计理由,解释如何符合设计系统
|
|
130
|
-
|
|
131
|
-
**步骤 B:静态 HTML 原型生成(强制步骤)**
|
|
132
|
-
|
|
133
|
-
> ⚠️ **关键规则**:所有 UI 相关任务**必须**在 RT 目录中创建 HTML 版本的界面原型。
|
|
134
|
-
|
|
135
|
-
- **文件位置**:必须在 `RT/RT-XXX/docs/ui-prototype.html`(如果 `docs/` 目录不存在,必须先创建)
|
|
136
|
-
- **文件命名**:统一使用 `ui-prototype.html`
|
|
137
|
-
- **文件内容要求**:
|
|
138
|
-
- ✅ 生成**完整的静态 HTML 原型**(使用模拟数据)
|
|
139
|
-
- ✅ **必须包含所有 UI 元素和交互状态**
|
|
140
|
-
- ✅ **必须包含完整的样式**(内联 CSS 或 `<style>` 标签)
|
|
141
|
-
- ✅ **必须包含模拟数据**(不需要任何真实 API 请求)
|
|
142
|
-
- ✅ 必须能够在浏览器中直接打开查看
|
|
143
|
-
- ✅ 必须符合 `ui-kit.md` 第 1 节(UI 设计系统)中的设计规范
|
|
144
|
-
- **文件创建**:AI 必须使用 `write` 工具创建此文件,确保文件存在于 RT 目录中
|
|
145
|
-
|
|
146
|
-
**步骤 C:用户确认(强制门禁,不可跳过)**
|
|
147
|
-
|
|
148
|
-
> ⚠️ **关键规则**:用户确认是**强制步骤**,未获得确认前**严禁**进入实现阶段。
|
|
149
|
-
|
|
150
|
-
- **展示 HTML 原型**:
|
|
151
|
-
- 告知用户文件位置:`RT/RT-XXX/docs/ui-prototype.html`
|
|
152
|
-
- 提示用户:"请在浏览器中打开此文件查看界面原型"
|
|
153
|
-
- 如果可能,提供文件路径的完整说明
|
|
154
|
-
- **明确询问**:
|
|
155
|
-
- 必须明确询问:"请确认此 UI 原型是否符合预期?"
|
|
156
|
-
- 必须等待用户明确确认("确认"、"通过"、"继续"、"批准"等)
|
|
157
|
-
- **确认前禁止**:
|
|
158
|
-
- ❌ **未获得用户确认前,禁止进入下一步**
|
|
159
|
-
- ❌ **未获得用户确认前,禁止生成任何实现代码**
|
|
160
|
-
- ❌ **未获得用户确认前,禁止修改任何业务代码**
|
|
161
|
-
|
|
162
|
-
**步骤 D:实现代码生成(用户确认后)**
|
|
163
|
-
- **仅在用户明确确认后**,才生成实际实现代码
|
|
164
|
-
- 代码必须与确认的原型保持一致
|
|
165
|
-
- 如果用户要求修改,必须回到步骤 A 重新设计
|
|
15
|
+
⚠️ **绝对禁止**:
|
|
16
|
+
- ❌ 在 HTML 原型未获用户确认前生成实现代码
|
|
17
|
+
- ❌ 跳过 UI 原型或界面设计阶段
|
|
18
|
+
- ❌ 未经过用户确认直接进入实现阶段
|
|
166
19
|
|
|
167
20
|
---
|
|
168
21
|
|
|
169
|
-
##
|
|
170
|
-
|
|
171
|
-
在 UI 初稿生成完成后(无论是 HTML 原型还是实现代码),**必须自动执行 UI 审查流程**。
|
|
22
|
+
## 2. 流程步骤
|
|
172
23
|
|
|
173
|
-
###
|
|
24
|
+
### Step 0: 任务类型判断
|
|
174
25
|
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
-
|
|
179
|
-
|
|
180
|
-
- 用户可以在任何时候主动触发 UI 审查,即使不在 UI 相关阶段
|
|
181
|
-
- 详细触发命令见第 1.4 节
|
|
182
|
-
|
|
183
|
-
### 3.2 审查执行流程
|
|
184
|
-
|
|
185
|
-
1. **切换到 UI Critic 角色**
|
|
186
|
-
- 按照 `.aodw/03-standards/ui-kit/ui-kit.md` 第 4 节(UI Critic Agent)的标准执行审查
|
|
187
|
-
- 以"挑剔的资深 UI/UX 设计总监"身份进行评判
|
|
188
|
-
|
|
189
|
-
2. **审查标准**
|
|
190
|
-
- 是否有 AI 默认审美特征
|
|
191
|
-
- 是否像真实产品,而不是 Demo
|
|
192
|
-
- 是否存在颜色、排版、层级滥用
|
|
193
|
-
- 是否"用力过猛"
|
|
194
|
-
|
|
195
|
-
3. **审查输出格式**
|
|
196
|
-
必须包含:
|
|
197
|
-
- **丑点清单**(明确指出问题)
|
|
198
|
-
- **为什么丑**(原因分析)
|
|
199
|
-
- **如何改**(改进建议)
|
|
200
|
-
- **是否建议整体重做**(是 / 否)
|
|
201
|
-
|
|
202
|
-
### 3.3 审查结果处理
|
|
203
|
-
|
|
204
|
-
- **通过审查**:继续下一步流程
|
|
205
|
-
- **未通过审查**:进入重构流程(见第 4 节)
|
|
26
|
+
**触发条件**(任一满足即视为 UI 任务):
|
|
27
|
+
- 涉及页面、界面、布局、组件、表单、Dashboard
|
|
28
|
+
- 涉及前端 UI、样式、视觉呈现
|
|
29
|
+
- 涉及用户操作流程、交互体验、可视化
|
|
30
|
+
- 用户明确提到"界面"、"UI"、"设计"、"原型"
|
|
206
31
|
|
|
207
32
|
---
|
|
208
33
|
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
如果 UI Critic 指出存在明显问题,必须执行重构:
|
|
212
|
-
|
|
213
|
-
### 4.1 重构触发条件
|
|
214
|
-
|
|
215
|
-
- UI Critic 明确建议"整体重做"
|
|
216
|
-
- 发现 `ui-kit.md` 第 3 节(禁止的 AI 风格)中列出的任何禁止模式
|
|
217
|
-
- 存在明显的颜色、排版、层级问题
|
|
34
|
+
### Step 1: HTML 原型(强制)
|
|
218
35
|
|
|
219
|
-
|
|
36
|
+
**AI 必须**:
|
|
37
|
+
1. 生成静态 HTML 原型
|
|
38
|
+
2. 保存位置:`RT/RT-XXX/docs/ui-prototype.html`
|
|
39
|
+
3. 使用 Tailwind CSS 实现统一审美(如项目使用)
|
|
220
40
|
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
41
|
+
**原型内容**:
|
|
42
|
+
- 页面结构
|
|
43
|
+
- 核心组件
|
|
44
|
+
- 关键交互流程
|
|
45
|
+
- 表单布局
|
|
46
|
+
- **无真实逻辑代码**
|
|
224
47
|
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
3. **重构后重新审查**
|
|
230
|
-
- 重构完成后,必须再次执行 UI 审查流程
|
|
231
|
-
- 直到通过审查或用户明确接受
|
|
48
|
+
**用户确认**:
|
|
49
|
+
- 原型必须通过用户审查(A/B/C)
|
|
50
|
+
- 确认后才能进入实现阶段
|
|
232
51
|
|
|
233
52
|
---
|
|
234
53
|
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
### 5.1 在 Spec-Lite 中的集成
|
|
238
|
-
|
|
239
|
-
当 RT 使用 Spec-Lite Profile 且涉及 UI 时:
|
|
240
|
-
|
|
241
|
-
1. **Intake 阶段**:识别为 UI 任务
|
|
242
|
-
2. **Spec 阶段**:在 `spec-lite.md` 中明确标注 UI 相关
|
|
243
|
-
3. **Plan 阶段**:在 `plan-lite.md` 中必须包含:
|
|
244
|
-
- UI 原型生成步骤
|
|
245
|
-
- UI 审查步骤
|
|
246
|
-
- 用户确认步骤
|
|
247
|
-
4. **实现阶段**:按本流程执行
|
|
248
|
-
|
|
249
|
-
### 5.2 在 Spec-Full 中的集成
|
|
250
|
-
|
|
251
|
-
当 RT 使用 Spec-Full Profile 且涉及 UI 时:
|
|
252
|
-
|
|
253
|
-
1. **Intake 阶段**:识别为 UI 任务
|
|
254
|
-
2. **Spec 阶段**:在 `spec.md` 中详细描述 UI 需求
|
|
255
|
-
3. **Plan 阶段**:在 `plan.md` 中必须包含:
|
|
256
|
-
- UI 原型设计步骤
|
|
257
|
-
- UI 审查步骤
|
|
258
|
-
- 用户确认步骤
|
|
259
|
-
- UI 实现步骤
|
|
260
|
-
4. **Impact 阶段**:在 `impact.md` 中分析 UI 变更影响
|
|
261
|
-
5. **实现阶段**:按本流程执行
|
|
262
|
-
|
|
263
|
-
### 5.3 文档记录要求
|
|
264
|
-
|
|
265
|
-
UI 相关 RT 必须在以下文档中记录:
|
|
54
|
+
### Step 2: 实现阶段(可选)
|
|
266
55
|
|
|
267
|
-
|
|
268
|
-
-
|
|
269
|
-
-
|
|
270
|
-
- **`RT/RT-XXX/docs/ui-prototype.html`**:**必须创建** HTML 原型文件(强制要求)
|
|
271
|
-
- **`changelog.md`**:记录 UI 变更历史,包括 HTML 原型的创建和确认时间
|
|
56
|
+
**仅在以下情况进入**:
|
|
57
|
+
- HTML 原型已获用户确认
|
|
58
|
+
- 明确告知"现在开始实现"
|
|
272
59
|
|
|
273
60
|
---
|
|
274
61
|
|
|
275
|
-
##
|
|
62
|
+
## 3. 配置模板位置
|
|
276
63
|
|
|
277
|
-
|
|
64
|
+
**HTML 原型模板**:
|
|
65
|
+
- 位置:`.aodw-next/templates/ui-prototype.template.html`
|
|
278
66
|
|
|
279
|
-
|
|
67
|
+
**前端工具配置**:
|
|
68
|
+
- ESLint 配置模板:`.aodw-next/templates/tools-config/frontend/eslint.config.template.json`
|
|
69
|
+
- TypeScript 配置模板:`.aodw-next/templates/tools-config/frontend/tsconfig.paths.template.json`
|
|
280
70
|
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
### 6.2 用户确认优先(强制要求)
|
|
284
|
-
|
|
285
|
-
**所有 UI 设计必须经过用户确认才能进入实现阶段。**
|
|
286
|
-
|
|
287
|
-
**强制要求**:
|
|
288
|
-
- ✅ **必须**在 `RT/RT-XXX/docs/ui-prototype.html` 创建 HTML 原型文件
|
|
289
|
-
- ✅ **必须**等待用户在浏览器中查看原型并明确确认
|
|
290
|
-
- ✅ **必须**在用户确认后才允许生成实现代码
|
|
291
|
-
- ❌ **严禁**跳过 HTML 原型直接生成实现代码
|
|
292
|
-
- ❌ **严禁**在未获得用户确认前进入实现阶段
|
|
293
|
-
|
|
294
|
-
静态 HTML 原型是确认的关键工具,必须包含完整的视觉呈现和所有交互状态。
|
|
295
|
-
|
|
296
|
-
### 6.3 禁止跳过(强制检查点)
|
|
71
|
+
---
|
|
297
72
|
|
|
298
|
-
|
|
299
|
-
- ❌ 规则文件读取
|
|
300
|
-
- ❌ UI 结构与设计说明
|
|
301
|
-
- ❌ **静态 HTML 原型生成**(必须在 `RT/RT-XXX/docs/ui-prototype.html` 创建文件)
|
|
302
|
-
- ❌ **用户确认**(强制门禁,未确认前禁止进入实现阶段)
|
|
303
|
-
- ❌ UI 审查
|
|
73
|
+
## 4. 检查清单
|
|
304
74
|
|
|
305
|
-
|
|
306
|
-
|
|
75
|
+
| 项目 | 检查项 | 状态 |
|
|
76
|
+
|-------|---------|------|
|
|
77
|
+
| HTML 原型 | `docs/ui-prototype.html` 已创建并确认 | |
|
|
78
|
+
| 技术栈 | React/TypeScript / Vue 已配置 | |
|
|
79
|
+
| 工具链 | ESLint / Prettier 已安装 | |
|
|
307
80
|
|
|
308
81
|
---
|
|
309
82
|
|
|
310
|
-
##
|
|
83
|
+
## 5. 审计选项
|
|
311
84
|
|
|
312
|
-
|
|
85
|
+
**AI 识别到 UI 任务时,必须提供以下审计选项**:
|
|
313
86
|
|
|
314
|
-
1.
|
|
315
|
-
2.
|
|
316
|
-
3.
|
|
317
|
-
4. **未执行 UI 审查**:必须补充审查,根据结果决定是否重构
|
|
318
|
-
5. **引入禁止的 AI 风格**:必须立即重构,不得继续
|
|
319
|
-
|
|
320
|
-
**严重违规**:
|
|
321
|
-
- 如果 AI 跳过 HTML 原型创建或用户确认步骤,视为严重违规
|
|
322
|
-
- 必须立即停止所有工作,重新执行完整的 UI 流程
|
|
323
|
-
- 必须向用户明确说明违规情况并道歉
|
|
87
|
+
1. **UI 设计流程**(推荐):按 AODW UI 规范设计原型,等待确认
|
|
88
|
+
2. **UI 审计流程**:按 AODW UI 规范审计现有界面,提供改进建议
|
|
89
|
+
3. **UI 找问题流程**:按 AODW UI 规范找出界面问题,提供修复建议
|
|
324
90
|
|
|
325
91
|
---
|
|
326
92
|
|
|
327
|
-
##
|
|
328
|
-
|
|
329
|
-
- `.aodw/03-standards/ui-kit/ui-kit.md` - 统一 UI 设计规范(合并文件,包含所有 UI 设计规范)
|
|
330
|
-
- 第 1 节:UI 设计系统(统一审美与设计约束)
|
|
331
|
-
- 第 2 节:UI 生成提示词(所有 UI 生成的"总提示词")
|
|
332
|
-
- 第 3 节:禁止的 AI 风格(明确禁止的 AI 审美)
|
|
333
|
-
- 第 4 节:UI Critic Agent(专门「挑丑」的 AI Agent)
|
|
93
|
+
## 6. 禁止行为
|
|
334
94
|
|
|
95
|
+
⚠️ **严禁以下行为**:
|
|
96
|
+
- ❌ 生成实现代码(HTML 原型仅包含结构和布局)
|
|
97
|
+
- ❌ 跳过 HTML 原型阶段
|
|
98
|
+
- ❌ 未经确认进入实现阶段
|
|
99
|
+
- ❌ 不遵循项目 UI 设计系统(如有)
|
|
@@ -11,16 +11,16 @@
|
|
|
11
11
|
在进行任何非琐碎(非机械重复)操作前,AI 必须:
|
|
12
12
|
|
|
13
13
|
1. **读取核心文档**:
|
|
14
|
-
- `.aodw/01-core/aodw-constitution.md`
|
|
15
|
-
- `.aodw/06-project/ai-overview.md`
|
|
16
|
-
- `.aodw/03-standards/ai-coding-rules.md`(本文件)
|
|
17
|
-
- `.aodw/01-core/ai-knowledge-rules.md`
|
|
14
|
+
- `.aodw-next/01-core/aodw-constitution.md`
|
|
15
|
+
- `.aodw-next/06-project/ai-overview.md`
|
|
16
|
+
- `.aodw-next/03-standards/ai-coding-rules.md`(本文件)
|
|
17
|
+
- `.aodw-next/01-core/ai-knowledge-rules.md`
|
|
18
18
|
|
|
19
19
|
2. **按需加载开发规范**(根据任务类型):
|
|
20
|
-
- **通用编码规范**:必须读取 `.aodw/03-standards/ai-coding-rules-common.md`(文件大小、复杂度、拆分原则等)
|
|
20
|
+
- **通用编码规范**:必须读取 `.aodw-next/03-standards/ai-coding-rules-common.md`(文件大小、复杂度、拆分原则等)
|
|
21
21
|
- **如果涉及前端开发**:必须读取对应的栈规范(React: `stacks/react-typescript/...`, Vue2: `stacks/vue2/...`)
|
|
22
22
|
- **如果涉及后端开发**:必须读取对应的栈规范(Python: `stacks/python-fastapi/...`, Java: `stacks/java-springboot/...`)
|
|
23
|
-
- **如果涉及 UI 设计**:必须读取 `.aodw/
|
|
23
|
+
- **如果涉及 UI 设计**:必须读取 `.aodw-next/03-standards/ui-kit/ui-kit.md`
|
|
24
24
|
|
|
25
25
|
**判断任务类型的依据**:
|
|
26
26
|
- **代码路径**:
|
|
@@ -59,6 +59,72 @@
|
|
|
59
59
|
|
|
60
60
|
---
|
|
61
61
|
|
|
62
|
+
## 1.5 LLM 编码行为基线(防失误)
|
|
63
|
+
|
|
64
|
+
> 目标:减少 AI 过度实现、静默假设、无关重构与“改完才澄清”的问题。
|
|
65
|
+
> 原则:在多数任务中优先稳健性,高于执行速度;对琐碎任务可适度简化。
|
|
66
|
+
|
|
67
|
+
### A. 先想后写(Think Before Coding)
|
|
68
|
+
|
|
69
|
+
在开始实现前,AI 必须显式给出:
|
|
70
|
+
|
|
71
|
+
1. **假设声明**:列出关键假设(输入、边界、依赖、预期行为)。
|
|
72
|
+
2. **不确定性声明**:如存在歧义,必须列出 2+ 种解释,不得静默选择其一。
|
|
73
|
+
3. **简化选项说明**:若存在更小改动方案,必须说明并优先推荐。
|
|
74
|
+
4. **阻断提问机制**:关键信息缺失时,必须暂停实现并提问,不得“先写后问”。
|
|
75
|
+
|
|
76
|
+
### B. 简单优先(Simplicity First)
|
|
77
|
+
|
|
78
|
+
AI 必须遵守最小实现原则:
|
|
79
|
+
|
|
80
|
+
- 不实现用户未请求的能力(禁止 scope creep)
|
|
81
|
+
- 不为一次性逻辑引入抽象层
|
|
82
|
+
- 不为“未来可能”增加配置项
|
|
83
|
+
- 不为不可能场景添加防御性错误处理
|
|
84
|
+
|
|
85
|
+
**自检问题(必须)**:
|
|
86
|
+
“当前方案是否被资深工程师认为过度设计?”
|
|
87
|
+
若答案是“可能是”,必须先简化再实现。
|
|
88
|
+
|
|
89
|
+
### C. 外科手术式修改(Surgical Changes)
|
|
90
|
+
|
|
91
|
+
AI 在修改现有代码时必须:
|
|
92
|
+
|
|
93
|
+
1. 仅修改与当前请求直接相关的代码行;
|
|
94
|
+
2. 不顺手重构、重排、格式化无关代码;
|
|
95
|
+
3. 保持原有代码风格(除非用户要求统一风格);
|
|
96
|
+
4. 仅清理由本次改动引入的孤儿代码(unused import/var/function)。
|
|
97
|
+
|
|
98
|
+
如果发现预存死代码或可优化点:**只记录,不自动处理**。
|
|
99
|
+
|
|
100
|
+
### D. 目标驱动执行(Goal-Driven Execution)
|
|
101
|
+
|
|
102
|
+
AI 必须把需求改写为可验证目标,并形成“实现-验证”闭环:
|
|
103
|
+
|
|
104
|
+
- Bug 修复:先构造复现(测试或步骤),再修复并验证通过
|
|
105
|
+
- 行为增强:先定义成功判据,再实现并验证
|
|
106
|
+
- 重构任务:确保变更前后行为等价(测试或关键路径回归)
|
|
107
|
+
|
|
108
|
+
对于多步骤任务,必须先给出简要计划(步骤 + 对应验证方式)。
|
|
109
|
+
|
|
110
|
+
### E. 实现前最小输出模板(建议在 plan/回复中复用)
|
|
111
|
+
|
|
112
|
+
```markdown
|
|
113
|
+
## 实现前对齐
|
|
114
|
+
- 假设:
|
|
115
|
+
- ...
|
|
116
|
+
- 歧义点:
|
|
117
|
+
- 解释 A:...
|
|
118
|
+
- 解释 B:...
|
|
119
|
+
- 推荐:A(理由:...)
|
|
120
|
+
- 最小可行改动:
|
|
121
|
+
- ...
|
|
122
|
+
- 成功标准(可验证):
|
|
123
|
+
- ...
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
---
|
|
127
|
+
|
|
62
128
|
## 2. 影响分析(Impact Analysis)
|
|
63
129
|
|
|
64
130
|
在提出任何解决方案之前,AI 必须生成一份影响分析,并写入当前 RT 的 `impact.md`(或更新之)。
|
|
@@ -97,7 +163,7 @@
|
|
|
97
163
|
|
|
98
164
|
1. 打开并检查:
|
|
99
165
|
- `RT/RT-XXX/invariants.md`(如果存在)
|
|
100
|
-
- `.aodw/06-project/ai-overview.md` 中的系统级 Invariants
|
|
166
|
+
- `.aodw-next/06-project/ai-overview.md` 中的系统级 Invariants
|
|
101
167
|
2. 在 `invariants.md` 中列出本次改动必须保持的条件,例如:
|
|
102
168
|
|
|
103
169
|
```markdown
|
|
@@ -126,7 +192,7 @@ AI 提出变更方案时,应:
|
|
|
126
192
|
4. 允许用户选择“推荐方案”或指定其他选项。
|
|
127
193
|
|
|
128
194
|
在 Spec-Full 流程中,方案设计应记录在 `plan.md`;
|
|
129
|
-
在 Spec-Lite 流程中,记录在 `
|
|
195
|
+
在 Spec-Lite 流程中,记录在 `rt-lite.md` §2。
|
|
130
196
|
|
|
131
197
|
---
|
|
132
198
|
|
|
@@ -170,7 +236,7 @@ AI 提出变更方案时,应:
|
|
|
170
236
|
|
|
171
237
|
## 7. Git Discipline(完成与合并规则)
|
|
172
238
|
|
|
173
|
-
所有 Git 操作必须严格遵循 `.aodw/01-core/git-discipline.md` 中定义的规范,包括:
|
|
239
|
+
所有 Git 操作必须严格遵循 `.aodw-next/01-core/git-discipline.md` 中定义的规范,包括:
|
|
174
240
|
|
|
175
241
|
- **分支命名**:`feature/RT-XXX-short-name`
|
|
176
242
|
- **提交信息格式**:Conventional Commits + `Refs: RT-XXX`
|
|
@@ -186,10 +252,10 @@ AI 在完成 RT 时,应提示用户执行完整的 Git Discipline 流程,或
|
|
|
186
252
|
|
|
187
253
|
## 8. 代码复杂度与输出规范 (Complexity & Output Standards)
|
|
188
254
|
|
|
189
|
-
> **注意**:本节的详细规范已移至 `.aodw/03-standards/ai-coding-rules-common.md`。
|
|
255
|
+
> **注意**:本节的详细规范已移至 `.aodw-next/03-standards/ai-coding-rules-common.md`。
|
|
190
256
|
> 所有开发任务都必须读取该文件,了解文件大小限制、复杂度控制、拆分原则和输出策略。
|
|
191
257
|
|
|
192
|
-
**必须读取**:`.aodw/03-standards/ai-coding-rules-common.md`
|
|
258
|
+
**必须读取**:`.aodw-next/03-standards/ai-coding-rules-common.md`
|
|
193
259
|
|
|
194
260
|
该文件包含:
|
|
195
261
|
- 全局文件长度限制(软上限)
|
|
@@ -207,7 +273,7 @@ AI 在完成 RT 时,应提示用户执行完整的 Git Discipline 流程,或
|
|
|
207
273
|
|
|
208
274
|
### 9.1 通用编码规范
|
|
209
275
|
|
|
210
|
-
**文件**:`.aodw/03-standards/ai-coding-rules-common.md`
|
|
276
|
+
**文件**:`.aodw-next/03-standards/ai-coding-rules-common.md`
|
|
211
277
|
|
|
212
278
|
**适用场景**:所有类型的代码开发
|
|
213
279
|
|
|
@@ -224,7 +290,7 @@ AI 在完成 RT 时,应提示用户执行完整的 Git Discipline 流程,或
|
|
|
224
290
|
|
|
225
291
|
### 9.2 前端开发规范
|
|
226
292
|
|
|
227
|
-
**文件**:`.aodw/03-standards/stacks/react-typescript/ai-coding-rules-frontend.md`
|
|
293
|
+
**文件**:`.aodw-next/03-standards/stacks/react-typescript/ai-coding-rules-frontend.md`
|
|
228
294
|
|
|
229
295
|
**适用场景**:
|
|
230
296
|
- 前端开发(React + TypeScript + Vite)
|
|
@@ -254,7 +320,7 @@ AI 在完成 RT 时,应提示用户执行完整的 Git Discipline 流程,或
|
|
|
254
320
|
|
|
255
321
|
### 9.3 前端开发规范 (Vue 2)
|
|
256
322
|
|
|
257
|
-
**文件**:`.aodw/03-standards/stacks/vue2/ai-coding-rules-frontend.md`
|
|
323
|
+
**文件**:`.aodw-next/03-standards/stacks/vue2/ai-coding-rules-frontend.md`
|
|
258
324
|
|
|
259
325
|
**适用场景**:
|
|
260
326
|
- 前端开发(Vue 2.6 + Webpack 4)
|
|
@@ -272,7 +338,7 @@ AI 在完成 RT 时,应提示用户执行完整的 Git Discipline 流程,或
|
|
|
272
338
|
|
|
273
339
|
### 9.4 后端开发规范 (Python FastAPI)
|
|
274
340
|
|
|
275
|
-
**文件**:`.aodw/03-standards/stacks/python-fastapi/ai-coding-rules-backend.md`
|
|
341
|
+
**文件**:`.aodw-next/03-standards/stacks/python-fastapi/ai-coding-rules-backend.md`
|
|
276
342
|
|
|
277
343
|
**适用场景**:
|
|
278
344
|
- 后端开发(FastAPI / Python、Node.js、Go 等)
|
|
@@ -304,7 +370,7 @@ AI 在完成 RT 时,应提示用户执行完整的 Git Discipline 流程,或
|
|
|
304
370
|
|
|
305
371
|
### 9.5 后端开发规范 (Java SpringBoot)
|
|
306
372
|
|
|
307
|
-
**文件**:`.aodw/03-standards/stacks/java-springboot/ai-coding-rules-backend.md`
|
|
373
|
+
**文件**:`.aodw-next/03-standards/stacks/java-springboot/ai-coding-rules-backend.md`
|
|
308
374
|
|
|
309
375
|
**适用场景**:
|
|
310
376
|
- 后端开发(Java 21 + Spring Boot 2.7)
|
|
@@ -321,7 +387,7 @@ AI 在完成 RT 时,应提示用户执行完整的 Git Discipline 流程,或
|
|
|
321
387
|
|
|
322
388
|
### 9.6 UI 设计规范(将来)
|
|
323
389
|
|
|
324
|
-
**文件**:`.aodw/
|
|
390
|
+
**文件**:`.aodw-next/03-standards/ui-kit/ui-kit.md`
|
|
325
391
|
|
|
326
392
|
**适用场景**:
|
|
327
393
|
- UI 设计
|
|
@@ -334,7 +400,7 @@ AI 在完成 RT 时,应提示用户执行完整的 Git Discipline 流程,或
|
|
|
334
400
|
|
|
335
401
|
### 9.7 工具初始化规则
|
|
336
402
|
|
|
337
|
-
**文件**:`.aodw/05-tooling/ai-tools-init-rules.md`
|
|
403
|
+
**文件**:`.aodw-next/05-tooling/ai-tools-init-rules.md`
|
|
338
404
|
|
|
339
405
|
**适用场景**:
|
|
340
406
|
- 用户说"初始化工具"、"设置开发工具"、"配置工具"等
|
|
@@ -360,11 +426,11 @@ AI 在执行开发任务时,必须按以下流程加载规范:
|
|
|
360
426
|
1. **第一步**:读取核心文档(见第 0 节)
|
|
361
427
|
2. **第二步**:判断任务类型(根据代码路径、文件类型、RT 文档、用户说明)
|
|
362
428
|
3. **第三步**:按需加载开发规范:
|
|
363
|
-
- **必须**读取 `.aodw/03-standards/ai-coding-rules-common.md`(通用规范)
|
|
364
|
-
- **如果涉及前端 (React)**:读取 `.aodw/03-standards/stacks/react-typescript/ai-coding-rules-frontend.md`
|
|
365
|
-
- **如果涉及前端 (Vue 2)**:读取 `.aodw/03-standards/stacks/vue2/ai-coding-rules-frontend.md`
|
|
366
|
-
- **如果涉及后端 (Python)**:读取 `.aodw/03-standards/stacks/python-fastapi/ai-coding-rules-backend.md`
|
|
367
|
-
- **如果涉及后端 (Java)**:读取 `.aodw/03-standards/stacks/java-springboot/ai-coding-rules-backend.md`
|
|
368
|
-
- **如果涉及 UI 设计**:读取 `.aodw/
|
|
369
|
-
- **如果用户表达工具初始化意图**:读取 `.aodw/05-tooling/ai-tools-init-rules.md`
|
|
429
|
+
- **必须**读取 `.aodw-next/03-standards/ai-coding-rules-common.md`(通用规范)
|
|
430
|
+
- **如果涉及前端 (React)**:读取 `.aodw-next/03-standards/stacks/react-typescript/ai-coding-rules-frontend.md`
|
|
431
|
+
- **如果涉及前端 (Vue 2)**:读取 `.aodw-next/03-standards/stacks/vue2/ai-coding-rules-frontend.md`
|
|
432
|
+
- **如果涉及后端 (Python)**:读取 `.aodw-next/03-standards/stacks/python-fastapi/ai-coding-rules-backend.md`
|
|
433
|
+
- **如果涉及后端 (Java)**:读取 `.aodw-next/03-standards/stacks/java-springboot/ai-coding-rules-backend.md`
|
|
434
|
+
- **如果涉及 UI 设计**:读取 `.aodw-next/03-standards/ui-kit/ui-kit.md`
|
|
435
|
+
- **如果用户表达工具初始化意图**:读取 `.aodw-next/05-tooling/ai-tools-init-rules.md`
|
|
370
436
|
4. **第四步**:根据规范执行开发任务
|
|
@@ -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
|
**适用场景**:
|
|
@@ -24,9 +24,9 @@
|
|
|
24
24
|
- **消息中间件**:RabbitMQ
|
|
25
25
|
|
|
26
26
|
**必须与以下规范配合使用**:
|
|
27
|
-
- `.aodw/03-standards/ai-coding-rules.md`(主文件,包含通用原则)
|
|
28
|
-
- `.aodw/03-standards/ai-coding-rules-common.md`(通用编码规范)
|
|
29
|
-
- `.aodw/05-tooling/ai-tools-init-rules.md`(工具初始化规则,如果通过 AI 方式初始化工具)
|
|
27
|
+
- `.aodw-next/03-standards/ai-coding-rules.md`(主文件,包含通用原则)
|
|
28
|
+
- `.aodw-next/03-standards/ai-coding-rules-common.md`(通用编码规范)
|
|
29
|
+
- `.aodw-next/05-tooling/ai-tools-init-rules.md`(工具初始化规则,如果通过 AI 方式初始化工具)
|
|
30
30
|
|
|
31
31
|
**⚠️ 强制要求**:所有后端开发必须严格遵守 `docs/backend-guidelines.md` 中的规范(如果存在)。
|
|
32
32
|
|
|
@@ -44,10 +44,10 @@
|
|
|
44
44
|
|
|
45
45
|
**AI 必须检查**:
|
|
46
46
|
- [ ] 是否已运行工具初始化?
|
|
47
|
-
- [ ] `.aodw/tools-status.yaml` 中 `initialized: true` 且后端工具状态为 `configured: true`?
|
|
47
|
+
- [ ] `.aodw-next/tools-status.yaml` 中 `initialized: true` 且后端工具状态为 `configured: true`?
|
|
48
48
|
|
|
49
49
|
**检查方法**:
|
|
50
|
-
1. 读取 `.aodw/tools-status.yaml` 文件
|
|
50
|
+
1. 读取 `.aodw-next/tools-status.yaml` 文件
|
|
51
51
|
2. 检查 `tools_init.initialized` 是否为 `true`
|
|
52
52
|
3. 检查 `tools_init.backend.maven.configured` 是否为 `true`(Maven 依赖管理)
|
|
53
53
|
4. 检查 `tools_init.backend.checkstyle.configured` 是否为 `true`(如果使用 Checkstyle)
|
|
@@ -87,7 +87,7 @@
|
|
|
87
87
|
|
|
88
88
|
### 2.4 工具配置参考
|
|
89
89
|
|
|
90
|
-
**配置模板位置**:`.aodw/templates/tools-config/backend/`
|
|
90
|
+
**配置模板位置**:`.aodw-next/templates/tools-config/backend/`
|
|
91
91
|
- Checkstyle 配置模板:`checkstyle.config.template.xml`(如果存在)
|
|
92
92
|
- Spotless 配置模板:`spotless.config.template.xml`(如果存在)
|
|
93
93
|
- pre-commit 配置模板:`pre-commit.config.template.yaml`
|
|
@@ -184,10 +184,10 @@ backend/
|
|
|
184
184
|
|
|
185
185
|
在提交 Java 代码前,必须完成以下检查:
|
|
186
186
|
|
|
187
|
-
### 8.1 工具初始化检查(参考 `.aodw/03-standards/stacks/java-springboot/ai-coding-rules-backend.md` 第 2 节)
|
|
187
|
+
### 8.1 工具初始化检查(参考 `.aodw-next/03-standards/stacks/java-springboot/ai-coding-rules-backend.md` 第 2 节)
|
|
188
188
|
|
|
189
189
|
- [ ] **工具是否已初始化**:
|
|
190
|
-
- [ ] 检查 `.aodw/tools-status.yaml` 中 `initialized: true`
|
|
190
|
+
- [ ] 检查 `.aodw-next/tools-status.yaml` 中 `initialized: true`
|
|
191
191
|
- [ ] **Maven** 是否已安装并配置?
|
|
192
192
|
- [ ] **Checkstyle** 是否已安装并配置?(如果使用)
|
|
193
193
|
- [ ] **Spotless** 是否已安装并配置?(如果使用)
|