aodw-skill 0.7.17 → 0.7.19

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (140) hide show
  1. package/.aodw-next/01-core/csf-thinking-framework.md +1 -1
  2. package/.aodw-next/02-workflow/rt-manager.md +22 -1
  3. package/.aodw-next/02-workflow/ui-workflow-rules.md +0 -3
  4. package/.aodw-next/README.md +0 -1
  5. package/.aodw-next/SKILL.md +5 -5
  6. package/.aodw-next/manifest.yaml +0 -5
  7. package/AODW_Adapters/README.md +24 -31
  8. package/README.md +53 -6
  9. package/bin/aodw.js +17 -186
  10. package/bin/commands/new.js +4 -120
  11. package/bin/processors/index.js +1 -35
  12. package/bin/update-adapters-from-template.js +1 -15
  13. package/package.json +4 -4
  14. package/.aodw-next/01-core/ai-interaction-rules-summary.md +0 -37
  15. package/.aodw-next/01-core/ai-knowledge-rules-summary.md +0 -25
  16. package/.aodw-next/01-core/git-discipline-summary.md +0 -36
  17. package/.aodw-next/02-workflow/rt-id-generation-rules.md +0 -24
  18. package/.aodw-next/02-workflow/rt-manager-summary.md +0 -15
  19. package/.aodw-next/02-workflow/ui-workflow-rules-summary.md +0 -39
  20. package/.aodw-next/03-standards/stacks/rust-axum/ai-coding-rules-backend.md +0 -134
  21. package/.aodw-next/06-project/README.md +0 -16
  22. package/.aodw-next/07-optimization/token-usage-analysis.md +0 -253
  23. package/.aodw-next/templates/TEMPLATE-APPLICATION-GUIDE.md +0 -110
  24. package/.aodw-next/templates/audit-report-template.md +0 -232
  25. package/.aodw-next/templates/changelog-template.md +0 -16
  26. package/.aodw-next/templates/checklists/coding-standards-template.md +0 -130
  27. package/.aodw-next/templates/csf-review-template.md +0 -201
  28. package/.aodw-next/templates/impact-template.md +0 -17
  29. package/.aodw-next/templates/invariants-template.md +0 -12
  30. package/.aodw-next/templates/plan-lite-template.md +0 -20
  31. package/.aodw-next/templates/rt-decision-template.md +0 -13
  32. package/.aodw-next/templates/rt-intake-template.md +0 -33
  33. package/.aodw-next/templates/spec-lite-template.md +0 -26
  34. package/.aodw-next/templates/tests-template.md +0 -13
  35. package/.aodw-next/templates/tools-config/README.md +0 -112
  36. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-check.md +0 -7
  37. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-done.md +0 -7
  38. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-full.md +0 -7
  39. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-governance.md +0 -7
  40. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-impact.md +0 -7
  41. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-init.md +0 -7
  42. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-invariants.md +0 -7
  43. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-lite.md +0 -7
  44. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-module.md +0 -7
  45. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-new.md +0 -7
  46. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-open.md +0 -7
  47. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-pause.md +0 -7
  48. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-resume.md +0 -7
  49. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-tests.md +0 -7
  50. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-upgrade.md +0 -7
  51. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw.md +0 -35
  52. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-check.md +0 -16
  53. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-done.md +0 -16
  54. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-full.md +0 -14
  55. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-governance.md +0 -13
  56. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-impact.md +0 -13
  57. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-init.md +0 -13
  58. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-invariants.md +0 -13
  59. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-lite.md +0 -14
  60. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-module.md +0 -13
  61. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-new.md +0 -30
  62. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-open.md +0 -10
  63. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-pause.md +0 -12
  64. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-resume.md +0 -12
  65. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-tests.md +0 -13
  66. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw-upgrade.md +0 -12
  67. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/global_workflows/aodw.md +0 -18
  68. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/claude/CLAUDE.md +0 -17
  69. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-check.md +0 -30
  70. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-done.md +0 -52
  71. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-full.md +0 -31
  72. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-governance.md +0 -34
  73. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-impact.md +0 -25
  74. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-init.md +0 -75
  75. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-invariants.md +0 -29
  76. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-lite.md +0 -23
  77. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-module.md +0 -24
  78. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-new.md +0 -70
  79. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-open.md +0 -19
  80. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-pause.md +0 -19
  81. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-resume.md +0 -20
  82. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-tests.md +0 -26
  83. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-upgrade.md +0 -27
  84. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw.md +0 -69
  85. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/deploypromote.md +0 -20
  86. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/featuretotester.md +0 -32
  87. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/deploy/feature_to_master_push_test_local.sh +0 -390
  88. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/deploy/promote_only.sh +0 -210
  89. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/deploy/rollback_prod.sh +0 -99
  90. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/rules/aodw.mdc +0 -26
  91. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-check.md +0 -29
  92. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-done.md +0 -52
  93. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-full.md +0 -30
  94. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-governance.md +0 -33
  95. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-impact.md +0 -24
  96. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-init.md +0 -75
  97. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-invariants.md +0 -28
  98. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-lite.md +0 -22
  99. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-module.md +0 -23
  100. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-new.md +0 -92
  101. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-open.md +0 -18
  102. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-pause.md +0 -18
  103. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-resume.md +0 -19
  104. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-tests.md +0 -25
  105. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw-upgrade.md +0 -26
  106. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/.agent/rules/aodw.md +0 -68
  107. package/AODW_Adapters/_backup/v3.1.0-pre-refactor/gemini/GEMINI.md +0 -17
  108. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/.agent/rules/aodw-analyze.md +0 -15
  109. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/.agent/rules/aodw-complete.md +0 -15
  110. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/.agent/rules/aodw-control.md +0 -14
  111. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/.agent/rules/aodw-decide.md +0 -16
  112. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/.agent/rules/aodw-governance.md +0 -7
  113. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/.agent/rules/aodw-implement.md +0 -16
  114. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/.agent/rules/aodw-init.md +0 -7
  115. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/.agent/rules/aodw-intake.md +0 -15
  116. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/.agent/rules/aodw-open.md +0 -7
  117. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/.agent/rules/aodw-simplified.md +0 -107
  118. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/.agent/rules/aodw-verify.md +0 -14
  119. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/global_workflows/aodw-analyze.md +0 -24
  120. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/global_workflows/aodw-complete.md +0 -23
  121. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/global_workflows/aodw-control.md +0 -21
  122. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/global_workflows/aodw-decide.md +0 -26
  123. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/global_workflows/aodw-governance.md +0 -13
  124. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/global_workflows/aodw-implement.md +0 -21
  125. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/global_workflows/aodw-init.md +0 -13
  126. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/global_workflows/aodw-intake.md +0 -28
  127. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/global_workflows/aodw-open.md +0 -10
  128. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/global_workflows/aodw-verify.md +0 -20
  129. package/AODW_Adapters/_backup/v4.0.0-simplified/antigravity/global_workflows/aodw.md +0 -18
  130. package/AODW_Adapters/gemini/.agent/rules/aodw-next.md +0 -70
  131. package/AODW_Adapters/gemini/GEMINI.md +0 -18
  132. package/AODW_Adapters/general/.github/copilot-instructions.md +0 -34
  133. package/AODW_Adapters/general/AGENTS.md +0 -70
  134. package/docs/README.md +0 -26
  135. package/docs/adapter-evaluation.md +0 -55
  136. package/docs/backend-guidelines.md +0 -335
  137. package/docs/frontend-guidelines.md +0 -266
  138. package/docs/installation-variants.md +0 -88
  139. package/docs/migration-guide-0.2.0.md +0 -250
  140. package/docs/platform-matrix.md +0 -83
@@ -1,130 +0,0 @@
1
- # 编码规范验收清单
2
-
3
- > **注意**:本清单用于检查代码是否符合项目编码规范(`.aodw-next/03-standards/stacks/react-typescript/ai-coding-rules-frontend.md` 和 `.aodw-next/03-standards/stacks/python-fastapi/ai-coding-rules-backend.md`)。
4
-
5
- ---
6
-
7
- ## 前端编码规范验收(如涉及)
8
-
9
- ### 工具检查
10
- - [ ] ESLint 检查全部通过(`npm run lint` 或 `npx eslint .`)
11
- - [ ] Prettier 格式化已运行(`npm run format` 或 `npx prettier --write .`)
12
- - [ ] 工具初始化状态正常(检查 `.aodw-next/tools-status.yaml`)
13
-
14
- ### 目录结构检查
15
- - [ ] 目录结构符合规范(pages / features / shared)
16
- - [ ] 页面放在 `src/pages/<PageName>/` 下
17
- - [ ] 可复用业务逻辑放在 `src/features/<domain>/` 下
18
- - [ ] 通用组件/hooks/工具放在 `src/shared/` 下
19
- - [ ] 依赖关系符合规范(pages → features/shared, features → shared)
20
-
21
- ### 代码质量检查
22
- - [ ] 文件大小符合规范:
23
- - [ ] 页面入口组件(index.tsx)≤ 300 行
24
- - [ ] 普通组件/hooks/store 文件 ≤ 200 行
25
- - [ ] 函数大小符合规范:
26
- - [ ] 单个函数 ≤ 60 行
27
- - [ ] 复杂度符合规范:
28
- - [ ] 复杂度 ≤ 10
29
-
30
- ### TypeScript 规范检查
31
- - [ ] 是否启用严格模式
32
- - [ ] 是否避免使用 any
33
- - [ ] API 层是否使用 DTO 类型和 Response 类型
34
-
35
- ### React 编码规范检查
36
- - [ ] 是否使用函数组件 + Hooks
37
- - [ ] 数据请求是否封装在 features/*/api 或页面专用 hooks
38
- - [ ] 是否不在组件中直接调用 fetch/axios
39
-
40
- ---
41
-
42
- ## 后端编码规范验收(如涉及)
43
-
44
- ### 依赖管理检查
45
- - [ ] 使用 `uv + pip-tools` 管理依赖
46
- - [ ] 存在 `requirements.in` 和 `requirements-dev.in` 文件
47
- - [ ] 只编辑 `.in` 文件,不直接编辑 `.txt` 文件
48
- - [ ] 添加依赖时使用版本约束(如 `package>=1.0.0,<2.0.0`)
49
- - [ ] 通过 `make compile-deps && make sync` 更新依赖
50
-
51
- ### 工具检查
52
- - [ ] Ruff 检查全部通过(`ruff check .`)
53
- - [ ] Black 格式化已运行(`black .`)
54
- - [ ] pre-commit hooks 已安装(如适用)
55
- - [ ] 工具初始化状态正常(检查 `.aodw-next/tools-status.yaml`)
56
-
57
- ### 分层架构检查
58
- - [ ] 分层架构符合规范(api → services → repositories)
59
- - [ ] API 层未直接导入 models(如适用)
60
- - [ ] Services 层未直接导入 api
61
- - [ ] 依赖关系符合规范(不跨层调用)
62
-
63
- ### 代码质量检查
64
- - [ ] 文件大小符合规范:
65
- - [ ] Python 模块 ≤ 300 行(Ruff 自动检查)
66
- - [ ] 函数大小符合规范:
67
- - [ ] 单个函数 ≤ 60 行(Ruff PLR0915 自动拦截)
68
- - [ ] 复杂度符合规范:
69
- - [ ] 复杂度 ≤ 10(Ruff PLR 规则自动检查)
70
-
71
- ### API 设计检查
72
- - [ ] API 端点是否符合 RESTful 规范
73
- - [ ] 请求/响应格式是否统一
74
- - [ ] 错误处理是否完善
75
-
76
- ### 安全检查
77
- - [ ] 输入数据是否已验证
78
- - [ ] 是否防止 SQL 注入、XSS 等安全漏洞
79
- - [ ] 认证和授权是否正确实现
80
-
81
- ---
82
-
83
- ## 通用编码规范验收
84
-
85
- ### 文件大小检查
86
- - [ ] 文件大小符合规范(参考 `.aodw-next/03-standards/ai-coding-rules-common.md`)
87
-
88
- ### 函数/方法长度检查
89
- - [ ] 函数/方法长度符合规范
90
-
91
- ### 复杂度检查
92
- - [ ] 复杂度符合规范
93
-
94
- ### 命名规范检查
95
- - [ ] 命名规范符合要求(参考具体编码规范文件)
96
-
97
- ---
98
-
99
- ## LLM 行为规范验收
100
-
101
- ### 实现前对齐检查
102
- - [ ] 已明确声明关键假设(输入、边界、依赖、预期行为)
103
- - [ ] 存在歧义时,已列出多个解释并给出推荐与理由
104
- - [ ] 已将任务转换为可验证成功标准(测试、验收条件或回归路径)
105
- - [ ] 已说明当前方案为何是最小必要改动
106
-
107
- ### 过度实现检查
108
- - [ ] 未实现用户未请求的额外功能
109
- - [ ] 未引入一次性逻辑的过早抽象
110
- - [ ] 未增加未被请求的配置项或“未来扩展”结构
111
-
112
- ### 外科手术式改动检查
113
- - [ ] 变更仅覆盖与当前请求直接相关的代码
114
- - [ ] 不存在无关重构、无关格式化、无关注释清理
115
- - [ ] 仅清理由本次变更引入的孤儿代码(unused import/var/function)
116
-
117
- ---
118
-
119
- ## 验收结果
120
-
121
- - [ ] 所有检查项已通过
122
- - [ ] 如有未通过项,已记录原因并说明:
123
- - 未通过项:
124
- - 原因说明:
125
- - 后续处理计划:
126
-
127
- ---
128
-
129
- **验收人**:_________________
130
- **验收日期**:_________________
@@ -1,201 +0,0 @@
1
- # CSF Review: RT-XXX - <title>
2
-
3
- ## 审查元数据
4
- - **审查时间**:YYYY-MM-DD HH:MM:SS
5
- - **审查阶段**:Decision / Spec-Plan / Implementation / Verification
6
- - **审查类型**:快速审查 / 深度审查
7
- - **审查人**:AI + 用户(如参与)
8
- - **RT 状态**:created / intaking / decided / in-progress / reviewing
9
-
10
- ---
11
-
12
- ## 1. 以终为始检查(Begin with the End)
13
-
14
- ### 1.1 目标定义
15
- - **明确目标**:[用一句话描述本 RT 的目标]
16
- - **当前现状**:[描述当前存在的问题/痛点/缺失]
17
- - **期望状态**:[描述成功后的期望状态]
18
- - **差距分析**:[现状与期望的差距是什么?]
19
-
20
- ### 1.2 目标贡献度评估
21
- - [ ] 当前工作是否直接贡献于缩小差距?
22
- - [ ] 是否存在无效工作?(不贡献于目标的工作)
23
- - 无效工作列表:[如有,列出]
24
- - [ ] 目标是否可衡量?(有明确的成功标准)
25
-
26
- ### 1.3 发现与建议
27
- - **关键发现**:[记录发现的问题]
28
- - **改进建议**:[如有无效工作,建议如何调整]
29
-
30
- ---
31
-
32
- ## 2. 结构化分解检查(Structured Decomposition)
33
-
34
- ### 2.1 分解结构
35
- - **静态分解**(组成部分):
36
- ```
37
- [用树状图或列表展示组成部分]
38
- ```
39
-
40
- - **动态分解**(流程步骤):
41
- ```
42
- [用流程图或列表展示流程步骤]
43
- ```
44
-
45
- ### 2.2 MECE 验证
46
- - [ ] 分解是否符合 MECE 原则?(不重不漏)
47
- - [ ] 分解粒度是否合适?(不过细也不过粗)
48
- - [ ] 子目标/子模块之间是否存在重叠?
49
- - [ ] 是否存在遗漏的关键部分?
50
-
51
- ### 2.3 依赖关系
52
- - **依赖关系图**:[描述或绘制依赖关系]
53
- - **关键依赖**:[标注关键依赖,如存在单点故障]
54
-
55
- ### 2.4 发现与建议
56
- - **关键发现**:[记录发现的问题]
57
- - **改进建议**:[如有 MECE 问题或依赖问题,建议如何调整]
58
-
59
- ---
60
-
61
- ## 3. 关键要素识别检查(Identify CSFs)
62
-
63
- ### 3.1 关键成功要素(CSF)清单
64
- | 优先级 | CSF 描述 | 影响程度 | 当前状态 |
65
- |--------|----------|----------|----------|
66
- | P0 | [CSF 1] | 高/中/低 | 已识别/未识别 |
67
- | P1 | [CSF 2] | 高/中/低 | 已识别/未识别 |
68
- | P2 | [CSF 3] | 高/中/低 | 已识别/未识别 |
69
-
70
- ### 3.2 关键控制变量
71
- - **控制变量列表**:[列出可以影响结果的关键变量]
72
- - **变量影响分析**:[分析各变量的影响程度]
73
-
74
- ### 3.3 瓶颈识别
75
- - **瓶颈点列表**:[列出限制目标达成的关键点]
76
- - **瓶颈影响分析**:[分析各瓶颈的影响程度]
77
-
78
- ### 3.4 资源分配评估
79
- - [ ] 是否聚焦于 CSF?(而非平均分配资源)
80
- - [ ] 关键控制变量是否已识别并监控?
81
- - [ ] 瓶颈点是否有缓解策略?
82
-
83
- ### 3.5 发现与建议
84
- - **关键发现**:[记录发现的问题]
85
- - **改进建议**:[如有资源分配问题,建议如何调整]
86
-
87
- ---
88
-
89
- ## 4. 流程与系统观检查(Process & Systems View)
90
-
91
- ### 4.1 端到端流程分析
92
- - **流程图**:[描述或引用端到端流程图]
93
- - **关键路径**:[标注从触发到完成的关键路径]
94
- - **路径长度**:[估算关键路径的时间/复杂度]
95
-
96
- ### 4.2 瓶颈识别
97
- - **流程瓶颈**:[标注流程中的瓶颈点]
98
- - **瓶颈影响**:[分析瓶颈对整体流程的影响]
99
-
100
- ### 4.3 系统交互分析
101
- - **组件交互图**:[描述系统各组件之间的交互]
102
- - **单点故障**:[识别是否存在单点故障]
103
- - **上下游影响**:[分析对上下游系统的影响]
104
-
105
- ### 4.4 发现与建议
106
- - **关键发现**:[记录发现的问题]
107
- - **改进建议**:[如有流程或系统问题,建议如何调整]
108
-
109
- ---
110
-
111
- ## 5. 多维决策检查(Multi-dimensional Decision)
112
-
113
- ### 5.1 评估维度
114
- - **维度列表**:[列出评估维度,如:性能、成本、复杂度、可维护性、风险、时间等]
115
-
116
- ### 5.2 评估矩阵
117
- | 方案 | 维度1 | 维度2 | 维度3 | 维度4 | 维度5 | 总分 | 排名 |
118
- |------|-------|-------|-------|-------|-------|------|------|
119
- | 方案A | 评分 | 评分 | 评分 | 评分 | 评分 | 总分 | 1 |
120
- | 方案B | 评分 | 评分 | 评分 | 评分 | 评分 | 总分 | 2 |
121
- | 方案C | 评分 | 评分 | 评分 | 评分 | 评分 | 总分 | 3 |
122
-
123
- **权重说明**:[说明各维度的权重分配理由]
124
-
125
- ### 5.3 决策标准
126
- - **决策标准**:[明确说明决策标准]
127
- - **最终决策**:[记录最终选择的方案]
128
- - **决策理由**:[说明选择该方案的理由]
129
-
130
- ### 5.4 备选方案评估
131
- - [ ] 备选方案是否充分?
132
- - [ ] 是否进行了多维度评估?(而非非黑即白)
133
- - [ ] 各维度权重是否合理?
134
-
135
- ### 5.5 发现与建议
136
- - **关键发现**:[记录发现的问题]
137
- - **改进建议**:[如有决策问题,建议如何调整]
138
-
139
- ---
140
-
141
- ## 6. 综合评估
142
-
143
- ### 6.1 关键发现总结
144
- 1. [发现 1]
145
- 2. [发现 2]
146
- 3. [发现 3]
147
-
148
- ### 6.2 风险点识别
149
- | 风险 | 影响程度 | 可能性 | 缓解策略 |
150
- |------|----------|--------|----------|
151
- | 风险1 | 高/中/低 | 高/中/低 | [缓解策略] |
152
- | 风险2 | 高/中/低 | 高/中/低 | [缓解策略] |
153
-
154
- ### 6.3 改进建议
155
- 1. [建议 1]
156
- 2. [建议 2]
157
- 3. [建议 3]
158
-
159
- ### 6.4 审查结论
160
- - [ ] **通过**:当前方向正确,可以继续
161
- - [ ] **有条件通过**:需要调整后继续
162
- - [ ] **不通过**:需要重新审视方向
163
-
164
- **结论说明**:[说明审查结论的理由]
165
-
166
- ---
167
-
168
- ## 7. 后续行动
169
-
170
- ### 7.1 需要调整的方向
171
- - [ ] [调整项 1]
172
- - [ ] [调整项 2]
173
-
174
- ### 7.2 需要补充的工作
175
- - [ ] [补充项 1]
176
- - [ ] [补充项 2]
177
-
178
- ### 7.3 需要用户确认的事项
179
- - [ ] [确认项 1]
180
- - [ ] [确认项 2]
181
-
182
- ### 7.4 下次审查计划
183
- - **下次审查时间**:[如需要,计划下次审查时间]
184
- - **审查重点**:[如需要,说明下次审查的重点]
185
-
186
- ---
187
-
188
- ## 8. 审查记录
189
-
190
- ### 8.1 审查过程
191
- - **审查步骤**:[记录审查的执行步骤]
192
- - **审查耗时**:[记录审查耗时]
193
-
194
- ### 8.2 用户反馈
195
- - **用户意见**:[记录用户的反馈意见]
196
- - **用户决策**:[记录用户的最终决策]
197
-
198
- ### 8.3 审查历史
199
- - **上次审查时间**:[如有,记录上次审查时间]
200
- - **上次审查结论**:[如有,记录上次审查结论]
201
- - **本次改进**:[如有,说明本次相比上次的改进]
@@ -1,17 +0,0 @@
1
- # Impact Analysis: RT-XXX - <short title>
2
-
3
- ## 1. 问题触发点(Trigger)
4
- - 描述用户或系统如何触发问题:
5
-
6
- ## 2. 直接影响(Direct Impact)
7
- - 受影响的模块 / 文件:
8
- - 直接受影响的行为:
9
-
10
- ## 3. 间接影响(Indirect Impact)
11
- - 可能受影响的上下游模块 / 功能:
12
-
13
- ## 4. 风险评估(Risk Evaluation)
14
- - 数据风险:
15
- - 安全风险:
16
- - 性能风险:
17
- - 用户体验风险:
@@ -1,12 +0,0 @@
1
- # Invariants: RT-XXX - <short title>
2
-
3
- > 本文件列出在本次改动中必须保持不变的行为与约束。
4
-
5
- ## 1. 业务行为 Invariants
6
- - 不改变的业务规则:
7
-
8
- ## 2. 接口 Invariants
9
- - 不改变的 API 路径 / 请求 / 响应格式:
10
-
11
- ## 3. 技术结构 Invariants
12
- - 不允许破坏的工程结构约束(如不得跨层访问):
@@ -1,20 +0,0 @@
1
- # Plan-Lite: RT-XXX - <short title>
2
-
3
- ## 1. 修改点(Change Points)
4
- - 计划修改的文件 / 模块列表:
5
-
6
- ## 2. 方案描述(Solution Outline)
7
- - 拟采取的技术方案:
8
-
9
- ## 3. 风险与注意事项(Risks & Caveats)
10
- - 潜在风险:
11
- - 需要注意的边界情形:
12
-
13
- ## 4. 目标与验证(Goals & Verification)
14
- - 目标 1:<描述> → 验证方式:<测试/回归/手动步骤>
15
- - 目标 2:<描述> → 验证方式:<测试/回归/手动步骤>
16
-
17
- ## 5. 实施边界(Execution Boundaries)
18
- - 明确不做(Out of Scope):
19
- - 是否存在无关重构/额外功能引入风险:有 / 无
20
- - 若“有”,规避策略:
@@ -1,13 +0,0 @@
1
- # RT Decision - RT-XXX
2
-
3
- ## 1. 流程选择(Chosen Profile)
4
- - 选用:Spec-Full / Spec-Lite
5
- - AI 推荐理由:
6
- - 用户最终选择:
7
-
8
- ## 2. 备选方案(Alternatives)
9
- - 其他可行流程及未采用原因:
10
-
11
- ## 3. 分支与目录
12
- - 计划分支名:feature/RT-XXX-short-name
13
- - 目录:RT/RT-XXX/
@@ -1,33 +0,0 @@
1
- # RT Intake - RT-XXX
2
-
3
- ## 1. 原始描述(Raw Description)
4
- - 用户原话:
5
-
6
- ## 2. 类型与范围(Type & Scope)
7
- - 类型(Feature / Bug / Enhancement / Refactor / Research / Other):
8
- - 预估影响范围:
9
-
10
- ## 3. 初步模块猜测(Initial Modules)
11
- - 可能涉及的模块:
12
-
13
- ## 4. 风险评估(Initial Risk)
14
- - 低 / 中 / 高,简要理由:
15
-
16
- ## 5. AI 问题与用户回答摘要(Q&A Summary)
17
- - Q1: ...
18
- - 用户回答:
19
- - Q2: ...
20
- - 用户回答:
21
-
22
- ## 6. 相关技术约束 / 规范(可选)
23
- > **注意**:AI 根据需求内容判断是否涉及前端/后端开发,如涉及则填写本节。
24
-
25
- - **是否涉及前端开发**?
26
- - [ ] 是 → 参考 `.aodw-next/03-standards/stacks/react-typescript/ai-coding-rules-frontend.md`
27
- - [ ] 否
28
- - **是否涉及后端开发**?
29
- - [ ] 是 → 参考 `.aodw-next/03-standards/stacks/python-fastapi/ai-coding-rules-backend.md`
30
- - [ ] 否
31
- - **技术栈要求**(如已知):
32
- - 前端:[React / Vue / Angular 等]
33
- - 后端:[Python / Node.js / Go 等]
@@ -1,26 +0,0 @@
1
- # Spec-Lite: RT-XXX - <short title>
2
-
3
- ## 1. 背景(Context)
4
- - 当前存在的问题 / 需求:
5
-
6
- ## 2. 目标(Goal)
7
- - 希望达到的业务 / 用户效果:
8
-
9
- ## 3. 当前行为(Current Behavior)
10
- - 当前系统在相关场景下的行为:
11
-
12
- ## 4. 期望行为(Desired Behavior)
13
- - 修改后的预期行为:
14
-
15
- ## 5. 影响范围(Scope)
16
- - 涉及模块 / 文件:
17
- - 预期不应影响的功能:
18
-
19
- ## 6. 实现前对齐(Implementation Alignment)
20
- - 关键假设(输入/边界/依赖):
21
- - 歧义点与解释选项:
22
- - 解释 A:
23
- - 解释 B:
24
- - 推荐选项与理由:
25
- - 最小必要改动说明(为何不是更大方案):
26
- - 成功标准(可验证):
@@ -1,13 +0,0 @@
1
- # Tests: RT-XXX - <short title>
2
-
3
- ## 1. 新增测试用例(New Tests)
4
- - [ ] 描述用例 1(对应测试文件路径)
5
- - [ ] 描述用例 2
6
-
7
- ## 2. 回归测试(Regression)
8
- - [ ] 回归用例 1
9
- - [ ] 回归用例 2
10
-
11
- ## 3. 手动验证建议(Manual Checks)
12
- - [ ] 手动步骤 1
13
- - [ ] 手动步骤 2
@@ -1,112 +0,0 @@
1
- # 工具配置模板
2
-
3
- 本目录包含 AODW 规范要求的开发工具配置模板。
4
-
5
- ## 目录结构
6
-
7
- ```
8
- tools-config/
9
- ├── frontend/ # 前端工具配置模板
10
- │ ├── eslint.config.template.json
11
- │ ├── prettier.config.template.json
12
- │ └── tsconfig.paths.template.json
13
- ├── backend/ # 后端工具配置模板
14
- │ ├── ruff.config.template.toml # Python 代码质量检查
15
- │ ├── black.config.template.toml # Python 代码格式化
16
- │ ├── rustfmt.config.template.toml # Rust 代码格式化
17
- │ ├── clippy.config.template.toml # Rust 代码质量检查
18
- │ └── pre-commit.config.template.yaml # Git 提交前检查(通用)
19
- └── README.md
20
- ```
21
-
22
- ## 使用方式
23
-
24
- ### 方式 1:通过 CLI 命令
25
-
26
- ```bash
27
- aodw-skill init-tools
28
- ```
29
-
30
- CLI 会自动检测项目类型,并使用相应的模板生成配置文件。
31
-
32
- ### 方式 2:通过 AI 命令
33
-
34
- 在 AI 工具(Cursor/Claude 等)中说:
35
- - "初始化工具"
36
- - "设置开发工具"
37
- - "配置工具"
38
-
39
- AI 会引导您完成工具初始化和配置。
40
-
41
- ## 配置说明
42
-
43
- ### 前端配置
44
-
45
- #### ESLint 配置
46
- - 文件:`.eslintrc.json` 或 `eslint.config.js`
47
- - 模板:`frontend/eslint.config.template.json`
48
- - 包含:TypeScript、React、Hooks、Import、可访问性规则
49
- - 限制:文件大小、函数长度、复杂度
50
-
51
- #### Prettier 配置
52
- - 文件:`.prettierrc.json` 或 `prettier.config.js`
53
- - 模板:`frontend/prettier.config.template.json`
54
- - 包含:代码格式化规则
55
-
56
- #### TypeScript Path Alias
57
- - 文件:`tsconfig.json`
58
- - 模板:`frontend/tsconfig.paths.template.json`
59
- - 包含:路径别名配置(@app、@pages、@features、@shared)
60
-
61
- ### 后端配置
62
-
63
- #### Python 项目工具
64
-
65
- **Ruff 配置**:
66
- - 文件:`pyproject.toml`(合并到 `[tool.ruff]` 部分)
67
- - 模板:`backend/ruff.config.template.toml`
68
- - 包含:代码质量检查、复杂度限制
69
-
70
- **Black 配置**:
71
- - 文件:`pyproject.toml`(合并到 `[tool.black]` 部分)
72
- - 模板:`backend/black.config.template.toml`
73
- - 包含:代码格式化规则
74
-
75
- #### Rust 项目工具
76
-
77
- **rustfmt 配置**:
78
- - 文件:`rustfmt.toml`(项目根目录)
79
- - 模板:`backend/rustfmt.config.template.toml`
80
- - 包含:代码格式化规则(edition、max_width、imports 等)
81
-
82
- **clippy 配置**:
83
- - 文件:`clippy.toml`(项目根目录)或 `Cargo.toml` 的 `[lints.clippy]` 部分
84
- - 模板:`backend/clippy.config.template.toml`
85
- - 包含:代码质量检查、复杂度限制、零警告策略
86
-
87
- #### Java 项目工具
88
-
89
- **Checkstyle 配置**(推荐):
90
- - 文件:`checkstyle.xml`(项目根目录)
91
- - 模板:`backend/checkstyle.config.template.xml`(如果存在)
92
- - 包含:Java 代码风格检查规则
93
- - 配置方式:在 `pom.xml` 中添加 `maven-checkstyle-plugin`
94
-
95
- **Spotless 配置**(推荐):
96
- - 文件:`pom.xml` 中的 `spotless-maven-plugin` 配置
97
- - 模板:`backend/spotless.config.template.xml`(如果存在)
98
- - 包含:Java 代码格式化规则(Google Java Format)
99
- - 配置方式:在 `pom.xml` 中添加 `spotless-maven-plugin`
100
-
101
- #### 通用工具配置
102
-
103
- **pre-commit 配置**:
104
- - 文件:`.pre-commit-config.yaml`
105
- - 模板:`backend/pre-commit.config.template.yaml`
106
- - 包含:Git 提交前检查钩子(支持 Python、Rust、Java 等)
107
-
108
- ## 注意事项
109
-
110
- 1. **配置文件合并**:如果配置文件已存在,工具初始化会询问您是否合并配置
111
- 2. **模板更新**:模板更新不会自动应用到已有项目,需要重新运行工具初始化
112
- 3. **自定义配置**:您可以在工具初始化后手动调整配置,但建议保持核心规范不变
@@ -1,7 +0,0 @@
1
- ---
2
- trigger: model_decision
3
- ---
4
- # RT 一致性检查
5
-
6
- 当用户想要 **检查 RT 状态**、**验证一致性** 或 **运行检查** 时,请**不要**直接尝试操作。
7
- 你**必须**运行工作流 `/aodw-check`。
@@ -1,7 +0,0 @@
1
- ---
2
- trigger: model_decision
3
- ---
4
- # 完成 RT
5
-
6
- 当用户想要 **完成 RT**、**关闭任务** 或 **标记为 Done** 时,请**不要**直接尝试操作。
7
- 你**必须**运行工作流 `/aodw-done`。
@@ -1,7 +0,0 @@
1
- ---
2
- trigger: model_decision
3
- ---
4
- # 切换到 Spec-Full
5
-
6
- 当用户想要 **切换到 Spec-Full 模式** 或 **启用完整规范** 时,请**不要**直接尝试操作。
7
- 你**必须**运行工作流 `/aodw-full`。
@@ -1,7 +0,0 @@
1
- ---
2
- trigger: model_decision
3
- ---
4
- # AODW 治理检查
5
-
6
- 当用户想要 **检查治理状态** 或 **运行治理流程** 时,请**不要**直接尝试操作。
7
- 你**必须**运行工作流 `/aodw-governance`。
@@ -1,7 +0,0 @@
1
- ---
2
- trigger: model_decision
3
- ---
4
- # 更新影响分析
5
-
6
- 当用户想要 **更新影响分析** 或 **分析改动影响** 时,请**不要**直接尝试操作。
7
- 你**必须**运行工作流 `/aodw-impact`。
@@ -1,7 +0,0 @@
1
- ---
2
- trigger: model_decision
3
- ---
4
- # 初始化 AODW
5
-
6
- 当用户想要 **初始化 AODW** 或 **设置新项目** 时,请**不要**直接尝试操作。
7
- 你**必须**运行工作流 `/aodw-init`。
@@ -1,7 +0,0 @@
1
- ---
2
- trigger: model_decision
3
- ---
4
- # 检查不变量
5
-
6
- 当用户想要 **检查不变量** 或 **验证系统约束** 时,请**不要**直接尝试操作。
7
- 你**必须**运行工作流 `/aodw-invariants`。
@@ -1,7 +0,0 @@
1
- ---
2
- trigger: model_decision
3
- ---
4
- # 切换到 Spec-Lite
5
-
6
- 当用户想要 **切换到 Spec-Lite 模式** 或 **启用轻量规范** 时,请**不要**直接尝试操作。
7
- 你**必须**运行工作流 `/aodw-lite`。
@@ -1,7 +0,0 @@
1
- ---
2
- trigger: model_decision
3
- ---
4
- # 更新模块文档
5
-
6
- 当用户想要 **更新模块文档** 或 **创建新模块** 时,请**不要**直接尝试操作。
7
- 你**必须**运行工作流 `/aodw-module`。
@@ -1,7 +0,0 @@
1
- ---
2
- trigger: model_decision
3
- ---
4
- # 创建新 RT
5
-
6
- 当用户想要 **创建新 RT**、**开始新任务** 或 **启动 AODW 流程** 时,请**不要**直接尝试操作。
7
- 你**必须**运行工作流 `/aodw-new`。
@@ -1,7 +0,0 @@
1
- ---
2
- trigger: model_decision
3
- ---
4
- # 打开 RT
5
-
6
- 当用户想要 **打开某个 RT** 或 **查看任务详情** 时,请**不要**直接尝试操作。
7
- 你**必须**运行工作流 `/aodw-open`。