aodw-skill 0.7.18 → 0.7.22
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-project-overview-rules.md +5 -5
- package/.aodw-next/01-core/csf-thinking-framework.md +1 -1
- package/.aodw-next/02-workflow/rt-manager.md +22 -1
- package/.aodw-next/02-workflow/ui-workflow-rules.md +0 -3
- package/.aodw-next/05-tooling/ai-tools-init-rules.md +2 -2
- package/.aodw-next/README.md +0 -1
- package/.aodw-next/SKILL.md +5 -5
- package/.aodw-next/manifest.yaml +0 -5
- package/AODW_Adapters/README.md +24 -31
- package/README.md +10 -15
- package/bin/aodw.js +53 -123
- package/bin/processors/index.js +1 -35
- package/bin/update-adapters-from-template.js +1 -15
- package/package.json +4 -4
- package/.aodw-next/01-core/ai-interaction-rules-summary.md +0 -37
- package/.aodw-next/01-core/ai-knowledge-rules-summary.md +0 -25
- package/.aodw-next/01-core/git-discipline-summary.md +0 -36
- package/.aodw-next/02-workflow/rt-id-generation-rules.md +0 -24
- package/.aodw-next/02-workflow/rt-manager-summary.md +0 -15
- package/.aodw-next/02-workflow/ui-workflow-rules-summary.md +0 -39
- package/.aodw-next/03-standards/stacks/rust-axum/ai-coding-rules-backend.md +0 -134
- package/.aodw-next/06-project/README.md +0 -16
- package/.aodw-next/07-optimization/token-usage-analysis.md +0 -253
- package/.aodw-next/templates/TEMPLATE-APPLICATION-GUIDE.md +0 -110
- package/.aodw-next/templates/audit-report-template.md +0 -232
- package/.aodw-next/templates/changelog-template.md +0 -16
- package/.aodw-next/templates/checklists/coding-standards-template.md +0 -130
- package/.aodw-next/templates/csf-review-template.md +0 -201
- package/.aodw-next/templates/impact-template.md +0 -17
- package/.aodw-next/templates/invariants-template.md +0 -12
- package/.aodw-next/templates/plan-lite-template.md +0 -20
- package/.aodw-next/templates/rt-decision-template.md +0 -13
- package/.aodw-next/templates/rt-intake-template.md +0 -33
- package/.aodw-next/templates/spec-lite-template.md +0 -26
- package/.aodw-next/templates/tests-template.md +0 -13
- package/.aodw-next/templates/tools-config/README.md +0 -112
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-check.md +0 -7
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-done.md +0 -7
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-full.md +0 -7
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-governance.md +0 -7
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-impact.md +0 -7
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-init.md +0 -7
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-invariants.md +0 -7
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-lite.md +0 -7
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-module.md +0 -7
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-new.md +0 -7
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-open.md +0 -7
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-pause.md +0 -7
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-resume.md +0 -7
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-tests.md +0 -7
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-upgrade.md +0 -7
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw.md +0 -35
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-check.md +0 -16
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-done.md +0 -16
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-full.md +0 -14
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-governance.md +0 -13
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-impact.md +0 -13
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-init.md +0 -13
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-invariants.md +0 -13
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-lite.md +0 -14
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-module.md +0 -13
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-new.md +0 -30
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-open.md +0 -10
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-pause.md +0 -12
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-resume.md +0 -12
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-tests.md +0 -13
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-upgrade.md +0 -12
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw.md +0 -18
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/claude/CLAUDE.md +0 -17
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-check.md +0 -30
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-done.md +0 -52
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-full.md +0 -31
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-governance.md +0 -34
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-impact.md +0 -25
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-init.md +0 -75
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-invariants.md +0 -29
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-lite.md +0 -23
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-module.md +0 -24
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-new.md +0 -70
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-open.md +0 -19
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-pause.md +0 -19
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-resume.md +0 -20
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-tests.md +0 -26
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-upgrade.md +0 -27
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw.md +0 -69
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/deploypromote.md +0 -20
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/featuretotester.md +0 -32
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/deploy/feature_to_master_push_test_local.sh +0 -390
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/deploy/promote_only.sh +0 -210
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/deploy/rollback_prod.sh +0 -99
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/rules/aodw.mdc +0 -26
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-check.md +0 -29
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-done.md +0 -52
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-full.md +0 -30
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-governance.md +0 -33
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-impact.md +0 -24
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-init.md +0 -75
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-invariants.md +0 -28
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-lite.md +0 -22
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-module.md +0 -23
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-new.md +0 -92
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-open.md +0 -18
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-pause.md +0 -18
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-resume.md +0 -19
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-tests.md +0 -25
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-upgrade.md +0 -26
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw.md +0 -68
- package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/GEMINI.md +0 -17
- package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/.agent/rules/aodw-analyze.md +0 -15
- package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/.agent/rules/aodw-complete.md +0 -15
- package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/.agent/rules/aodw-control.md +0 -14
- package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/.agent/rules/aodw-decide.md +0 -16
- package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/.agent/rules/aodw-governance.md +0 -7
- package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/.agent/rules/aodw-implement.md +0 -16
- package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/.agent/rules/aodw-init.md +0 -7
- package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/.agent/rules/aodw-intake.md +0 -15
- package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/.agent/rules/aodw-open.md +0 -7
- package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/.agent/rules/aodw-simplified.md +0 -107
- package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/.agent/rules/aodw-verify.md +0 -14
- package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/global_workflows/aodw-analyze.md +0 -24
- package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/global_workflows/aodw-complete.md +0 -23
- package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/global_workflows/aodw-control.md +0 -21
- package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/global_workflows/aodw-decide.md +0 -26
- package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/global_workflows/aodw-governance.md +0 -13
- package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/global_workflows/aodw-implement.md +0 -21
- package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/global_workflows/aodw-init.md +0 -13
- package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/global_workflows/aodw-intake.md +0 -28
- package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/global_workflows/aodw-open.md +0 -10
- package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/global_workflows/aodw-verify.md +0 -20
- package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/global_workflows/aodw.md +0 -18
- package/AODW_Adapters/gemini/.agent/rules/aodw-next.md +0 -70
- package/AODW_Adapters/gemini/GEMINI.md +0 -18
- package/AODW_Adapters/general/.github/copilot-instructions.md +0 -34
- package/AODW_Adapters/general/AGENTS.md +0 -70
- package/docs/README.md +0 -26
- package/docs/adapter-evaluation.md +0 -55
- package/docs/backend-guidelines.md +0 -335
- package/docs/frontend-guidelines.md +0 -266
- package/docs/installation-variants.md +0 -88
- package/docs/migration-guide-0.2.0.md +0 -250
- package/docs/platform-matrix.md +0 -83
|
@@ -1,266 +0,0 @@
|
|
|
1
|
-
当“前端圣经”用的规范文档。
|
|
2
|
-
内容包括:
|
|
3
|
-
• 用什么工具约束代码质量 & 目录结构
|
|
4
|
-
• 适配你现有栈(React 19 + TS + Vite + Tailwind + Radix + Zustand)
|
|
5
|
-
• 带目录结构、命名、代码风格 & AI 使用规则
|
|
6
|
-
|
|
7
|
-
前端开发规范(面向 AI & 人类开发者)
|
|
8
|
-
|
|
9
|
-
适用项目技术栈:
|
|
10
|
-
• 框架:React 18/19 + TypeScript + Vite
|
|
11
|
-
• UI:Tailwind CSS + Radix UI + 自定义组件库
|
|
12
|
-
• 状态:Zustand
|
|
13
|
-
• 工具:ESLint + Prettier
|
|
14
|
-
• 使用场景:人类开发 + AI 工具(Cursor、Claude Code 等)
|
|
15
|
-
|
|
16
|
-
⸻
|
|
17
|
-
|
|
18
|
-
1. 工具与质量控制
|
|
19
|
-
|
|
20
|
-
1.1 代码质量工具
|
|
21
|
-
• ESLint:统一代码风格 & 代码质量
|
|
22
|
-
• 规则推荐:
|
|
23
|
-
• @typescript-eslint(TS 规则)
|
|
24
|
-
• eslint-plugin-react
|
|
25
|
-
• eslint-plugin-react-hooks
|
|
26
|
-
• eslint-plugin-import
|
|
27
|
-
• eslint-plugin-jsx-a11y
|
|
28
|
-
• eslint-plugin-tailwindcss(可选,用于 Tailwind 排序&校验)
|
|
29
|
-
• Prettier:负责代码格式化(缩进、引号、分号等)
|
|
30
|
-
• 与 ESLint 配合使用:eslint-config-prettier 关闭 ESLint 中跟格式冲突的规则
|
|
31
|
-
|
|
32
|
-
1.2 目录 / 分层相关工具(可选但推荐)
|
|
33
|
-
• 使用 TypeScript path alias + ESLint import 规则 管理模块边界:
|
|
34
|
-
• paths:
|
|
35
|
-
• @app/* → src/app/*
|
|
36
|
-
• @pages/* → src/pages/*
|
|
37
|
-
• @features/* → src/features/*
|
|
38
|
-
• @shared/* → src/shared/*
|
|
39
|
-
• 配合 eslint-plugin-import 限制:
|
|
40
|
-
• pages 只能从 features / shared 引用
|
|
41
|
-
• features 不能直接引用其他 features 的内部实现(只能走公共入口)
|
|
42
|
-
|
|
43
|
-
说明:
|
|
44
|
-
目录结构本身没有“专门 lint 工具”,通常是通过
|
|
45
|
-
约定好的目录 + import 规则 + path alias 来间接约束。
|
|
46
|
-
|
|
47
|
-
1.3 文件大小 & 复杂度约束(ESLint)
|
|
48
|
-
建议在 ESLint 中统一限制(给 AI 也要强调):
|
|
49
|
-
• 单文件最大行数:
|
|
50
|
-
• 页面级组件:≤ 300 行(推荐 ≤ 250 行)
|
|
51
|
-
• 其他组件 / hooks / store:≤ 200 行
|
|
52
|
-
• 单个函数最大行数:≤ 60 行
|
|
53
|
-
• 复杂度控制:
|
|
54
|
-
• complexity ≤ 10
|
|
55
|
-
|
|
56
|
-
⸻
|
|
57
|
-
|
|
58
|
-
2. 目录结构规范
|
|
59
|
-
|
|
60
|
-
2.1 顶层结构
|
|
61
|
-
frontend/
|
|
62
|
-
src/
|
|
63
|
-
app/ # 应用入口、路由、全局 Provider
|
|
64
|
-
pages/ # 页面级(路由入口)
|
|
65
|
-
features/ # 可复用业务模块(跨页面)
|
|
66
|
-
shared/ # 跨业务通用:组件/工具/类型
|
|
67
|
-
config/ # 配置、环境相关
|
|
68
|
-
styles/ # 全局样式
|
|
69
|
-
assets/ # 静态资源
|
|
70
|
-
|
|
71
|
-
2.2 详细结构说明
|
|
72
|
-
src/
|
|
73
|
-
app/
|
|
74
|
-
router/ # 路由定义
|
|
75
|
-
providers/ # 全局 Provider(主题、QueryClient 等)
|
|
76
|
-
layout/ # 顶层布局(如 AppShell)
|
|
77
|
-
|
|
78
|
-
pages/
|
|
79
|
-
ProjectEditorPage/
|
|
80
|
-
index.tsx # 页面入口(路由组件)
|
|
81
|
-
Header.tsx
|
|
82
|
-
Sidebar.tsx
|
|
83
|
-
Canvas.tsx
|
|
84
|
-
Inspector.tsx
|
|
85
|
-
modals/
|
|
86
|
-
NodeCreateModal.tsx
|
|
87
|
-
NodeDeleteConfirmModal.tsx
|
|
88
|
-
hooks/
|
|
89
|
-
useProjectEditorData.ts
|
|
90
|
-
useProjectSelection.ts
|
|
91
|
-
store/
|
|
92
|
-
projectEditor.store.ts
|
|
93
|
-
|
|
94
|
-
ProjectListPage/
|
|
95
|
-
index.tsx
|
|
96
|
-
... # 结构类似,不展开
|
|
97
|
-
|
|
98
|
-
features/
|
|
99
|
-
project/
|
|
100
|
-
components/ # 项目相关可复用组件
|
|
101
|
-
hooks/ # 项目相关可复用 hooks
|
|
102
|
-
store/ # 项目相关 store(全局/跨页面)
|
|
103
|
-
api/ # 与项目相关的 API 封装
|
|
104
|
-
|
|
105
|
-
user/
|
|
106
|
-
components/
|
|
107
|
-
hooks/
|
|
108
|
-
store/
|
|
109
|
-
api/
|
|
110
|
-
|
|
111
|
-
shared/
|
|
112
|
-
components/ # 通用组件:Button、Card、Table、Dialog 等
|
|
113
|
-
hooks/ # 通用 hooks:useDebounce、useResizeObserver 等
|
|
114
|
-
store/ # 通用全局状态
|
|
115
|
-
utils/ # 工具函数:日期、格式化、日志
|
|
116
|
-
types/ # 通用类型/接口声明(如 PaginatedResult 等)
|
|
117
|
-
|
|
118
|
-
config/
|
|
119
|
-
env.ts # 环境变量读取封装
|
|
120
|
-
apiClient.ts # axios / fetch 封装
|
|
121
|
-
|
|
122
|
-
styles/
|
|
123
|
-
globals.css
|
|
124
|
-
tailwind.css
|
|
125
|
-
|
|
126
|
-
规则:
|
|
127
|
-
• pages/:按路由拆目录,每个页面一个文件夹。
|
|
128
|
-
• features/:按业务域拆目录(project、user、auth…)。
|
|
129
|
-
• shared/:只能依赖 shared 自身,不依赖 pages 或 features。
|
|
130
|
-
• pages 可以依赖 features & shared;
|
|
131
|
-
features 可以依赖 shared,但尽量不要彼此深度耦合。
|
|
132
|
-
|
|
133
|
-
⸻
|
|
134
|
-
|
|
135
|
-
3. 命名规范
|
|
136
|
-
|
|
137
|
-
3.1 文件命名
|
|
138
|
-
• React 组件文件:帕斯卡命名(大驼峰)
|
|
139
|
-
• ProjectEditorPage/index.tsx
|
|
140
|
-
• Header.tsx, ProjectTable.tsx
|
|
141
|
-
• hooks 文件:useXxx.ts
|
|
142
|
-
• useProjectEditorData.ts
|
|
143
|
-
• useProjectSelection.ts
|
|
144
|
-
• Zustand store:
|
|
145
|
-
• xxx.store.ts(如 projectEditor.store.ts)
|
|
146
|
-
• 类型声明:
|
|
147
|
-
• xxx.types.ts 或集中放在 shared/types 中
|
|
148
|
-
• 工具函数:
|
|
149
|
-
• xxx.utils.ts 或放在 shared/utils 下
|
|
150
|
-
|
|
151
|
-
3.2 组件 & 变量命名
|
|
152
|
-
• 组件:PascalCase
|
|
153
|
-
• 变量 / 函数:camelCase
|
|
154
|
-
• 常量:SCREAMING_SNAKE_CASE
|
|
155
|
-
• hooks:以 use 开头,返回 [state, actions] 或对象
|
|
156
|
-
|
|
157
|
-
⸻
|
|
158
|
-
|
|
159
|
-
4. TypeScript 规范
|
|
160
|
-
• 启用严格模式:"strict": true
|
|
161
|
-
• 禁止滥用 any:
|
|
162
|
-
• 使用 unknown + 类型收窄 或 合理定义接口
|
|
163
|
-
• API 层优先使用:
|
|
164
|
-
• DTO 类型(请求)
|
|
165
|
-
• Response 类型(响应)
|
|
166
|
-
• 类型命名:
|
|
167
|
-
• 接口 / 类型:Project, ProjectDetail, UserProfile
|
|
168
|
-
• 不建议 IProject 这种前缀
|
|
169
|
-
|
|
170
|
-
⸻
|
|
171
|
-
|
|
172
|
-
5. React 编码规范
|
|
173
|
-
|
|
174
|
-
5.1 组件类型
|
|
175
|
-
• 优先使用函数组件 + Hooks:
|
|
176
|
-
• 不使用 class 组件
|
|
177
|
-
• 每个文件聚焦一个主要组件:
|
|
178
|
-
• 如果一个文件内存在多个复杂组件 → 拆文件
|
|
179
|
-
|
|
180
|
-
5.2 状态管理策略
|
|
181
|
-
• 页面局部状态:useState / useReducer
|
|
182
|
-
• 页面内复杂状态:页面专用 hooks/ + store/(Zustand)
|
|
183
|
-
• 跨页面共享业务状态:放在 features/*/store
|
|
184
|
-
• 全局通用状态:放在 shared/store
|
|
185
|
-
|
|
186
|
-
原则:能局部就不全局,能 hook 就不 store。
|
|
187
|
-
|
|
188
|
-
5.3 副作用 & 数据请求
|
|
189
|
-
• 所有数据请求封装在:
|
|
190
|
-
• features/*/api
|
|
191
|
-
• 或页面专用 hooks:pages/*/hooks
|
|
192
|
-
• 不在组件中直接调用 fetch/axios
|
|
193
|
-
→ 统一用 apiClient / 封装方法。
|
|
194
|
-
|
|
195
|
-
⸻
|
|
196
|
-
|
|
197
|
-
6. Tailwind & Radix 使用规范
|
|
198
|
-
|
|
199
|
-
6.1 Tailwind
|
|
200
|
-
• 使用 className 写原子类,尽量保持每个组件的 className 长度可读;
|
|
201
|
-
• 复杂样式组合抽离到:
|
|
202
|
-
• cn() 帮助函数结合条件类
|
|
203
|
-
• 或封装为组件,例如 <PrimaryButton />
|
|
204
|
-
• 不在逻辑代码里到处写硬编码颜色,优先用设计系统中的 token(在 Tailwind config 中定义)。
|
|
205
|
-
|
|
206
|
-
6.2 Radix UI
|
|
207
|
-
• Radix 组件作为“基础交互组件”,在 shared/components 中封装:
|
|
208
|
-
• 例如 Dialog、Popover、DropdownMenu 封装为:
|
|
209
|
-
• SharedDialog.tsx
|
|
210
|
-
• DropdownMenu.tsx
|
|
211
|
-
• 页面或业务组件不直接大量拼 Radix 基础元素,而是复用封装后的组件。
|
|
212
|
-
|
|
213
|
-
⸻
|
|
214
|
-
|
|
215
|
-
7. AI(Cursor / Claude 等)使用规则
|
|
216
|
-
|
|
217
|
-
本节是专门给 AI 的“硬约束”,建议原封不动写进系统提示。
|
|
218
|
-
|
|
219
|
-
7.1 基本要求
|
|
220
|
-
AI 在本项目中写前端代码时必须遵守:
|
|
221
|
-
1. 目录与分层:
|
|
222
|
-
• 新页面 → 必须放到 src/pages/<PageName>/ 下;
|
|
223
|
-
• 可复用业务逻辑 → 放到对应 src/features/<domain>/ 下;
|
|
224
|
-
• 通用组件 / hooks / 工具 → 放到 src/shared/ 下;
|
|
225
|
-
• 不允许把所有代码都写在一个目录或一个文件里。
|
|
226
|
-
2. 文件大小:
|
|
227
|
-
• 页面入口组件(index.tsx)≤ 300 行;
|
|
228
|
-
• 普通组件 / hooks / store 文件 ≤ 200 行;
|
|
229
|
-
• 单个函数 ≤ 60 行;
|
|
230
|
-
• 如果一个功能实现会超过限制:
|
|
231
|
-
• 必须先设计拆分方案(组件 / hooks / store 列表)
|
|
232
|
-
• 再按文件逐步实现,而不是一次性生成巨型文件。
|
|
233
|
-
3. 实现流程:
|
|
234
|
-
• 第一步:先给出【目录与文件拆分方案】,解释每个文件的职责;
|
|
235
|
-
• 第二步:按“每次一个文件”的方式生成代码;
|
|
236
|
-
• 第三步:在已有大文件重构时,优先拆分成多个小文件,而不是继续追加代码。
|
|
237
|
-
4. 代码风格:
|
|
238
|
-
• 使用函数组件 + Hooks;
|
|
239
|
-
• 使用 TypeScript,类型尽量完整;
|
|
240
|
-
• 遁守 ESLint / Prettier 风格(缩进、分号、引号不需要显式指定,但生成的代码要保证能通过常规规则)。
|
|
241
|
-
|
|
242
|
-
7.2 典型 AI Prompt 模板(示例)
|
|
243
|
-
用于新页面开发:
|
|
244
|
-
|
|
245
|
-
技术栈:React + TS + Vite + Tailwind + Radix + Zustand。
|
|
246
|
-
目录结构与命名请严格遵守本项目的前端规范。
|
|
247
|
-
目标:实现【XXX 页面】。
|
|
248
|
-
|
|
249
|
-
步骤 1:先只输出该页面对应的目录和文件拆分方案,目标是:
|
|
250
|
-
• 页面入口:src/pages/<PageName>/index.tsx
|
|
251
|
-
• 拆分独立的子组件、hooks、store,确保:
|
|
252
|
-
• 页面入口文件行数 ≤ 300 行;
|
|
253
|
-
• 其他文件 ≤ 200 行;
|
|
254
|
-
• 单个函数 ≤ 60 行。
|
|
255
|
-
|
|
256
|
-
步骤 2:在我确认拆分方案后,再逐个文件实现,每次只输出一个文件的完整代码。
|
|
257
|
-
|
|
258
|
-
⸻
|
|
259
|
-
|
|
260
|
-
8. 测试 & 可维护性(可选扩展)
|
|
261
|
-
|
|
262
|
-
如果后面增加测试,可以约定:
|
|
263
|
-
• 所有关键组件 / hooks 都有对应测试文件:
|
|
264
|
-
• ComponentName.test.tsx
|
|
265
|
-
• useHookName.test.ts
|
|
266
|
-
• 测试文件放在同级目录或 __tests__ 子目录中。
|
|
@@ -1,88 +0,0 @@
|
|
|
1
|
-
# AODW 双版本安装方案
|
|
2
|
-
|
|
3
|
-
本方案用于同时支持 legacy 与 next 两条路线,并确保互不影响。
|
|
4
|
-
|
|
5
|
-
## 1. 安装目标
|
|
6
|
-
|
|
7
|
-
- legacy:保持现有稳定方案
|
|
8
|
-
- next:引入三层架构优化(manifest + workflow-guide + summaries)
|
|
9
|
-
- 两套安装可并行存在,互不覆盖
|
|
10
|
-
|
|
11
|
-
## 2. 安装命令
|
|
12
|
-
|
|
13
|
-
### 2.1 legacy(稳定版)
|
|
14
|
-
|
|
15
|
-
```bash
|
|
16
|
-
npx aodw init
|
|
17
|
-
```
|
|
18
|
-
|
|
19
|
-
更新:
|
|
20
|
-
```bash
|
|
21
|
-
npx aodw update
|
|
22
|
-
```
|
|
23
|
-
|
|
24
|
-
卸载:
|
|
25
|
-
```bash
|
|
26
|
-
npx aodw uninstall
|
|
27
|
-
```
|
|
28
|
-
|
|
29
|
-
### 2.2 next(新方案线)
|
|
30
|
-
|
|
31
|
-
```bash
|
|
32
|
-
npx aodw-skill init
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
更新:
|
|
36
|
-
```bash
|
|
37
|
-
npx aodw-skill update
|
|
38
|
-
```
|
|
39
|
-
|
|
40
|
-
卸载:
|
|
41
|
-
```bash
|
|
42
|
-
npx aodw-skill uninstall
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
## 3. 安装路径与隔离
|
|
46
|
-
|
|
47
|
-
### 3.1 legacy 目录
|
|
48
|
-
|
|
49
|
-
- `.aodw/`
|
|
50
|
-
- 保持与现有 CLI 完全一致
|
|
51
|
-
|
|
52
|
-
### 3.2 next 目录
|
|
53
|
-
|
|
54
|
-
- `.aodw-next/`
|
|
55
|
-
- 不与 legacy 共享目录或文件
|
|
56
|
-
|
|
57
|
-
## 4. 适配器隔离原则
|
|
58
|
-
|
|
59
|
-
- legacy 继续写入原有适配器路径
|
|
60
|
-
- next 使用独立适配器路径(避免覆盖)
|
|
61
|
-
|
|
62
|
-
示例约定:
|
|
63
|
-
- legacy:`.aodw/` + `AODW_Adapters/`
|
|
64
|
-
- next:`.aodw-next/` + 独立命名文件(如 `aodw-next.mdc`)
|
|
65
|
-
|
|
66
|
-
适配器文件命名示例(next):
|
|
67
|
-
- Cursor:`.cursor/rules/aodw-next.mdc`
|
|
68
|
-
- Claude:`.claude/CLAUDE-NEXT.md`
|
|
69
|
-
- Antigravity/Gemini:`.agent/rules/aodw-next*.md`
|
|
70
|
-
- Gemini:`.gemini/GEMINI-NEXT.md`
|
|
71
|
-
|
|
72
|
-
## 5. 并行使用策略
|
|
73
|
-
|
|
74
|
-
1. legacy 线用于稳定生产项目
|
|
75
|
-
2. next 线用于试验与新用户
|
|
76
|
-
3. 两者升级互不影响
|
|
77
|
-
|
|
78
|
-
## 6. 兼容性说明
|
|
79
|
-
|
|
80
|
-
- 不强制依赖 Skills
|
|
81
|
-
- 保持多平台可用性(Cursor / Claude / Gemini 等)
|
|
82
|
-
|
|
83
|
-
## 7. 维护者打包说明
|
|
84
|
-
|
|
85
|
-
- 发布脚本会根据当前分支自动选择渠道:legacy / next
|
|
86
|
-
- `release/next` 或 `*-next*` 分支将发布 `aodw-skill`
|
|
87
|
-
- 其他分支默认发布 `aodw`
|
|
88
|
-
- next 渠道使用独立模板目录:`templates/.aodw-next`、`templates/AODW_Adapters_next`、`templates/docs-next`
|
|
@@ -1,250 +0,0 @@
|
|
|
1
|
-
# AODW 适配器重构 - 迁移指南
|
|
2
|
-
|
|
3
|
-
**版本**: 0.1.x → 0.2.0
|
|
4
|
-
**发布日期**: 2025-12-06
|
|
5
|
-
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
## 概述
|
|
9
|
-
|
|
10
|
-
AODW 0.2.0 版本对 Antigravity 平台的适配器规则进行了重构,简化了命令结构,提升了可用性。
|
|
11
|
-
|
|
12
|
-
### 主要变更
|
|
13
|
-
|
|
14
|
-
- ✅ 规则数量从 16 个精简为 11 个(用户可见 9 个)
|
|
15
|
-
- ✅ 按 RT 生命周期阶段重新组织命令
|
|
16
|
-
- ✅ 排除维护者专用命令(不会分发到用户项目)
|
|
17
|
-
- ✅ 符合"薄适配器"设计原则
|
|
18
|
-
|
|
19
|
-
---
|
|
20
|
-
|
|
21
|
-
## 命令对照表
|
|
22
|
-
|
|
23
|
-
### 旧版本 → 新版本 (v0.2.0)
|
|
24
|
-
|
|
25
|
-
| 旧命令 | 新命令 | 变化说明 |
|
|
26
|
-
| --------------------------------------------- | ----------------- | ----------------------------- |
|
|
27
|
-
| `/aodw-new` | `/aodw-intake` | 重命名,更符合立项流程语义 |
|
|
28
|
-
| `/aodw-lite` + `/aodw-full` + `/aodw-upgrade` | `/aodw-decide` | **合并**为一个决策命令 |
|
|
29
|
-
| `/aodw-impact` + `/aodw-invariants` | `/aodw-analyze` | **合并**为分析阶段命令 |
|
|
30
|
-
| `/aodw-tests` + `/aodw-module` | `/aodw-implement` | **合并**为实现阶段命令 |
|
|
31
|
-
| `/aodw-check` | `/aodw-verify` | 重命名,更清晰 |
|
|
32
|
-
| `/aodw-done` | `/aodw-complete` | 重命名,更清晰 |
|
|
33
|
-
| `/aodw-pause` + `/aodw-resume` | `/aodw-control` | **合并**为流程控制命令 |
|
|
34
|
-
| `/aodw-open` | `/aodw-open` | **保持不变** |
|
|
35
|
-
| `/aodw` | `/aodw` | **保持不变**(Kernel Loader) |
|
|
36
|
-
|
|
37
|
-
### 移除的命令(仅维护者可见)
|
|
38
|
-
|
|
39
|
-
| 命令 | 说明 | 影响 |
|
|
40
|
-
| ------------------ | ------------- | --------------------------------------------- |
|
|
41
|
-
| `/aodw-governance` | AODW 治理检查 | 不再分发给用户,仅在 AODW 仓库中使用 |
|
|
42
|
-
| `/aodw-init` | 初始化 AODW | CLI (`npx create-aodw init`) 已处理,无需手动 |
|
|
43
|
-
|
|
44
|
-
---
|
|
45
|
-
|
|
46
|
-
## 迁移步骤
|
|
47
|
-
|
|
48
|
-
### 对于新用户
|
|
49
|
-
|
|
50
|
-
无需任何操作,直接使用新版本即可:
|
|
51
|
-
|
|
52
|
-
```bash
|
|
53
|
-
npx create-aodw init
|
|
54
|
-
```
|
|
55
|
-
|
|
56
|
-
### 对于现有用户
|
|
57
|
-
|
|
58
|
-
#### 选项 1:更新到最新版本
|
|
59
|
-
|
|
60
|
-
```bash
|
|
61
|
-
# 更新 AODW(会覆盖现有 .agent/rules 和 .agent/workflows)
|
|
62
|
-
npx create-aodw init
|
|
63
|
-
```
|
|
64
|
-
|
|
65
|
-
**注意**:如果你自定义了规则文件,请先备份。
|
|
66
|
-
|
|
67
|
-
#### 选项 2:继续使用旧版本
|
|
68
|
-
|
|
69
|
-
如果你已经习惯了旧命令,可以继续使用 v3.1.0:
|
|
70
|
-
|
|
71
|
-
```bash
|
|
72
|
-
# 不运行 init 命令,保持现有配置
|
|
73
|
-
```
|
|
74
|
-
|
|
75
|
-
但建议尽快迁移到新版本,以获得更好的体验。
|
|
76
|
-
|
|
77
|
-
---
|
|
78
|
-
|
|
79
|
-
## 新命令使用指南
|
|
80
|
-
|
|
81
|
-
### 1. `/aodw-intake` - 创建新 RT
|
|
82
|
-
|
|
83
|
-
**用途**: 替代原 `/aodw-new`
|
|
84
|
-
|
|
85
|
-
**使用场景**:
|
|
86
|
-
- 创建新功能
|
|
87
|
-
- 修复 Bug
|
|
88
|
-
- 性能优化
|
|
89
|
-
- 代码重构
|
|
90
|
-
|
|
91
|
-
**示例**:
|
|
92
|
-
```
|
|
93
|
-
你: "创建一个新RT,我想添加用户登录功能"
|
|
94
|
-
AI: (自动运行 /aodw-intake)
|
|
95
|
-
```
|
|
96
|
-
|
|
97
|
-
### 2. `/aodw-decide` - 选择开发模式
|
|
98
|
-
|
|
99
|
-
**用途**: 替代原 `/aodw-lite`, `/aodw-full`, `/aodw-upgrade`
|
|
100
|
-
|
|
101
|
-
**使用场景**:
|
|
102
|
-
- 选择 Spec-Full 或 Spec-Lite
|
|
103
|
-
- 从 Spec-Lite 升级到 Spec-Full
|
|
104
|
-
|
|
105
|
-
**示例**:
|
|
106
|
-
```
|
|
107
|
-
你: "这个改动比较复杂,用 Spec-Full"
|
|
108
|
-
AI: (自动运行 /aodw-decide,选择 Spec-Full)
|
|
109
|
-
```
|
|
110
|
-
|
|
111
|
-
### 3. `/aodw-analyze` - 分析阶段
|
|
112
|
-
|
|
113
|
-
**用途**: 替代原 `/aodw-impact`, `/aodw-invariants`
|
|
114
|
-
|
|
115
|
-
**使用场景**:
|
|
116
|
-
- 分析影响范围
|
|
117
|
-
- 确定不变量
|
|
118
|
-
|
|
119
|
-
**示例**:
|
|
120
|
-
```
|
|
121
|
-
你: "分析一下这个改动的影响"
|
|
122
|
-
AI: (自动运行 /aodw-analyze,更新 impact.md 和 invariants.md)
|
|
123
|
-
```
|
|
124
|
-
|
|
125
|
-
### 4. `/aodw-implement` - 实现阶段
|
|
126
|
-
|
|
127
|
-
**用途**: 替代原 `/aodw-tests`, `/aodw-module`
|
|
128
|
-
|
|
129
|
-
**使用场景**:
|
|
130
|
-
- 更新测试计划
|
|
131
|
-
- 更新模块文档
|
|
132
|
-
|
|
133
|
-
**示例**:
|
|
134
|
-
```
|
|
135
|
-
你: "代码写完了,更新一下测试和文档"
|
|
136
|
-
AI: (自动运行 /aodw-implement)
|
|
137
|
-
```
|
|
138
|
-
|
|
139
|
-
### 5. `/aodw-verify` - 验证阶段
|
|
140
|
-
|
|
141
|
-
**用途**: 替代原 `/aodw-check`
|
|
142
|
-
|
|
143
|
-
**使用场景**:
|
|
144
|
-
- 检查 RT 一致性
|
|
145
|
-
- 验证文档与代码匹配
|
|
146
|
-
|
|
147
|
-
**示例**:
|
|
148
|
-
```
|
|
149
|
-
你: "检查一下文档和代码是否一致"
|
|
150
|
-
AI: (自动运行 /aodw-verify)
|
|
151
|
-
```
|
|
152
|
-
|
|
153
|
-
### 6. `/aodw-complete` - 完成 RT
|
|
154
|
-
|
|
155
|
-
**用途**: 替代原 `/aodw-done`
|
|
156
|
-
|
|
157
|
-
**使用场景**:
|
|
158
|
-
- 合并代码
|
|
159
|
-
- 完成 RT
|
|
160
|
-
- 知识蒸馏
|
|
161
|
-
|
|
162
|
-
**示例**:
|
|
163
|
-
```
|
|
164
|
-
你: "完成这个 RT"
|
|
165
|
-
AI: (自动运行 /aodw-complete,合并分支)
|
|
166
|
-
```
|
|
167
|
-
|
|
168
|
-
### 7. `/aodw-control` - 流程控制
|
|
169
|
-
|
|
170
|
-
**用途**: 替代原 `/aodw-pause`, `/aodw-resume`
|
|
171
|
-
|
|
172
|
-
**使用场景**:
|
|
173
|
-
- 暂停 AODW 流程
|
|
174
|
-
- 恢复 AODW 流程
|
|
175
|
-
|
|
176
|
-
**示例**:
|
|
177
|
-
```
|
|
178
|
-
你: "暂停一下 AODW"
|
|
179
|
-
AI: (自动运行 /aodw-control,暂停流程)
|
|
180
|
-
|
|
181
|
-
你: "继续 AODW"
|
|
182
|
-
AI: (自动运行 /aodw-control,恢复流程)
|
|
183
|
-
```
|
|
184
|
-
|
|
185
|
-
---
|
|
186
|
-
|
|
187
|
-
## 常见问题 (FAQ)
|
|
188
|
-
|
|
189
|
-
### Q1: 为什么要合并命令?
|
|
190
|
-
|
|
191
|
-
**A**: 为了减少认知负担。原有 16 个命令过多,新版按 RT 生命周期阶段组织为 9 个,更易理解和使用。
|
|
192
|
-
|
|
193
|
-
### Q2: 旧命令还能用吗?
|
|
194
|
-
|
|
195
|
-
**A**: 旧命令已被移除。但新命令功能完全覆盖旧命令,只是名称和组织方式变化。
|
|
196
|
-
|
|
197
|
-
### Q3: 我自定义了规则,升级会覆盖吗?
|
|
198
|
-
|
|
199
|
-
**A**: 是的。如果你自定义了 `.agent/rules/` 下的文件,升级前请备份。
|
|
200
|
-
|
|
201
|
-
### Q4: 新版本有什么好处?
|
|
202
|
-
|
|
203
|
-
**A**:
|
|
204
|
-
- ✅ 命令更少,更易记
|
|
205
|
-
- ✅ 符合 RT 工作流,更直观
|
|
206
|
-
- ✅ 遵循薄适配器原则,更简洁
|
|
207
|
-
- ✅ 排除维护者命令,更专注
|
|
208
|
-
|
|
209
|
-
### Q5: 如何回退到旧版本?
|
|
210
|
-
|
|
211
|
-
**A**:
|
|
212
|
-
```bash
|
|
213
|
-
# 删除当前配置
|
|
214
|
-
rm -rf .agent
|
|
215
|
-
|
|
216
|
-
# 从备份恢复(如果有)
|
|
217
|
-
cp -r .agent.backup .agent
|
|
218
|
-
```
|
|
219
|
-
|
|
220
|
-
---
|
|
221
|
-
|
|
222
|
-
## 技术细节
|
|
223
|
-
|
|
224
|
-
### 薄适配器原则
|
|
225
|
-
|
|
226
|
-
新版本严格遵循"薄适配器"设计原则:
|
|
227
|
-
- 规则文件简洁(平均 367 字节)
|
|
228
|
-
- 不重复核心规范内容
|
|
229
|
-
- 通过引用指向详细文档
|
|
230
|
-
|
|
231
|
-
### 三层架构
|
|
232
|
-
|
|
233
|
-
```
|
|
234
|
-
Layer 1 (.aodw/) → 详细规则说明
|
|
235
|
-
Layer 2 (.agent/rules/) → 简洁触发器
|
|
236
|
-
Layer 3 (global_workflows/) → 具体操作步骤
|
|
237
|
-
```
|
|
238
|
-
|
|
239
|
-
每层职责清晰,避免重复。
|
|
240
|
-
|
|
241
|
-
---
|
|
242
|
-
|
|
243
|
-
## 获取帮助
|
|
244
|
-
|
|
245
|
-
如有问题,请查看:
|
|
246
|
-
- AODW 文档: `.aodw/README.md`
|
|
247
|
-
- 实施计划: `docs/aodw-adapter-refactoring-plan.md`
|
|
248
|
-
- 架构分析: `docs/aodw-rules-structure-analysis.md`
|
|
249
|
-
|
|
250
|
-
或联系 AODW 维护者。
|
package/docs/platform-matrix.md
DELETED
|
@@ -1,83 +0,0 @@
|
|
|
1
|
-
# AODW 平台适配矩阵 (Platform Support Matrix)
|
|
2
|
-
|
|
3
|
-
本文档详细定义了 AODW 在各个 AI 开发平台上的适配规范,是 CLI 实现的**唯一真理来源 (Single Source of Truth)**。
|
|
4
|
-
重点明确了 **Frontmatter 配置**,以确保规则在各种环境下都能被稳定触发和执行。
|
|
5
|
-
|
|
6
|
-
## 1. 核心概念
|
|
7
|
-
|
|
8
|
-
* **Scope (范围)**:
|
|
9
|
-
* **Project**: 仅对当前项目生效。
|
|
10
|
-
* **Global**: 对当前用户的所有项目生效。
|
|
11
|
-
* **Capability (能力)**:
|
|
12
|
-
* **Rules**: 被动上下文规则 (System Prompt / Context)。
|
|
13
|
-
* **Commands**: 主动触发的工作流 (Slash Commands)。
|
|
14
|
-
|
|
15
|
-
---
|
|
16
|
-
|
|
17
|
-
## 2. Antigravity (Google)
|
|
18
|
-
|
|
19
|
-
Antigravity 依赖 **Intent Classification** (意图识别) 来动态加载规则。
|
|
20
|
-
|
|
21
|
-
| Scope | Capability | Path | Frontmatter Specification (必须严格遵守) |
|
|
22
|
-
| :------------------- | :----------- | :--------------------------- | :--------------------------------------------------------------------------------------------------------------------------------- |
|
|
23
|
-
| **Project & Global** | **Rules** | `.agent/rules/aodw-*.md` | ```yaml<br>---<br>trigger: model_decision<br>---<br>```<br>**说明**: `model_decision` 允许模型根据用户输入自动判断是否加载此规则。 |
|
|
24
|
-
| **Project & Global** | **Commands** | `.agent/workflows/aodw-*.md` | ```yaml<br>---<br>description: [简短描述]<br>---<br>```<br>**说明**: `description` 用于帮助用户和模型理解此工作流的功能。 |
|
|
25
|
-
|
|
26
|
-
---
|
|
27
|
-
|
|
28
|
-
## 3. Cursor (Anysphere)
|
|
29
|
-
|
|
30
|
-
Cursor 依赖 `.mdc` 文件中的 `globs` 和 `alwaysApply` 字段来决定规则的生效范围。
|
|
31
|
-
|
|
32
|
-
| Scope | Capability | Path | Frontmatter Specification (必须严格遵守) |
|
|
33
|
-
| :------------------- | :----------- | :----------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
34
|
-
| **Project & Global** | **Rules** | `.cursor/rules/aodw.mdc` | ```yaml<br>---<br>description: AODW Core Framework<br>globs: *<br>alwaysApply: true<br>---<br>```<br>**说明**: <br>1. `globs: *`: AODW 是底层框架,必须匹配所有文件。<br>2. `alwaysApply: true`: 必须始终激活,防止 AI 在未加载规则时生成违规代码。 |
|
|
35
|
-
| **Project & Global** | **Commands** | `.cursor/commands/*.md` | *Standard Markdown (No Frontmatter required)*<br>**说明**: Cursor 自动识别 `.cursor/commands/` 下的所有 `.md` 文件为 Slash Commands。 |
|
|
36
|
-
|
|
37
|
-
---
|
|
38
|
-
|
|
39
|
-
## 4. Claude (Anthropic)
|
|
40
|
-
|
|
41
|
-
Claude Code 主要依赖文件路径和内容结构,对 Frontmatter 依赖较少。
|
|
42
|
-
|
|
43
|
-
| Scope | Capability | Path | Frontmatter Specification |
|
|
44
|
-
| :------------------- | :----------- | :---------------------- | :-------------------------------------------------------------------------------------------------- |
|
|
45
|
-
| **Project & Global** | **Rules** | `CLAUDE.md` | *Standard Markdown*<br>**说明**: 文件内容必须包含明确的章节结构 (如 `# AODW Rules`, `# Commands`)。 |
|
|
46
|
-
| **Project & Global** | **Commands** | `.claude/commands/*.md` | *Standard Markdown*<br>**说明**: 文件名即命令名。支持 `$ARGUMENTS` 占位符。 |
|
|
47
|
-
|
|
48
|
-
---
|
|
49
|
-
|
|
50
|
-
## 5. GitHub Copilot (Microsoft)
|
|
51
|
-
|
|
52
|
-
Copilot 对 Prompt 文件有严格的元数据要求,否则可能无法正确执行或使用错误的模型。
|
|
53
|
-
|
|
54
|
-
| Scope | Capability | Path | Frontmatter Specification (必须严格遵守) |
|
|
55
|
-
| :---------- | :----------------- | :-------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
56
|
-
| **Project** | **Rules** | `.github/copilot-instructions.md` | *Standard Markdown*<br>**说明**: 作为 System Prompt 注入,无特殊 Frontmatter。 |
|
|
57
|
-
| **Project** | **Commands** | `.github/prompts/*.prompt.md` | ```yaml<br>---<br>model: gpt-4o<br>mode: chat<br>description: [简短描述]<br>---<br>```<br>**说明**: <br>1. `model: gpt-4o`: 强制使用高智商模型,确保复杂工作流 (Spec/Plan) 的执行质量。<br>2. `mode: chat`: 指定交互模式。 |
|
|
58
|
-
| **Global** | **Rules/Commands** | *Manual Config* | *N/A (CLI 暂不自动处理)* |
|
|
59
|
-
|
|
60
|
-
---
|
|
61
|
-
|
|
62
|
-
## 6. CLI 实现检查清单
|
|
63
|
-
|
|
64
|
-
CLI 的 `FileProcessor` 必须在写入文件前执行以下 **Frontmatter 注入/校验逻辑**:
|
|
65
|
-
|
|
66
|
-
1. **Cursor Processor**:
|
|
67
|
-
* 目标文件: `*.mdc`
|
|
68
|
-
* 检查: 是否存在 `alwaysApply: true` 和 `globs: *`。
|
|
69
|
-
* 动作: 如果缺失或值为 `false`,强制覆盖为 `true` 和 `*`。
|
|
70
|
-
|
|
71
|
-
2. **Antigravity Processor**:
|
|
72
|
-
* 目标文件: `.agent/rules/*.md`
|
|
73
|
-
* 检查: 是否存在 `trigger: model_decision`。
|
|
74
|
-
* 动作: 如果缺失,强制注入。
|
|
75
|
-
|
|
76
|
-
3. **Copilot Processor**:
|
|
77
|
-
* 目标文件: `.github/prompts/*.prompt.md`
|
|
78
|
-
* 检查: 是否存在 `model` 和 `mode`。
|
|
79
|
-
* 动作: 强制注入 `model: gpt-4o` 和 `mode: chat`。
|
|
80
|
-
|
|
81
|
-
4. **Common**:
|
|
82
|
-
* 确保所有生成的 Markdown 文件都是 UTF-8 编码。
|
|
83
|
-
* 确保目录结构存在 (`mkdir -p`)。
|