@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,216 @@
1
+ ---
2
+ name: design-stage
3
+ description: "When technical design, architecture planning, API design, or database schema design is needed — loads AutoSpec design process and skill."
4
+ ---
5
+
6
+ # AutoSpec 方案设计(Stage 02)
7
+
8
+ 你正在执行方案设计阶段。此阶段将需求文档转化为可指导编码的技术方案。
9
+
10
+ ## 前置检查
11
+
12
+ 1. 确认需求分析阶段已完成(检查 `.autospec/runtime/state.json`)
13
+ 2. 读取 `${KNOWLEDGE}/principles/constitution.md` → 确认红线
14
+ 3. 读取上游精炼契约(需求文档)
15
+ 4. **检查是否为多系统项目**:读取 `.autospec/runtime/config.json` 的 `subsystems` 字段
16
+ 5. **检查是否需要效果指标设计**:检查是否有 ai 类型子系统或需求文档包含效果指标
17
+ 6. 加载创业团队角色画像:读取 `${KNOWLEDGE}/guides/stages/` 目录下的角色文件
18
+ 7. 加载方法论原则:读取 `${KNOWLEDGE}/principles/core-principles.md` → 注入 P7(class先于instance)、P8(抽象力度控制)、P3(系统六要素) 等设计原则
19
+ 8. 加载设计哲学:读取 `${KNOWLEDGE}/principles/design-philosophy.md` → 注入 DP15(Brownfield适配)、DP16(模板即约束) 原则
20
+ 9. 加载认知增强原则:读取 `${KNOWLEDGE}/principles/core-principles.md` → 本阶段重点应用 CP4(逻辑链完整)、CP9(刚好够用)、CP5(置信度标注)
21
+
22
+ ## 认知姿态(本阶段:发散→收敛 + 防过度设计)
23
+
24
+ - **CP4 逻辑链完整**:每个技术选型必须说明"选了什么 + 为什么 + 放弃了什么"。关键决策记录不可跳步
25
+ - **CP9 刚好够用**:抵制过度设计。添加架构层次前自问:这是必须的吗?更简单的方案能不能满足需求?
26
+ - **CP5 置信度**:对不确定的设计决策,标注置信度。技术选型的风险评估要诚实标注不确定性
27
+
28
+ ## 执行
29
+
30
+ ### Step 1: 确定模式与复杂度
31
+
32
+ 读取 `.autospec/runtime/config.json`,检查 `subsystems` 字段:
33
+ - **无 subsystems 或长度为1** → 单系统模式
34
+ - **有 subsystems 且长度>1** → 多系统模式
35
+
36
+ **继承或重新评估复杂度**:
37
+ - 如果需求阶段已有复杂度评估,继承结果
38
+ - 如有新的技术复杂度因素,重新评估
39
+
40
+ **【强制】** 读取 `${KNOWLEDGE}/config/team-triggers.yaml`,检查强制触发规则:
41
+ - 涉及新架构/框架 → 强制引入 tech-lead
42
+ - 跨系统变更 → 强制引入 tech-lead + devops-engineer
43
+ - 新服务部署 → 强制引入 devops-engineer
44
+
45
+ ### Step 2: 创业团队对抗设计审查
46
+
47
+ 根据复杂度评估结果,启动团队对抗审查:
48
+
49
+ #### 简单任务(score <= 5)
50
+ 快速通道,仅技术负责人审查:
51
+ - 技术负责人:架构合理性、过度设计检查
52
+
53
+ #### 中等任务(score 6-8)
54
+ 引入工程师视角:
55
+ - 技术负责人 + 相关工程师(根据涉及的子系统类型)
56
+
57
+ #### 复杂任务(score >= 9)
58
+ 引入完整团队:
59
+ - 技术负责人 + 全部相关工程师
60
+ - 如触发强制规则,额外引入安全工程师/运维工程师
61
+
62
+ **对抗审查执行方式**:
63
+
64
+ **自主模式 — 多Agent并行对抗**:
65
+ ```
66
+ **【强制】** 读取 `${KNOWLEDGE}/guides/support/team-orchestrator.md`
67
+ 并行启动角色Agent(信息隔离,做审分离):
68
+ - 技术负责人 Agent:架构合理性、技术选型、过度设计检查
69
+ - 后端工程师 Agent:API设计、数据库设计、性能(如涉及)
70
+ - 前端工程师 Agent:组件设计、状态管理、用户体验(如涉及)
71
+ - 数据工程师 Agent:数据模型、ETL设计(如涉及)
72
+ - AI工程师 Agent:模型选型、评估方案(如涉及)
73
+ - 安全工程师 Agent:安全设计(如触发)
74
+ - 运维工程师 Agent:部署方案、监控设计(如触发)
75
+ 汇总意见,生成团队对抗审查报告
76
+ ```
77
+
78
+ **交互模式 — 与用户互动完成**:
79
+ 将团队各角色的关注点作为确认框架,与用户交互:
80
+ 1. **技术负责人视角**:架构方案、技术选型理由、关键决策
81
+ 2. **工程师视角**:实现可行性、技术风险
82
+ 3. **安全视角**(如触发):安全方案、数据保护
83
+ 4. **运维视角**(如触发):部署方案、监控告警
84
+
85
+ ### Step 3: 单系统模式设计
86
+
87
+ 1. **【强制】** 加载做类skill:读取 `${KNOWLEDGE}/guides/stages/design-planner.md` → **按步骤执行**
88
+ 2. 加载检查清单:读取 `${KNOWLEDGE}/checklists/design.md` → 逐项核对
89
+ 3. 加载元学习方法:读取 `${KNOWLEDGE}/principles/core-principles.md` → 应用"自顶向下+自底向上"双向设计法
90
+ 4. **设计决策的双模式处理**:
91
+ - 技术选型涉及多个可行方案时:
92
+ - 交互模式:展示选项 + 推荐 + 理由,等待用户选择
93
+ - 自动模式:选择推荐方案,记录到 `autoDecisions`(含备选方案和放弃理由)
94
+ - 安全/合规相关设计决策:
95
+ - 两种模式都使用最安全选项
96
+ - 自动模式额外标记 `HIGH_PRIORITY_REVIEW`
97
+ 5. **【效率优化】并行化设计分析**:
98
+ - 架构设计与数据模型设计可并行进行
99
+ - API设计与技术选型可并行进行
100
+ - 使用 Agent 工具并行启动独立分析任务
101
+ 6. **【效率优化】复用已有分析结果**:
102
+ - 检查需求阶段的技术可行性分析结果
103
+ - 复用复杂度评估中的技术约束
104
+ - 避免重复分析相同技术问题
105
+ 7. 产出技术方案文档,写入 `.autospec/specs/{feature}/design.md`
106
+ 8. 如有API设计,写入 `.autospec/specs/{feature}/contracts/`
107
+
108
+ ### Step 4: 多系统模式设计
109
+
110
+ 1. **【效率优化】并行产出整体架构**:写入 `design/overview.md`
111
+ - 系统交互图
112
+ - 数据流向
113
+ - 跨系统接口契约
114
+ - 关键技术决策
115
+ - 依赖关系(开发顺序建议)
116
+ - *注:整体架构设计与子系统设计可并行启动*
117
+
118
+ 2. **【效率优化】并行产出各子系统设计**:
119
+ ```
120
+ # 无依赖的子系统可并行设计
121
+ parallel_for subsystem in config.subsystems(按依赖分组):
122
+ 1. 分析该子系统负责的功能范围
123
+ 2. 设计该子系统的模块、数据模型、API
124
+ 3. 写入 design/{subsystem.name}.md
125
+ ```
126
+
127
+ 3. **产出接口契约**:如有跨系统接口,写入 `contracts/api.yaml`
128
+
129
+ ### Step 5: 效果指标设计(AI/模型类功能)
130
+
131
+ 当项目包含 AI/模型 相关功能时,设计阶段需要额外产出:
132
+
133
+ 1. **效果指标定义**:
134
+ - 核心效果指标(如准确率、召回率、F1、BLEU等)
135
+ - 业务效果指标(如转化率、用户满意度、任务完成率)
136
+ - 效果基线(最低可接受效果)
137
+ - 效果目标(期望达到的效果)
138
+
139
+ 2. **评测方案设计**:
140
+ - 评测数据来源(公开数据集/业务数据/人工构造)
141
+ - 评测方法选择(自动评测/人工评测/A/B测试)
142
+ - 评测频率(离线评测/在线评测)
143
+
144
+ 3. 写入 `design.md` 的"效果指标"章节,或独立产出 `design/evaluation.md`
145
+
146
+ ## 验证
147
+
148
+ ### Layer 1: 确定性验证
149
+ - Schema校验:方案文档包含所有必须字段(架构、数据模型、接口、技术选型、假设清单)
150
+ - 一致性检查:方案中的数据模型与接口定义无矛盾
151
+ - **多系统模式**:overview.md 包含系统交互图和开发顺序
152
+ - **AI/模型功能**:有效果指标章节或 evaluation.md
153
+
154
+ ### Layer 2: AI审查(做审分离)
155
+ 使用 **independent-reviewer** Agent 执行独立审查:
156
+ ```
157
+ **【强制】** 调用 Agent 工具:
158
+ prompt: 请审查以下技术方案。
159
+ 1. 先读取审查标准: ${KNOWLEDGE}/guides/stages/design-reviewer.md
160
+ 2. 被审查文档: .autospec/specs/{feature}/design.md(或 design/ 目录)
161
+ 3. 上游需求文档: .autospec/specs/{feature}/requirement.md(用于校验一致性)
162
+ 注意:你是独立审查者,只看产出物和标准
163
+ ```
164
+
165
+ ### Layer 3: Benchmarks 评测(新增)
166
+
167
+ **【强制】** 执行 design benchmarks 评测:
168
+ ```
169
+ 1. 检测设计产出物完整性
170
+ - design.md(或 design/ 目录)
171
+ - contracts/api.yaml(如适用)
172
+ - data-model.md(如适用)
173
+ 2. 调用 benchmark-executor 执行评测:
174
+ - DES-001: 架构设计完整性(架构图、技术选型理由、非功能需求设计)
175
+ - DES-002: API 设计规范性(RESTful规范、错误码统一、版本管理)
176
+ - DES-003: 数据模型设计(ER图、字段类型、索引设计)
177
+ - DES-004: 设计-需求一致性(可追溯性检查)
178
+ 3. 生成评测报告到 .autospec/benchmarks/results/design-{run-id}.json
179
+ 4. 如评测未通过:
180
+ - 生成改进建议
181
+ - 返回 Step 2 完善设计
182
+ - 最多重试 3 次
183
+ 5. 如评测通过:
184
+ - 记录评测结果
185
+ - 允许进入 implementation stage
186
+ ```
187
+
188
+ **评测触发方式**:
189
+ - 自动触发:design.md 生成后自动执行
190
+ - 手动触发:`/benchmark --run --stage=design`
191
+ - 变更触发:设计文档修改后自动重新评测
192
+
193
+ ## 阶段门禁(所有自主级别)
194
+
195
+ 使用 **stage-gate-evaluator** Agent 评估产出物是否达到准出标准:
196
+ ```
197
+ **【强制】** 调用 Agent 工具:
198
+ prompt: 请评估方案设计阶段的产出物是否达到准出标准。
199
+ 当前阶段:Stage 02 方案设计
200
+ 产出物:.autospec/specs/{feature}/design.md(或 design/ 目录)
201
+ 准出标准:${KNOWLEDGE}/checklists/design.md
202
+ 上游契约:.autospec/specs/{feature}/requirement.md
203
+ 自主级别:{自主/交互}
204
+ ```
205
+
206
+ **根据自主级别处理评估结果**:
207
+ - **交互模式**:评估结果提交人工确认,AI 等待用户批准后继续
208
+ - **自主模式**:评估通过后自动进入下一阶段,评估不通过进入精准回退
209
+
210
+ ## 完成
211
+
212
+ - 两层验证通过 + 阶段门禁评估通过 → 输出精炼契约 → 更新 `.autospec/runtime/state.json` → 进入编码实现
213
+ - 不通过 → 精准回退:
214
+ - Level 1: 内联重试(单次)
215
+ - Level 2: 修正循环(最多3次,只重处理失败项)
216
+ - Level 3: 3次后使用 **failure-diagnostician** Agent 执行根因分析,再升级用户
@@ -0,0 +1,291 @@
1
+ ---
2
+ name: evolution-process
3
+ description: "When framework improvement, skill distillation, methodology extraction, practice log review, or field-evolve execution is needed — loads AutoSpec self-evolution process."
4
+ ---
5
+
6
+ # AutoSpec 自进化(自动感知)
7
+
8
+ 你检测到了与框架进化相关的任务(如:复盘、总结经验、提炼技能、更新方法论、执行 field-evolve)。
9
+
10
+ ## 前置
11
+
12
+ 1. 读取 `${KNOWLEDGE}/evolution.md` → 确认进化分区规则和安全护栏
13
+ 2. 读取 `${KNOWLEDGE}/principles/constitution.md` → 确认红线
14
+ 3. 读取 `${KNOWLEDGE}/principles/core-principles.md` → 本阶段重点 CP6(错误即信号)、CP7(模式识别)
15
+
16
+ ## 认知姿态(本阶段:反思 + 模式提炼)
17
+
18
+ - **CP6 错误即信号**:每次回退/打回/纠正都是进化信号。重点关注:
19
+ - 同类错误第 2 次 → 生成防护规则(更新 checklist)
20
+ - 同类错误第 3 次 → 必须升级对应 skill
21
+ - **CP7 模式识别**:从重复中发现规律。重点检测:
22
+ - 重复出现的任务模式 → 建议新 skill
23
+ - 重复出现的偏好/纠正 → 沉淀为 checklist
24
+ - 重复出现的架构决策 → 沉淀为 decision-tree
25
+
26
+ ## 三层进化体系
27
+
28
+ ```
29
+ ┌─────────────────────────────────────────────────────────────────┐
30
+ │ L1: Self-Evolve (框架级) │
31
+ │ /self-evolve │
32
+ │ 目标: AutoSpec 框架自身的迭代升级 │
33
+ │ 位置: .claude/skills/self-evolve/ │
34
+ └─────────────────────────────────────────────────────────────────┘
35
+ ↓ 提炼
36
+ ┌─────────────────────────────────────────────────────────────────┐
37
+ │ L2: Field-Evolve (领域级) │
38
+ │ /autospec:field-evolve │
39
+ │ 目标: 框架从实战项目中学习和提炼能力 │
40
+ │ 位置: plugins/commands/field-evolve.md │
41
+ └─────────────────────────────────────────────────────────────────┘
42
+ ↓ 应用
43
+ ┌─────────────────────────────────────────────────────────────────┐
44
+ │ L3: Project-Evolve (项目级) │
45
+ │ /autospec:project-evolve │
46
+ │ 目标: 实战项目自身的代码、配置、文档优化 │
47
+ │ 位置: plugins/commands/project-evolve.md │
48
+ └─────────────────────────────────────────────────────────────────┘
49
+ ```
50
+
51
+ ## 进化类型识别
52
+
53
+ 根据触发来源,识别进化类型:
54
+
55
+ | 触发来源 | 进化类型 | 层级 | 处理方式 |
56
+ |---------|---------|------|---------|
57
+ | `/self-evolve` | 框架自我进化 | L1 | 框架自身迭代 |
58
+ | `/autospec:field-evolve --mode=quick` | 快速验证 | L2 | 执行确定性测试,生成报告 |
59
+ | `/autospec:field-evolve --mode=deep` | 深度测试 | L2 | 执行 benchmarks + 评估分析 |
60
+ | `/autospec:field-evolve --mode=full` | 完整循环 | L2 | deep + 改进 + 修复 + 蒸馏 |
61
+ | `/autospec:field-evolve --mode=distill` | 技能蒸馏 | L2 | 从 practice-log 提炼技能 |
62
+ | `/autospec:project-evolve --init-memory` | 初始化记忆 | L3 | 自动发现项目评测点 |
63
+ | `/autospec:project-evolve --cruise` | 智能巡航 | L3 | 全自动持续进化 |
64
+ | `/autospec:project-evolve --deep` | 深度进化 | L3 | 全维度分析+修复 |
65
+ | `/autospec:project-evolve --focus=*` | 专项进化 | L3 | 针对特定维度优化 |
66
+ | 自动触发(practice-log 积累) | 技能蒸馏 | L2 | 同 distill 模式 |
67
+
68
+ ## Field-Evolve 执行流程
69
+
70
+ ### Mode: quick(快速验证)
71
+
72
+ **目标**: 快速验证项目基本健康度
73
+
74
+ ```
75
+ Step 1: 确定技术栈
76
+ - 读取 .autospec/runtime/config.json
77
+ - 识别项目类型和构建工具
78
+
79
+ Step 2: 运行确定性测试
80
+ - 编译检查
81
+ - 单元测试
82
+ - Lint 检查
83
+ - 类型检查(如适用)
84
+
85
+ Step 3: AI 评测
86
+ - 失败分析
87
+ - 覆盖率分析
88
+ - 代码质量评估
89
+
90
+ Step 4: 生成快速报告
91
+ - 测试结果汇总
92
+ - 改进建议
93
+ - 保存到 .autospec/logs/autospec:field-evolve/quick-{date}.md
94
+ ```
95
+
96
+ ### Mode: deep(深度测试)
97
+
98
+ **目标**: 执行 benchmarks 并生成评估报告
99
+
100
+ ```
101
+ Step 1: 扫描 Benchmarks
102
+ - 扫描 .autospec/benchmarks/*.yaml
103
+ - 加载 benchmark 配置
104
+
105
+ Step 2: 执行 Benchmarks
106
+ - 创建隔离环境
107
+ - 执行每个 benchmark 的测试场景
108
+ - 捕获过程指标和产出物
109
+
110
+ Step 3: 三维度评估
111
+ - 过程指标(30%): Layer1/2 通过率、回退率等
112
+ - 结果指标(40%): 产出物质量、一致性等
113
+ - 路径指标(30%): 流程合规性、执行效率等
114
+
115
+ Step 4: 生成深度报告
116
+ - 评分和等级
117
+ - 主要发现
118
+ - 改进建议
119
+ - 保存到 .autospec/logs/autospec:field-evolve/deep-{date}.md
120
+ ```
121
+
122
+ ### Mode: full(完整循环)
123
+
124
+ **目标**: 完整进化循环(测试 → 评估 → 改进 → 修复 → 蒸馏)
125
+
126
+ ```
127
+ Step 1-4: 同 deep 模式
128
+
129
+ Step 5: 改进方案生成
130
+ - 问题分类(auto-fixable / manual-review)
131
+ - 优先级计算(P0/P1/P2)
132
+ - 影响预测
133
+ - 生成改进方案文档
134
+
135
+ Step 6: 自动修复(如 --auto-fix)
136
+ - 执行 auto-fixable 的改进
137
+ - 验证修复效果
138
+ - 失败则回滚
139
+
140
+ Step 7: 效果验证
141
+ - 重新执行 benchmarks
142
+ - 退化检测
143
+ - 生成验证报告
144
+
145
+ Step 8: 技能蒸馏
146
+ - 同 distill 模式
147
+ ```
148
+
149
+ ### Mode: report(仅报告)
150
+
151
+ **目标**: 分析并生成报告,不执行修复
152
+
153
+ ```
154
+ Step 1-4: 同 deep 模式
155
+ Step 5: 生成详细报告(包含改进建议,但不执行)
156
+ ```
157
+
158
+ ### Mode: distill(技能蒸馏)
159
+
160
+ **目标**: 从 practice-log 提炼技能和方法论
161
+
162
+ 同「标准进化流程」(见下文)。
163
+
164
+ ### Mode: generate(生成 benchmarks)
165
+
166
+ **目标**: 根据项目类型自动生成 benchmarks
167
+
168
+ ```
169
+ Step 1: 检测项目类型
170
+ - package.json → Node.js
171
+ - pom.xml/build.gradle → Java
172
+ - go.mod → Go
173
+ - requirements.txt/pyproject.toml → Python
174
+
175
+ Step 2: 选择模板
176
+ - 从 plugins/benchmarks/templates/ 加载对应模板
177
+
178
+ Step 3: 生成配置
179
+ - 填充项目特定信息
180
+ - 调整构建/测试命令
181
+
182
+ Step 4: 保存
183
+ - 保存到 .autospec/benchmarks/project-generated.yaml
184
+ - 提示用户可自定义修改
185
+ ```
186
+
187
+ ## 标准进化流程(Distill 模式)
188
+
189
+ 可使用 `/autospec:field-evolve --mode=distill` 或 `/evolve` 命令执行。
190
+
191
+ ### Step 1: 信号收集
192
+
193
+ 扫描 `.autospec/evolution/practice-log/` 中状态为 "Pending" 的条目。
194
+ - 如果没有 Pending 条目 → 告知用户暂无可进化内容,结束
195
+ - 如果有 → 列出所有 Pending 条目,继续
196
+
197
+ ### Step 2: 技能蒸馏(必须执行)
198
+
199
+ **读取 `${KNOWLEDGE}/guides/support/skill-distiller.md`,按其中的"执行步骤"逐步执行:**
200
+ 1. 扫描 practice-log 中的操作轨迹和人工介入点
201
+ 2. 识别信号:反复出现的操作模式(3次以上)、频繁人工介入点、重复逻辑
202
+ 3. 如发现可蒸馏的新 skill → 按 `${KNOWLEDGE}/guides/_template.md` 格式生成
203
+ 4. 判断归属:stages/ 还是 domain/
204
+
205
+ ### Step 3: 方法论提取(必须执行)
206
+
207
+ **读取 `${KNOWLEDGE}/guides/support/methodology-extractor.md`,按其中的"执行步骤"逐步执行:**
208
+ 1. 分析本次实践:哪些做法有效、哪些踩坑
209
+ 2. 与已有 `${KNOWLEDGE}/principles/core-principles.md` 和 `${KNOWLEDGE}/checklists/` 对比
210
+ 3. 如果是新发现 → 提取为方法论更新
211
+ 4. 如果与已有原则冲突 → 标记待讨论,**不自动覆盖**
212
+
213
+ ### Step 4: 已有技能升级检查
214
+
215
+ **读取 `${KNOWLEDGE}/guides/support/skill-updater.md`,检查是否有需要升级的 skill:**
216
+ - 同类问题出现 3 次以上 → 必须升级对应 skill
217
+ - 收集该 skill 的所有反馈数据,分析问题模式
218
+ - 生成修改建议
219
+
220
+ ### Step 5: 分区执行(读取 `${KNOWLEDGE}/evolution.md` 确认规则)
221
+
222
+ 对每个发现的进化项,确认所属分区后执行:
223
+
224
+ **自由区**(domain skills, decision-trees):
225
+ 1. 执行变更
226
+ 2. **必须调用 `${KNOWLEDGE}/guides/support/skill-validator.md` 验证** — 读取该文件的"评判标准"和"评审步骤",逐项检查新/修改的 skill
227
+ 3. 验证通过 → 写入对应目录
228
+ 4. 验证不通过 → 修正后重新验证(最多2次)
229
+
230
+ **受控区**(stage skills, checklists, principles):
231
+ 1. 生成变更提案,写入 `.autospec/evolution/proposals/{NNN}-{title}.md`
232
+ 2. 提案格式:当前问题 + 建议修改 + 支撑证据(practice-log引用) + 预期效果
233
+ 3. **主动告知用户**:有新的受控区变更提案需要审批
234
+
235
+ **冻结区**(constitution, evolution rules):
236
+ - **绝不触碰**,仅在报告中标记建议
237
+
238
+ ### Step 6: 三级回流决策(全局/组织能力沉淀)
239
+
240
+ 对每个自由区进化项,决定回流目标:
241
+
242
+ **回流目标**:
243
+ 1. **项目级**(默认):留在当前项目,仅当前项目可用
244
+ 2. **用户全局**(`~/.claude/autospec/skills/`):所有项目可复用
245
+ 3. **组织级**(`~/.claude/autospec/orgs/{org-name}/skills/`):组织内共享
246
+
247
+ **决策规则**:
248
+ - 优先回流到用户全局(除非用户偏好设置禁止)
249
+ - 组织级回流需要明确指定组织名称
250
+ - 读取 `team-preferences` 获取用户进化偏好(自动/手动)
251
+
252
+ **回流操作**:
253
+ - 用户全局回流:调用 `autospec global publish <skill-name>`
254
+ - 组织级回流:调用 `autospec org publish <org-name> <skill-name>`
255
+ - 自动回流时同时创建 Claude Code 符号链接(`~/.claude/skills/autospec`)
256
+
257
+ **实战项目 → AutoSpec 回流**(field-evolve 特有):
258
+ ```
259
+ 如配置回流到 AutoSpec:
260
+ 1. 将提炼的技能复制到 .autospec/evolution/distilled-skills/
261
+ 2. 生成回流提案(PR 模板)
262
+ 3. 提示用户提交到 AutoSpec 项目
263
+ ```
264
+
265
+ ### Step 7: 效果验证
266
+
267
+ - 如有基准案例(`${KNOWLEDGE}/evaluation/benchmarks/`),对比变更前后
268
+ - 退化 → 自动回滚并记录
269
+
270
+ ### Step 8: 记录审计
271
+
272
+ - 所有变更记录到 `.autospec/evolution/evolution-log.json`
273
+ - 更新 practice-log 对应条目状态为 "已处理"
274
+
275
+ ## 自动触发时机
276
+
277
+ 本 skill 会在以下时机被自动感知触发:
278
+ - 全流程完成后(交付阶段结束时自动触发进化信号扫描)
279
+ - practice-log 积累到 5 条以上
280
+ - 同类问题出现第 3 次
281
+ - 用户明确要求复盘或提炼经验
282
+ - 收到人工反馈或纠正时
283
+ - 执行 `/autospec:field-evolve` 命令时
284
+
285
+ ## 安全底线
286
+
287
+ - 绝不修改 `constitution.md`、`evolution.md`、核心设计原则
288
+ - 绝不降低审查标准
289
+ - 每条变更必须引用至少1条 practice-log
290
+ - 同一组件每轮最多进化一次
291
+ - field-evolve 的自动修复不修改冻结区文件
@@ -0,0 +1,133 @@
1
+ ---
2
+ name: exploration-phase
3
+ description: "探索阶段模块 - 团队对齐与需求澄清。可被 run/autospec:explore 命令复用。支持动态轮次和友好对话。"
4
+ parameters:
5
+ maxRounds: 6
6
+ earlyExit: true
7
+ taskDescription: ""
8
+ ---
9
+
10
+ # Exploration Phase - 探索阶段
11
+
12
+ 你正在执行探索阶段,负责与创业团队对齐并完成需求澄清。
13
+
14
+ ## 前置参数
15
+
16
+ - **maxRounds**: 最大探索轮次(默认6,由复杂度决定)
17
+ - **earlyExit**: 是否允许用户提前终止(默认true)
18
+ - **taskDescription**: 任务描述(可选,用于上下文)
19
+
20
+ ## 执行流程
21
+
22
+ ### Step 1: 复杂度评估
23
+
24
+ **【强制】** 读取 `${KNOWLEDGE}/guides/support/complexity-assessor.md`,执行复杂度评估:
25
+
26
+ - 简单任务(score <= 5):2-3轮
27
+ - 中等任务(score 6-8):3-4轮
28
+ - 复杂任务(score >= 9):5-6轮
29
+
30
+ ### Step 2: 检查已有澄清记录
31
+
32
+ 读取 `.autospec/specs/{feature}/clarifications.md`:
33
+
34
+ - **【重要】** 即使有详细的需求文档,也不代表澄清完成!
35
+ - 需求文档是重要输入材料,澄清时要基于文档内容深入探讨,不能忽略文档中的信息
36
+ - 必须通过多Agent对抗分析和多轮澄清来验证和补充需求文档
37
+ - 只有当 clarifications.md 中有完整的「对抗分析结果」+「多轮问答记录」时,才算完成
38
+ - 如不存在或不完整 → **必须**继续执行 Step 3 和 Step 4
39
+
40
+ ### Step 3: 多Agent对抗分析
41
+
42
+ **【强制】【不可跳过】** 必须启动 2-3 个独立 Agent 并行分析,即使需求文档很详细:
43
+
44
+ 1. **Agent A - 乐观视角**:支持这个需求的理由、预期价值
45
+ 2. **Agent B - 质疑视角**:潜在问题、风险、伪需求可能性
46
+ 3. **Agent C(可选)- 技术视角**:技术可行性、实现难点
47
+
48
+ **【强制】** 使用 Agent 工具启动独立 Agent,不要自己模拟分析。
49
+
50
+ 汇总对抗结果,形成「待确认问题清单」,记录到 clarifications.md
51
+
52
+ ### Step 4: 多轮澄清(动态轮次)
53
+
54
+ **【强制交互】【不可跳过】** 必须使用 AskUserQuestion 工具与用户进行交互澄清。
55
+
56
+ **【重要】** 即使需求文档很详细,也必须执行至少一轮澄清!
57
+
58
+ 根据 Step 1 确定的轮次上限,执行以下循环:
59
+
60
+ ```
61
+ 循环直到用户确认「足够」或达到 maxRounds:
62
+
63
+ 1. 基于对抗分析结果,从待确认问题清单中选择问题(每轮最多5个)
64
+
65
+ 2. 【强制】使用 AskUserQuestion 工具提问:
66
+ - 每个问题必须有明确的 header(分类)和 question
67
+ - 每个问题必须提供 options(推荐答案选项)
68
+ - 每个问题可以附 preview(预览内容)
69
+
70
+ 3. 等待用户回复,记录回答到 clarifications.md
71
+
72
+ 4. 【友好询问】使用 AskUserQuestion 询问:
73
+ 「这个问题已经清楚了。是否进入下一轮深入探讨?
74
+ 或者我们已经有足够信息开始分析了?」
75
+ 选项:继续深入 / 已经足够
76
+
77
+ 5. 用户响应处理:
78
+ - 用户选择「已经足够」或说「足够」「清楚了」「可以了」→ 提前终止,返回完成
79
+ - 用户选择「继续深入」或说「继续」「下一轮」→ 继续下一轮
80
+ ```
81
+
82
+ **【禁止跳过】** 以下情况必须暂停并向用户确认:
83
+ - 需求有歧义
84
+ - 技术方案有多种选择
85
+ - 涉及安全/性能/成本等关键决策
86
+ - **即使需求文档很详细,也必须执行至少一轮澄清**
87
+ - 用户明确说「足够」前不得跳过澄清环节
88
+
89
+ **典型轮次主题**(根据任务调整):
90
+
91
+ - 第1轮:背景确认(解决什么问题)
92
+ - 第2轮:价值确认(为什么重要)
93
+ - 第3轮:边界确认(什么不做)
94
+ - 第4轮:技术约束(如需要)
95
+ - 第5轮:风险识别(如需要)
96
+ - 第6轮:验收标准(如需要)
97
+
98
+ ### Step 5: 需求分析
99
+
100
+ **【强制】** 读取 `${KNOWLEDGE}/guides/stages/requirement-analyzer.md`,生成结构化需求文档:
101
+
102
+ 1. 将3轮澄清结果融入需求文档
103
+ 2. 每个决策标注来源:用户确认/自动决策/待审阅
104
+ 3. 写入 `.autospec/specs/{feature}/requirement.md`
105
+
106
+ ### Step 6: Layer 1 验证
107
+
108
+ - Schema校验:需求文档包含所有必须字段
109
+ - 格式检查:每条需求有优先级和验收标准
110
+ - 验证失败 → 修复后重试
111
+
112
+ ### Step 7: Layer 2 审查
113
+
114
+ **【强制】** 调用 Agent 工具,使用 independent-reviewer:
115
+
116
+ ```
117
+ prompt: 请审查以下需求文档。
118
+ 1. 先读取审查标准: ${KNOWLEDGE}/guides/stages/requirement-reviewer.md
119
+ 2. 被审查文档: .autospec/specs/{feature}/requirement.md
120
+ 注意:你是独立审查者,只看产出物和标准
121
+ ```
122
+
123
+ 审查通过 → 探索阶段完成
124
+
125
+ ## 输出
126
+
127
+ - `.autospec/specs/{feature}/clarifications.md` - 完整澄清记录
128
+ - `.autospec/specs/{feature}/requirement.md` - 结构化需求文档
129
+ - 状态:COMPLETED / IN_PROGRESS / EARLY_EXIT
130
+
131
+ ## 完成
132
+
133
+ 探索阶段完成 → 返回调用者,继续后续流程