@chongyan/autospec 1.0.1

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 (243) hide show
  1. package/LICENSE +21 -0
  2. package/README.en.md +472 -0
  3. package/README.md +476 -0
  4. package/bin/autospec.js +3 -0
  5. package/knowledge/README.md +144 -0
  6. package/knowledge/checklists/code.md +182 -0
  7. package/knowledge/checklists/design.md +196 -0
  8. package/knowledge/checklists/release.md +70 -0
  9. package/knowledge/checklists/requirement.md +169 -0
  10. package/knowledge/checklists/test.md +46 -0
  11. package/knowledge/config/README.en.md +44 -0
  12. package/knowledge/config/README.md +44 -0
  13. package/knowledge/config/role-composition.yaml +98 -0
  14. package/knowledge/config/role-extensions.yaml +140 -0
  15. package/knowledge/config/skill-compositions.yaml +142 -0
  16. package/knowledge/config/team-stage.yaml +95 -0
  17. package/knowledge/config/team-tasks.yaml +139 -0
  18. package/knowledge/config/team-triggers.yaml +198 -0
  19. package/knowledge/config/validation-patterns.yaml +137 -0
  20. package/knowledge/domain/README.md +115 -0
  21. package/knowledge/domain/flows/README.md +194 -0
  22. package/knowledge/domain/glossary.md +143 -0
  23. package/knowledge/domain/rules.md +138 -0
  24. package/knowledge/environment/README.en.md +36 -0
  25. package/knowledge/environment/README.md +87 -0
  26. package/knowledge/environment/component-knowledge.md +316 -0
  27. package/knowledge/environment/detection-patterns.yaml +502 -0
  28. package/knowledge/environment/middleware-knowledge.md +237 -0
  29. package/knowledge/environment/template-registry.md +321 -0
  30. package/knowledge/guides/domain-driven-design.md +345 -0
  31. package/knowledge/guides/knowledge-management.md +369 -0
  32. package/knowledge/guides/requirement-engineering.md +329 -0
  33. package/knowledge/guides/stages/ai-effect-evaluator.md +93 -0
  34. package/knowledge/guides/stages/code-implementer.md +205 -0
  35. package/knowledge/guides/stages/code-reviewer.md +111 -0
  36. package/knowledge/guides/stages/consistency-checker.md +177 -0
  37. package/knowledge/guides/stages/design-planner.md +401 -0
  38. package/knowledge/guides/stages/design-reviewer.md +83 -0
  39. package/knowledge/guides/stages/integration-test-runner.md +105 -0
  40. package/knowledge/guides/stages/release-checker.md +205 -0
  41. package/knowledge/guides/stages/requirement-analyzer.md +195 -0
  42. package/knowledge/guides/stages/requirement-reviewer.md +83 -0
  43. package/knowledge/guides/stages/security-reviewer.md +89 -0
  44. package/knowledge/guides/stages/test-context-analyzer.md +250 -0
  45. package/knowledge/guides/stages/test-generator.md +241 -0
  46. package/knowledge/guides/stages/test-planner.md +183 -0
  47. package/knowledge/guides/stages/test-reviewer.md +76 -0
  48. package/knowledge/guides/stages/unit-test-runner.md +83 -0
  49. package/knowledge/guides/support/ai-agent-analyzer.md +362 -0
  50. package/knowledge/guides/support/ai-anomaly-analyzer.md +213 -0
  51. package/knowledge/guides/support/ai-artifact-evaluator.md +192 -0
  52. package/knowledge/guides/support/ai-capability-analyzer.md +193 -0
  53. package/knowledge/guides/support/ai-component-analyzer.md +169 -0
  54. package/knowledge/guides/support/ai-data-validator.md +276 -0
  55. package/knowledge/guides/support/ai-evaluation-planner.md +374 -0
  56. package/knowledge/guides/support/ai-path-evaluator.md +274 -0
  57. package/knowledge/guides/support/ai-pipeline-evaluator.md +219 -0
  58. package/knowledge/guides/support/ai-rag-analyzer.md +339 -0
  59. package/knowledge/guides/support/ai-task-assessor.md +418 -0
  60. package/knowledge/guides/support/ai-test-diagnostics.md +133 -0
  61. package/knowledge/guides/support/complexity-assessor.md +268 -0
  62. package/knowledge/guides/support/component-discovery.md +183 -0
  63. package/knowledge/guides/support/environment-scanner.md +207 -0
  64. package/knowledge/guides/support/environment-validator.md +207 -0
  65. package/knowledge/guides/support/knowledge-generator.md +234 -0
  66. package/knowledge/guides/support/methodology-extractor.md +55 -0
  67. package/knowledge/guides/support/pipeline-protocol.md +438 -0
  68. package/knowledge/guides/support/practice-logger.md +359 -0
  69. package/knowledge/guides/support/scope-inference.md +174 -0
  70. package/knowledge/guides/support/skill-distiller.md +91 -0
  71. package/knowledge/guides/support/skill-updater.md +45 -0
  72. package/knowledge/guides/support/skill-validator.md +72 -0
  73. package/knowledge/guides/support/team-orchestrator.md +323 -0
  74. package/knowledge/guides/support/tech-stack-analyzer.md +139 -0
  75. package/knowledge/guides/support/test-runner.md +254 -0
  76. package/knowledge/guides/system-design.md +352 -0
  77. package/knowledge/organization/ai-native-team.md +318 -0
  78. package/knowledge/organization/team-metrics.md +228 -0
  79. package/knowledge/principles/constitution.md +134 -0
  80. package/knowledge/principles/core-principles.md +368 -0
  81. package/knowledge/principles/design-philosophy.md +877 -0
  82. package/knowledge/principles/evolution.md +553 -0
  83. package/knowledge/process/01-requirement.md +113 -0
  84. package/knowledge/process/02-design.md +123 -0
  85. package/knowledge/process/03-implementation.md +90 -0
  86. package/knowledge/process/04-review.md +80 -0
  87. package/knowledge/process/05-testing.md +90 -0
  88. package/knowledge/process/06-delivery.md +88 -0
  89. package/knowledge/process/README.en.md +38 -0
  90. package/knowledge/process/README.md +48 -0
  91. package/knowledge/process/ai-sdlc.md +475 -0
  92. package/knowledge/process/overview.md +319 -0
  93. package/knowledge/standards/code-review.md +876 -0
  94. package/knowledge/standards/coding-style.md +940 -0
  95. package/knowledge/standards/data-consistency.md +1085 -0
  96. package/knowledge/standards/document-versioning.md +210 -0
  97. package/knowledge/standards/risk-detection.md +186 -0
  98. package/knowledge/templates/ai-evaluation.md +150 -0
  99. package/knowledge/templates/api-design.md +117 -0
  100. package/knowledge/templates/database-design.md +132 -0
  101. package/knowledge/templates/domain-driven-design.md +321 -0
  102. package/knowledge/templates/product-proposal.md +201 -0
  103. package/knowledge/templates/system-design.md +227 -0
  104. package/knowledge/templates/task-breakdown.md +107 -0
  105. package/knowledge/templates/test-case.md +170 -0
  106. package/package.json +53 -0
  107. package/plugins/.claude-plugin/plugin.json +134 -0
  108. package/plugins/agents/roles/ai-engineer.md +129 -0
  109. package/plugins/agents/roles/backend-engineer.md +165 -0
  110. package/plugins/agents/roles/ceo.md +94 -0
  111. package/plugins/agents/roles/data-engineer.md +135 -0
  112. package/plugins/agents/roles/devops-engineer.md +181 -0
  113. package/plugins/agents/roles/frontend-engineer.md +129 -0
  114. package/plugins/agents/roles/product-owner.md +98 -0
  115. package/plugins/agents/roles/quality-engineer.md +129 -0
  116. package/plugins/agents/roles/security-engineer.md +180 -0
  117. package/plugins/agents/roles/tech-lead.md +97 -0
  118. package/plugins/agents/support/blind-comparator.md +88 -0
  119. package/plugins/agents/support/consistency-checker.md +103 -0
  120. package/plugins/agents/support/failure-diagnostician.md +141 -0
  121. package/plugins/agents/support/independent-reviewer.md +80 -0
  122. package/plugins/agents/support/safety-auditor.md +121 -0
  123. package/plugins/agents/support/skill-benchmarker.md +86 -0
  124. package/plugins/agents/support/skill-forger.md +105 -0
  125. package/plugins/agents/support/stage-gate-evaluator.md +121 -0
  126. package/plugins/agents/support/test-coverage-reviewer.md +73 -0
  127. package/plugins/benchmarks/templates/README.md +44 -0
  128. package/plugins/benchmarks/templates/commands/explore-template.yaml +48 -0
  129. package/plugins/benchmarks/templates/pipeline/agile-template.yaml +84 -0
  130. package/plugins/benchmarks/templates/pipeline/waterfall-template.yaml +106 -0
  131. package/plugins/benchmarks/templates/skills/requirement-analyzer-template.yaml +48 -0
  132. package/plugins/commands/README.en.md +96 -0
  133. package/plugins/commands/README.md +96 -0
  134. package/plugins/commands/apply.md +191 -0
  135. package/plugins/commands/archive.md +76 -0
  136. package/plugins/commands/env-export.md +79 -0
  137. package/plugins/commands/env-sync.md +640 -0
  138. package/plugins/commands/env-template.md +223 -0
  139. package/plugins/commands/env-update.md +264 -0
  140. package/plugins/commands/env-validate.md +176 -0
  141. package/plugins/commands/env.md +79 -0
  142. package/plugins/commands/explore.md +76 -0
  143. package/plugins/commands/field-evolve.md +536 -0
  144. package/plugins/commands/memory.md +249 -0
  145. package/plugins/commands/project-evolve.md +821 -0
  146. package/plugins/commands/propose.md +93 -0
  147. package/plugins/commands/review.md +140 -0
  148. package/plugins/commands/run.md +224 -0
  149. package/plugins/commands/status.md +62 -0
  150. package/plugins/commands/validate.md +108 -0
  151. package/plugins/hooks/README.en.md +56 -0
  152. package/plugins/hooks/README.md +56 -0
  153. package/plugins/hooks/ai-project-guard.js +329 -0
  154. package/plugins/hooks/artifact-evaluation-hook.js +237 -0
  155. package/plugins/hooks/constitution-guard.js +211 -0
  156. package/plugins/hooks/environment-autocommit.js +264 -0
  157. package/plugins/hooks/environment-manager.js +778 -0
  158. package/plugins/hooks/execution-tracker.js +354 -0
  159. package/plugins/hooks/frozen-zone-guard.js +140 -0
  160. package/plugins/hooks/layer1-validator.js +423 -0
  161. package/plugins/hooks/lib/artifact-evaluator.js +414 -0
  162. package/plugins/hooks/lib/benchmarks/change-detector.js +390 -0
  163. package/plugins/hooks/lib/benchmarks/evaluator.js +605 -0
  164. package/plugins/hooks/lib/benchmarks/integration-example.js +169 -0
  165. package/plugins/hooks/lib/data-and-ai-detector.js +275 -0
  166. package/plugins/hooks/lib/detection-pattern-loader.js +865 -0
  167. package/plugins/hooks/lib/directory-discovery.js +395 -0
  168. package/plugins/hooks/lib/environment-config-loader.js +341 -0
  169. package/plugins/hooks/lib/environment-detector.js +553 -0
  170. package/plugins/hooks/lib/environment-evolver.js +564 -0
  171. package/plugins/hooks/lib/environment-registry.js +813 -0
  172. package/plugins/hooks/lib/execution-path.js +427 -0
  173. package/plugins/hooks/lib/hook-error-recorder.js +245 -0
  174. package/plugins/hooks/lib/hook-logger.js +538 -0
  175. package/plugins/hooks/lib/hook-runner.js +97 -0
  176. package/plugins/hooks/lib/hook-runner.sh +44 -0
  177. package/plugins/hooks/lib/hook-state-manager.js +480 -0
  178. package/plugins/hooks/lib/memory-extractor.js +377 -0
  179. package/plugins/hooks/lib/memory-manager.js +673 -0
  180. package/plugins/hooks/lib/metrics-analyzer.js +489 -0
  181. package/plugins/hooks/lib/project-evolution/auto-fixer.js +511 -0
  182. package/plugins/hooks/lib/project-evolution/memory-manager.js +346 -0
  183. package/plugins/hooks/lib/project-evolution/pattern-detector.js +476 -0
  184. package/plugins/hooks/lib/project-evolution/semantic-indexer.js +480 -0
  185. package/plugins/hooks/lib/project-structure-detector.js +326 -0
  186. package/plugins/hooks/lib/rollback-tracker.js +346 -0
  187. package/plugins/hooks/lib/source-code-scanner.js +596 -0
  188. package/plugins/hooks/lib/technology-stack-detector.js +374 -0
  189. package/plugins/hooks/lib/test-failure-analyzer.js +375 -0
  190. package/plugins/hooks/lib/test-failure-fixer.js +268 -0
  191. package/plugins/hooks/lib/trace-context.js +277 -0
  192. package/plugins/hooks/lib/validation-patterns.js +415 -0
  193. package/plugins/hooks/memory-sync.js +171 -0
  194. package/plugins/hooks/pipeline-observer.js +413 -0
  195. package/plugins/hooks/scope-sentinel.js +204 -0
  196. package/plugins/hooks/trace-initialization.js +169 -0
  197. package/plugins/memory/templates/code-quality.yaml +149 -0
  198. package/plugins/memory/templates/multi-system.yaml +155 -0
  199. package/plugins/memory/templates/team-habits.yaml +119 -0
  200. package/plugins/memory/templates/testing.yaml +121 -0
  201. package/plugins/skills/README.en.md +47 -0
  202. package/plugins/skills/README.md +104 -0
  203. package/plugins/skills/benchmark-executor/README.md +93 -0
  204. package/plugins/skills/benchmark-executor/SKILL.md +647 -0
  205. package/plugins/skills/benchmark-generator/SKILL.md +349 -0
  206. package/plugins/skills/delivery-stage/SKILL.md +203 -0
  207. package/plugins/skills/design-stage/SKILL.md +216 -0
  208. package/plugins/skills/evolution-process/SKILL.md +291 -0
  209. package/plugins/skills/exploration-phase/SKILL.md +133 -0
  210. package/plugins/skills/implementation-stage/SKILL.md +179 -0
  211. package/plugins/skills/layer1-validation/SKILL.md +79 -0
  212. package/plugins/skills/pending-dashboard/SKILL.md +109 -0
  213. package/plugins/skills/project-evolution/SKILL.md +847 -0
  214. package/plugins/skills/requirement-stage/SKILL.md +183 -0
  215. package/plugins/skills/skill-forge/SKILL.md +223 -0
  216. package/plugins/skills/skill-forge/references/description-guide.md +92 -0
  217. package/plugins/skills/skill-forge/references/quality-rubric.md +104 -0
  218. package/plugins/skills/skill-forge/references/skill-template.md +106 -0
  219. package/plugins/skills/startup-guard/SKILL.md +38 -0
  220. package/plugins/skills/testing-stage/SKILL.md +195 -0
  221. package/scripts/cli/global-init.js +288 -0
  222. package/scripts/cli/global.js +324 -0
  223. package/scripts/cli/index.js +55 -0
  224. package/scripts/cli/init.js +382 -0
  225. package/scripts/cli/list.js +69 -0
  226. package/scripts/cli/org.js +340 -0
  227. package/scripts/cli/update.js +44 -0
  228. package/scripts/config/commands.config.js +145 -0
  229. package/scripts/config/hooks.config.js +197 -0
  230. package/scripts/evolution/evolution-router.js +273 -0
  231. package/scripts/evolution/evolution-signal-collector.js +307 -0
  232. package/scripts/evolution/knowledge-loader.js +346 -0
  233. package/scripts/evolution/marketplace.js +317 -0
  234. package/scripts/evolution/version-manager.js +371 -0
  235. package/scripts/install/agents.js +106 -0
  236. package/scripts/install/commands.js +133 -0
  237. package/scripts/install/constants.js +424 -0
  238. package/scripts/install/hook-logger.js +536 -0
  239. package/scripts/install/hooks.js +110 -0
  240. package/scripts/install/index.js +39 -0
  241. package/scripts/install/skills.js +95 -0
  242. package/scripts/postinstall.js +25 -0
  243. package/scripts/state.js +376 -0
@@ -0,0 +1,318 @@
1
+ # AI Native 团队文化手册
2
+
3
+ > 本手册定义 AI Native 团队的文化原则、工作方式和协作规范。
4
+ > 与 `knowledge/principles/constitution.md` 互补,宪法红线在此同样生效。
5
+
6
+ ## 核心理念
7
+
8
+ AI Native 团队不是"使用 AI 的团队",而是"以 AI 为核心设计工作流的团队"。
9
+
10
+ ### AI Native 四原则
11
+
12
+ | 原则 | 描述 | 实践 |
13
+ |------|------|------|
14
+ | **AI 思维贯穿** | 每个角色都具备 AI 思维特质,不只是 AI 工程师 | 产品经理懂 AI 能力边界,工程师会用 AI 辅助编程 |
15
+ | **数据驱动** | 决策有数据支撑,效果有评测验证 | 需求有用户数据,AI 功能有效果评测 |
16
+ | **快速验证** | AI 功能先验证可行性再大规模开发 | MVP → 验证 → 迭代,不盲目铺量 |
17
+ | **人机协作** | 明确 AI 与人各自擅长的领域 | AI 负责实现,人负责验收和决策 |
18
+
19
+ ---
20
+
21
+ ## 工作模式
22
+
23
+ ### 1. Vibe Coding( vibe 编程)
24
+
25
+ > 核心理念:自然语言描述需求,AI 生成代码,人类验收。
26
+
27
+ **传统模式 vs Vibe Coding**:
28
+
29
+ | 维度 | 传统模式 | Vibe Coding |
30
+ |------|---------|-------------|
31
+ | 需求表达 | 写 PRD、User Story | 自然语言描述 + 示例 |
32
+ | 代码实现 | 人类工程师编写 | AI 生成 |
33
+ | 人类角色 | 实现者 + 审查者 | 验收者 + 架构师 |
34
+ | 关注点 | 怎么实现 | 要什么效果 |
35
+
36
+ **Vibe Coding 流程**:
37
+
38
+ ```
39
+ 1. 需求澄清
40
+
41
+ 2. 自然语言描述 + 示例
42
+
43
+ 3. AI 生成代码(可多轮迭代)
44
+
45
+ 4. 人类验收(功能 + 性能 + 安全)
46
+
47
+ 5. 通过 → 提交 | 不通过 → 反馈给 AI 修复
48
+ ```
49
+
50
+ **适用场景**:
51
+ - 功能明确、边界清晰的需求
52
+ - 重复性 CRUD 页面
53
+ - 测试用例生成
54
+ - 文档生成
55
+
56
+ **不适用场景**:
57
+ - 架构决策
58
+ - 安全敏感逻辑
59
+ - 性能关键路径
60
+ - 全新技术领域
61
+
62
+ ### 2. AI 结对编程
63
+
64
+ > 核心理念:AI Agent 作为"第二开发者",与人类工程师协同工作。
65
+
66
+ **角色分工**:
67
+
68
+ | 角色 | 职责 |
69
+ |------|------|
70
+ | **人类工程师** | 架构决策、Code Review、复杂问题解决 |
71
+ | **AI 开发者** | 代码实现、测试生成、文档编写、Bug 修复 |
72
+
73
+ **协作模式**:
74
+
75
+ ```
76
+ 人类工程师
77
+
78
+ ├──→ 需求描述
79
+ │ ↓
80
+ ←── AI 产出 ←── AI 开发者实现
81
+
82
+ ├──→ 反馈/修正
83
+ │ ↓
84
+ ←── 修订版 ←── AI 开发者修复
85
+
86
+ └──→ 最终验收
87
+ ```
88
+
89
+ **关键原则**:
90
+ - AI 产出必须经过人类审查
91
+ - 复杂逻辑人类先行设计,AI 填充实现
92
+ - 安全相关代码人类重点审查
93
+
94
+ ### 3. 多代理审查系统
95
+
96
+ > 核心理念:并行启动多个专业审查 Agent,从不同角度审查代码。
97
+
98
+ 借鉴 Anthropic Claude Code 的实践:
99
+
100
+ ```
101
+ ┌─────────────────────────────────────┐
102
+ │ Code Review Pipeline │
103
+ ├─────────────────────────────────────┤
104
+ │ 并行启动多个审查 Agent: │
105
+ │ ├── 架构审查 Agent │
106
+ │ ├── 安全审查 Agent │
107
+ │ ├── 性能审查 Agent │
108
+ │ ├── 可维护性审查 Agent │
109
+ │ └── 逻辑审查 Agent │
110
+ ├─────────────────────────────────────┤
111
+ │ 汇总审查结果 │
112
+ │ ├── 一致通过项 │
113
+ │ ├── 分歧项 │
114
+ │ └── 必须修复项 │
115
+ ├─────────────────────────────────────┤
116
+ │ 人类最终确认 │
117
+ └─────────────────────────────────────┘
118
+ ```
119
+
120
+ **审查维度**:
121
+
122
+ | 维度 | 检查内容 |
123
+ |------|---------|
124
+ | 架构 | 模块划分、依赖关系、扩展性 |
125
+ | 安全 | 注入漏洞、越权、敏感数据 |
126
+ | 性能 | 复杂度、N+1、缓存策略 |
127
+ | 可维护性 | 代码重复、命名、注释 |
128
+ | 逻辑 | 业务逻辑正确性、边界条件 |
129
+
130
+ ---
131
+
132
+ ## 角色转变
133
+
134
+ ### 从"实现者"到"验收者"
135
+
136
+ | 传统角色 | AI Native 角色 |
137
+ |---------|--------------|
138
+ | 写代码 | 描述需求 + 验收代码 |
139
+ | 解决 bug | 指导 AI 定位 + 验证修复 |
140
+ | 写测试 | 审查 AI 生成的测试 |
141
+ | 写文档 | 审核 AI 生成的文档 |
142
+
143
+ ### 各角色 AI Native 视角
144
+
145
+ #### CEO / 创始人
146
+
147
+ - 战略决策考虑 AI 能力边界
148
+ - 识别 AI 带来的新机会
149
+ - 评估 AI 投资回报率
150
+
151
+ #### 产品经理
152
+
153
+ - 理解 AI 能力边界,不过度承诺
154
+ - 用自然语言表达需求
155
+ - 设计 AI 可理解的验收标准
156
+
157
+ #### 技术负责人
158
+
159
+ - AI 架构思维,评估 AI 方案可行性
160
+ - 设计人机协作流程
161
+ - 建立 AI 效果评测体系
162
+
163
+ #### 工程师
164
+
165
+ - AI 集成思维,API 设计考虑 AI 调用
166
+ - 掌握 AI 辅助编程工具
167
+ - 审查 AI 生成的代码
168
+
169
+ #### AI 工程师
170
+
171
+ - 模型选型与 Prompt 工程
172
+ - AI 效果优化
173
+ - AI 与业务系统的集成
174
+
175
+ ---
176
+
177
+ ## 决策流程
178
+
179
+ ### AI 参与决策的边界
180
+
181
+ | 决策类型 | AI 角色 | 人类角色 |
182
+ |---------|--------|---------|
183
+ | 需求澄清 | 主导(11维扫描) | 确认 |
184
+ | 技术方案 | 建议(多方案生成) | 选择 |
185
+ | 代码实现 | 主导 | 验收 |
186
+ | 安全决策 | 辅助(扫描) | 主导 |
187
+ | 架构决策 | 建议 | 主导 |
188
+ | 部署决策 | 风险评估 | 确认 |
189
+
190
+ ### 人机协作决策树
191
+
192
+ ```
193
+ 决策点
194
+
195
+ ├── 安全敏感?
196
+ │ ├── 是 → 人类主导,AI 辅助
197
+ │ └── 否 → 继续
198
+
199
+ ├── 可逆决策?
200
+ │ ├── 是 → AI 主导,人类抽检
201
+ │ └── 否 → 继续
202
+
203
+ └── 影响范围大?
204
+ ├── 是 → 人类确认
205
+ └── 否 → AI 自主
206
+ ```
207
+
208
+ ---
209
+
210
+ ## 团队能力要求
211
+
212
+ ### 技能矩阵
213
+
214
+ | 角色 | AI 基础技能 | AI 进阶技能 |
215
+ |------|------------|------------|
216
+ | 产品 | AI 需求表达、AI 效果评估 | AI 方案评估 |
217
+ | 工程师 | AI 辅助编程、AI 代码审查 | AI 架构设计 |
218
+ | AI 工程师 | Prompt 工程、模型调优 | AI 系统设计 |
219
+ | 管理者 | AI 团队管理、AI 投资评估 | AI 战略规划 |
220
+
221
+ ### 培训体系
222
+
223
+ 1. **入门**:AI 辅助编程工具使用
224
+ 2. **进阶**:AI 代码审查与质量控制
225
+ 3. **专家**:AI 架构设计与团队赋能
226
+
227
+ ---
228
+
229
+ ## 实践指南
230
+
231
+ ### 1. AI 需求表达
232
+
233
+ 好的需求描述:
234
+
235
+ ```
236
+ "用户登录后展示订单列表,每个订单显示:
237
+ - 订单号(订单号格式:ORD-YYYYMMDD-XXXX)
238
+ - 下单时间(格式:YYYY-MM-DD HH:mm)
239
+ - 订单金额
240
+ - 订单状态(待支付/已支付/已完成/已取消)
241
+
242
+ 点击订单跳转到订单详情页。"
243
+
244
+ → AI 可直接生成完整功能
245
+ ```
246
+
247
+ 差的需求描述:
248
+
249
+ ```
250
+ "做一个订单功能"
251
+
252
+ → AI 需要多次澄清,效率低
253
+ ```
254
+
255
+ ### 2. AI 代码验收清单
256
+
257
+ - [ ] 功能完整性:需求中的每个点都有实现
258
+ - [ ] 边界条件:空值、异常、超长都有处理
259
+ - [ ] 性能合理:没有明显的性能问题
260
+ - [ ] 安全合规:没有注入、越权等漏洞
261
+ - [ ] 代码质量:命名清晰,逻辑可读
262
+
263
+ ### 3. AI 反馈技巧
264
+
265
+ | 场景 | 反馈方式 |
266
+ |------|---------|
267
+ | 功能不对 | "期望行为是 X,实际是 Y" |
268
+ | 风格不对 | "参考现有代码风格:..." |
269
+ | 效率低 | "需要优化性能,参考:..." |
270
+ | 边界漏了 | "还需要处理 X 情况" |
271
+
272
+ ---
273
+
274
+ ## 与现有流程集成
275
+
276
+ ### 与 6 阶段流程的对应
277
+
278
+ | 阶段 | AI 增强点 |
279
+ |------|----------|
280
+ | 需求分析 | AI 辅助需求澄清、竞品分析 |
281
+ | 方案设计 | AI 辅助架构设计、API 推导 |
282
+ | 编码实现 | Vibe Coding、AI 结对编程 |
283
+ | 测试验证 | AI 测试生成、AI 异常检测 |
284
+ | 部署交付 | AI 部署风险评估 |
285
+ | 归档复盘 | AI 辅助 practice-log 分析 |
286
+
287
+ ### 与双层验证的集成
288
+
289
+ - **Layer 1**:AI 辅助的自动化验证
290
+ - **Layer 2**:多代理 AI 审查 + 人类确认
291
+
292
+ ---
293
+
294
+ ## 反模式
295
+
296
+ ### 1. 盲目信任 AI
297
+
298
+ - 表现:不审查 AI 产出,直接提交
299
+ - 后果:安全漏洞、质量问题
300
+ - 纠正:所有 AI 产出必须经过验收
301
+
302
+ ### 2. 过度依赖 AI
303
+
304
+ - 表现:所有问题都交给 AI,不自己思考
305
+ - 后果:失去技术判断力
306
+ - 纠正:复杂问题人类先思考,AI 填充实现
307
+
308
+ ### 3. AI 能力过高估计
309
+
310
+ - 表现:给 AI 无法完成的任务
311
+ - 后果:产出质量差,返工多
312
+ - 纠正:明确 AI 能力边界,选择合适场景
313
+
314
+ ### 4. AI 能力过低估计
315
+
316
+ - 表现:能 AI 做的还人工做
317
+ - 后果:效率低,浪费资源
318
+ - 纠正:持续学习 AI 新能力,迭代工作流
@@ -0,0 +1,228 @@
1
+ # 团队度量体系
2
+
3
+ > 本文档定义 AI Native 团队的度量指标体系。
4
+ > 与 `knowledge/organization/ai-native-team.md` 互补。
5
+
6
+ ## 概述
7
+
8
+ AI Native 团队的度量体系需要同时衡量:
9
+ 1. **AI 能力**:AI 在团队中的参与度和效果
10
+ 2. **流程效率**:研发流程的效率和质量
11
+ 3. **产出质量**:最终交付物的质量
12
+
13
+ ---
14
+
15
+ ## 一、AI 能力指标
16
+
17
+ ### 1.1 AI 参与度指标
18
+
19
+ | 指标 | 定义 | 计算方式 | 目标 |
20
+ |------|------|---------|------|
21
+ | **AI 代码占比** | AI 参与生成的代码占总代码量比例 | AI 生成行数 / 总代码行数 | > 40% |
22
+ | **AI 审查覆盖率** | AI 审查覆盖的变更比例 | AI 审查次数 / 总变更次数 | 100% |
23
+ | **AI 测试覆盖率** | AI 生成的测试占总测试比例 | AI 生成测试数 / 总测试数 | > 60% |
24
+
25
+ ### 1.2 AI 质量指标
26
+
27
+ | 指标 | 定义 | 计算方式 | 目标 |
28
+ |------|------|---------|------|
29
+ | **AI 首次通过率** | AI 生成的代码一次通过审查的比例 | 一次通过次数 / AI 生成提交次数 | > 70% |
30
+ | **AI 修复效率** | AI 修复问题的平均次数 | 修复总次数 / 问题数 | < 2 次 |
31
+ | **AI 误报率** | AI 审查中误报的比例 | 误报数 / 总报告数 | < 15% |
32
+
33
+ ### 1.3 AI 效率指标
34
+
35
+ | 指标 | 定义 | 计算方式 | 目标 |
36
+ |------|------|---------|------|
37
+ | **AI 响应时间** | AI 从请求到响应的时间 | 平均响应时间 | < 30s |
38
+ | **AI 并行度** | 同时运行的 AI 任务数 | 峰值并发数 | > 5 |
39
+ | **AI 成本效率** | 每单位成本的 AI 产出 | 代码行数 / AI 成本 | 持续优化 |
40
+
41
+ ---
42
+
43
+ ## 二、流程效率指标
44
+
45
+ ### 2.1 阶段效率指标
46
+
47
+ | 阶段 | 指标 | 定义 | 目标 |
48
+ |------|------|------|------|
49
+ | 需求分析 | 需求澄清效率 | 需求到澄清完成的时间 | < 4h |
50
+ | 方案设计 | 设计完成率 | 按计划完成设计的比例 | > 90% |
51
+ | 编码实现 | 代码交付速度 | 每日提交行数 | 符合估算 |
52
+ | 代码审查 | 审查响应时间 | 发起审查到首次响应 | < 4h |
53
+ | 测试验证 | 测试通过率 | 首次提交测试通过率 | > 80% |
54
+ | 交付部署 | 部署成功率 | 首次部署成功比例 | > 95% |
55
+
56
+ ### 2.2 迭代效率指标
57
+
58
+ | 指标 | 定义 | 计算方式 | 目标 |
59
+ |------|------|---------|------|
60
+ | **周期时间** | 从需求到交付的总时间 | 交付时间 - 需求确认时间 | 持续缩短 |
61
+ | **前置时间** | 需求确认到开始开发 | 开始时间 - 确认时间 | < 1 工作日 |
62
+ | **批量大小** | 平均每次交付的需求数 | 交付需求数 / 交付次数 | 1-3 个 |
63
+ | **在制品数量** | 同时进行的需求数 | 平均并行需求数 | < 5 个 |
64
+
65
+ ### 2.3 阻塞指标
66
+
67
+ | 指标 | 定义 | 计算方式 | 目标 |
68
+ |------|------|---------|------|
69
+ | **阻塞率** | 被阻塞的阶段比例 | 阻塞次数 / 阶段总数 | < 10% |
70
+ | **阻塞时长** | 平均阻塞时间 | 阻塞总时长 / 阻塞次数 | < 4h |
71
+ | **升级率** | 需要人工介入的比例 | 升级次数 / 总任务数 | < 5% |
72
+
73
+ ---
74
+
75
+ ## 三、质量指标
76
+
77
+ ### 3.1 代码质量指标
78
+
79
+ | 指标 | 定义 | 目标 |
80
+ |------|------|------|
81
+ | **缺陷密度** | 每千行代码的缺陷数 | < 1 个/千行 |
82
+ | **代码覆盖率** | 被测试覆盖的代码比例 | > 80% |
83
+ | **技术债务比** | 技术债务与代码总量比 | < 5% |
84
+ | **代码重复率** | 重复代码的比例 | < 3% |
85
+
86
+ ### 3.2 审查质量指标
87
+
88
+ | 指标 | 定义 | 目标 |
89
+ |------|------|------|
90
+ | **审查通过率** | 首次提交通过审查的比例 | > 70% |
91
+ | **审查意见数** | 平均每次审查的意见数 | 5-15 条 |
92
+ | **审查时间** | 从提交到通过的平均时间 | < 1 工作日 |
93
+
94
+ ### 3.3 交付质量指标
95
+
96
+ | 指标 | 定义 | 目标 |
97
+ |------|------|------|
98
+ | **线上缺陷率** | 线上发现的缺陷数 | < 2 个/版本 |
99
+ | **回滚率** | 需要回滚的部署比例 | < 2% |
100
+ | **P0 故障数** | 严重故障数量 | 0 |
101
+
102
+ ---
103
+
104
+ ## 四、团队健康指标
105
+
106
+ ### 4.1 协作健康
107
+
108
+ | 指标 | 定义 | 目标 |
109
+ |------|------|------|
110
+ | **任务完成率** | 按计划完成的任务比例 | > 90% |
111
+ | **返工率** | 需要返工的任务比例 | < 10% |
112
+ | **沟通成本** | 会议时间占比 | < 15% |
113
+
114
+ ### 4.2 成长健康
115
+
116
+ | 指标 | 定义 | 目标 |
117
+ |------|------|------|
118
+ | **技能增长率** | 新技能掌握速度 | 持续提升 |
119
+ | **知识分享数** | 团队分享次数 | 每周 > 2 次 |
120
+ | **自动化程度** | 自动化任务占比 | 持续提升 |
121
+
122
+ ---
123
+
124
+ ## 五、度量采集
125
+
126
+ ### 5.1 自动采集
127
+
128
+ | 数据源 | 采集内容 | 频率 |
129
+ |--------|---------|------|
130
+ | Git | 提交、审查、合并数据 | 实时 |
131
+ | CI/CD | 构建、测试、部署数据 | 实时 |
132
+ | 项目管理 | 任务流转、阻塞数据 | 实时 |
133
+ | 监控 | 线上质量数据 | 实时 |
134
+
135
+ ### 5.2 手动采集
136
+
137
+ | 数据源 | 采集内容 | 频率 |
138
+ |--------|---------|------|
139
+ | 回顾会 | 团队反馈、改进建议 | 每周 |
140
+ | 调查问卷 | 团队满意度 | 每月 |
141
+ | 一对一 | 个人成长、挑战 | 每月 |
142
+
143
+ ---
144
+
145
+ ## 六、度量看板
146
+
147
+ ### 6.1 核心看板
148
+
149
+ ```
150
+ ┌─────────────────────────────────────────────────────────────┐
151
+ │ AI Native 团队度量看板 │
152
+ ├─────────────────────────────────────────────────────────────┤
153
+ │ │
154
+ │ AI 能力 流程效率 质量 │
155
+ │ ┌──────────┐ ┌──────────┐ ┌────────┐ │
156
+ │ │AI代码占比 │ │周期时间 │ │缺陷密度│ │
157
+ │ │ 45% │ │ 5天 │ │ 0.8 │ │
158
+ │ │ ↑5% │ │ ↓1天 │ │ ↓0.2 │ │
159
+ │ └──────────┘ └──────────┘ └────────┘ │
160
+ │ │
161
+ │ ┌──────────┐ ┌──────────┐ ┌────────┐ │
162
+ │ │AI首次通过 │ │审查响应 │ │覆盖率 │ │
163
+ │ │ 75% │ │ 3h │ │ 85% │ │
164
+ │ │ ↑10% │ │ ↓1h │ │ ↑5% │ │
165
+ │ └──────────┘ └──────────┘ └────────┘ │
166
+ │ │
167
+ └─────────────────────────────────────────────────────────────┘
168
+ ```
169
+
170
+ ### 6.2 趋势分析
171
+
172
+ | 指标 | 周环比 | 月环比 | 季度趋势 |
173
+ |------|-------|-------|---------|
174
+ | AI 代码占比 | +3% | +8% | ↑ |
175
+ | 周期时间 | -0.5天 | -1天 | ↓ |
176
+ | 缺陷密度 | -0.1 | -0.3 | ↓ |
177
+
178
+ ---
179
+
180
+ ## 七、目标设定
181
+
182
+ ### 7.1 短期目标(1-3个月)
183
+
184
+ | 指标 | 当前值 | 目标值 |
185
+ |------|-------|-------|
186
+ | AI 代码占比 | 30% | 40% |
187
+ | AI 首次通过率 | 60% | 70% |
188
+ | 审查响应时间 | 6h | 4h |
189
+
190
+ ### 7.2 中期目标(3-6个月)
191
+
192
+ | 指标 | 当前值 | 目标值 |
193
+ |------|-------|-------|
194
+ | AI 代码占比 | 40% | 50% |
195
+ | 周期时间 | 5天 | 3天 |
196
+ | 缺陷密度 | 0.8 | 0.5 |
197
+
198
+ ### 7.3 长期目标(6-12个月)
199
+
200
+ | 指标 | 当前值 | 目标值 |
201
+ |------|-------|-------|
202
+ | AI 代码占比 | 50% | 60% |
203
+ | 自动化程度 | 70% | 90% |
204
+ | 线上缺陷率 | 1.5 | < 1 |
205
+
206
+ ---
207
+
208
+ ## 八、持续优化
209
+
210
+ ### 8.1 度量评审
211
+
212
+ - **周度**:查看核心指标趋势
213
+ - **月度**:分析目标达成情况
214
+ - **季度**:调整目标和策略
215
+
216
+ ### 8.2 改进闭环
217
+
218
+ ```
219
+ 发现 → 分析 → 制定 → 执行 → 验证
220
+ ↑______________________________↓
221
+ ```
222
+
223
+ ### 8.3 注意事项
224
+
225
+ 1. **不追求完美指标**:指标是工具,不是目的
226
+ 2. **关注趋势**:比关注绝对值更重要的是趋势
227
+ 3. **避免过度度量**:度量有成本,聚焦关键指标
228
+ 4. **结合定性分析**:定量 + 定性 = 完整画像
@@ -0,0 +1,134 @@
1
+ # 项目宪法 — 不可违反的红线清单
2
+
3
+ > 宪法门禁(DP10):自动检查,违反任何一条立即停止全流程。
4
+ >
5
+ > **版本**: v2.0
6
+ > **最后更新**: 2026-03-26
7
+ > **基于**: 业界风险防范基本条例、核心原则
8
+
9
+ ## 安全红线
10
+
11
+ 1. **不可逆动作必须人工确认**
12
+ - 数据库迁移(DDL变更)
13
+ - 生产环境部署
14
+ - 外部API发送(邮件、短信、支付等)
15
+ - 数据删除(DELETE/TRUNCATE)
16
+ - 分支强制推送
17
+
18
+ 2. **敏感信息不可硬编码**
19
+ - 密钥、密码、Token不可出现在代码中
20
+ - 生产环境配置不可出现在代码仓库中
21
+ - 用户隐私数据不可出现在日志中
22
+
23
+ 3. **安全漏洞零容忍**
24
+ - SQL注入
25
+ - XSS(跨站脚本)
26
+ - CSRF(跨站请求伪造)
27
+ - 越权访问
28
+ - 未加密传输敏感数据
29
+
30
+ ## 流程红线
31
+
32
+ 4. **启动门禁不可跳过**
33
+ - 收到开发/建设类任务时,必须先执行启动协议(读pipeline→读宪法→确认范围)
34
+ - 禁止跳过需求分析直接写代码
35
+ - "全流程自动化"≠"跳过流程",而是"按框架自动推进各阶段"
36
+
37
+ 5. **Layer 1不过不进Layer 2**
38
+ - 确定性验证(编译/测试/lint)失败时,禁止进入AI审查
39
+ - 测试红灯时,禁止声明代码完成
40
+
41
+ 6. **Layer 1必须真实执行**
42
+ - 禁止用"静态分析评估"替代真实执行来声称Layer 1通过
43
+ - 无法执行 → 标记为BLOCKED,不是PASSED
44
+ - BLOCKED → 先解决环境问题,或降级为experiment模式
45
+ - Layer 1结果必须附带真实执行日志
46
+
47
+ 7. **做审必须分离**
48
+ - 做类skill和审类skill必须由不同AI实例执行
49
+ - 审查必须通过Agent工具启动独立子进程,实现信息隔离
50
+ - 禁止同一上下文中切换角色冒充分离
51
+
52
+ 8. **回退上限3次**
53
+ - 同一问题修正循环超过3次必须升级人工
54
+ - 禁止无限循环修复
55
+
56
+ 9. **关键假设必须显式记录**
57
+ - 每个阶段的关键假设必须写入文件
58
+ - 阶段间传递时必须校验假设一致性
59
+ - 待确认假设超过3个必须升级人工
60
+
61
+ ## 决策红线
62
+
63
+ 10. **方向性决策必须人工确认**
64
+ - 需求方向和范围变更
65
+ - 架构重大变更(如单体→微服务)
66
+ - 安全敏感决策
67
+ - 新技术引入
68
+ - 自动模式下:标记为 REQUIRE_REVIEW + pendingConfirmations,不阻塞但不执行
69
+
70
+ 11. **知情猜测有上限**
71
+ - 最多3个NEEDS CLARIFICATION标记
72
+ - 其余做合理默认但不可隐藏假设
73
+
74
+ ## 执行模式红线
75
+
76
+ > 自动模式(unattended)不降低安全标准,只改变确认方式。
77
+
78
+ - **以下红线在自动模式下不可降级**(两种模式同等执行):
79
+ - 安全红线(#1-#3)全部生效
80
+ - Layer 1 真实执行(#5-#6)全部生效
81
+ - 做审分离(#7)全部生效
82
+ - 数据完整性(#12)全部生效
83
+ - 部署可回滚(#13)全部生效
84
+ - 安全审计结论为"不安全" → 两种模式都阻止执行
85
+ - **以下确认行为在自动模式下可降级为记录**:
86
+ - 不可逆动作确认(#1)→ 生成方案但不执行,记录 pendingConfirmations
87
+ - 阶段产出确认(#4 流程中的人工确认点)→ 使用 stage-gate Agent 替代
88
+ - 方向性决策确认(#10)→ 使用推荐值,标记 REQUIRE_REVIEW
89
+ - 待确认假设升级(#9)→ 记录但不阻塞,标记 HIGH_PRIORITY_REVIEW
90
+ - **自动模式完成后,pendingConfirmations 中的所有项必须在下次交互中向用户展示**
91
+
92
+ ## 数据红线
93
+
94
+ 12. **数据完整性不可妥协**
95
+ - 禁止跳过数据校验
96
+ - 禁止未经验证的数据格式转换
97
+ - 禁止金额使用浮点数运算(必须使用 Money 类或 BigDecimal)
98
+ - 禁止 SELECT * 查询(必须指定列名)
99
+ - 禁止使用 ${} 进行 SQL 拼接(必须使用 #{} 参数化查询)
100
+
101
+ ## 运维红线
102
+
103
+ 13. **部署必须可回滚**
104
+ - 每次部署必须有回滚方案
105
+ - 回滚方案必须经过验证
106
+ - 禁止"只能前进不能后退"的部署
107
+
108
+ 14. **监控与日志规范**
109
+ - 关键业务节点必须打印日志(使用 LogUtil,带 TraceId)
110
+ - 禁止直接使用 logger 打印(无 TraceId,无法链路追踪)
111
+ - 禁止空 catch 块(异常必须记录日志并处理)
112
+ - 异步方法必须捕获异常(防止异常吞掉)
113
+ - 必须考虑三板斧:灰度、监控、应急
114
+
115
+ 15. **并发控制**
116
+ - 更新数据前必须加锁(一锁二判三更新原则)
117
+ - 禁止使用无界线程池(队列长度建议≤100)
118
+ - ThreadLocal 使用完毕后必须调用 remove() 清理
119
+
120
+ ## 停线条件
121
+
122
+ 以下任一条件成立 → 立即停止全流程,等待人工处理:
123
+ - 检测到安全漏洞(上述第3条)
124
+ - 检测到数据丢失风险
125
+ - 同一问题修复3次仍未通过
126
+ - 宪法门禁检查不通过
127
+ - AI自我判断置信度极低(无法给出合理默认值)
128
+
129
+ ## 宪法修订规则
130
+
131
+ - 本宪法的修改必须人工审批
132
+ - AI不可自行修改或绕过宪法条款
133
+ - 每季度review一次,确认条款仍然合理
134
+ - 新增条款需说明来源(哪个事件/风险触发)