@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,227 @@
1
+ # Design: {需求名}/{系统名}
2
+
3
+ > **版本**: v1.0
4
+ > **模板来源**: 业界系统设计最佳实践 / 结构化设计方法
5
+ > **适用范围**: 所有系统设计文档
6
+ > **生成模式**: 两步生成(Phase 1 大纲 → Phase 2 详设)
7
+
8
+ ---
9
+
10
+ ## 1. 项目背景
11
+
12
+ **目标**: {一句话描述}
13
+
14
+ **参与人**: PM: xx, 开发:xx, 测试:xx
15
+
16
+ **相关文档**: [proposal.md](../proposal.md)
17
+
18
+ ---
19
+
20
+ ## 2. 业务用例
21
+
22
+ {从 proposal.md 中提取本系统相关的用例,使用 Mermaid flowchart}
23
+
24
+ ```mermaid
25
+ flowchart TB
26
+ subgraph 本系统
27
+ A[功能 A] --> B[功能 B]
28
+ end
29
+ ```
30
+
31
+ ---
32
+
33
+ ## 3. 功能设计
34
+
35
+ ### 3.1 功能点列表
36
+
37
+ > **Phase 1 输出**: 仅列表,全部标记为 `- [ ]` 未完成
38
+ > **Phase 2 完成后**: 所有功能点标记为 `- [x]` 完成
39
+
40
+ - [ ] **FP-01**: {功能点 1 名称} - {简要描述}
41
+ - [ ] **FP-02**: {功能点 2 名称} - {简要描述}
42
+ - [ ] **FP-03**: {功能点 3 名称} - {简要描述}
43
+
44
+ ### 3.2 详细设计
45
+
46
+ > **Phase 1**: 仅占位符 `> ⏳ 待细化`
47
+ > **Phase 2**: 逐个功能点细化,每完成一个立即更新 3.1 打钩
48
+
49
+ #### 3.2.1 FP-01: {功能点 1 名称}
50
+
51
+ > ⏳ 待细化
52
+
53
+ #### 3.2.2 FP-02: {功能点 2 名称}
54
+
55
+ > ⏳ 待细化
56
+
57
+ #### 3.2.3 FP-03: {功能点 3 名称}
58
+
59
+ > ⏳ 待细化
60
+
61
+ ---
62
+
63
+ ## 4. 领域模型 (可选)
64
+
65
+ > ⏳ 待补充
66
+
67
+ ### 4.1 模型设计
68
+
69
+ {领域模型类图}
70
+
71
+ ```mermaid
72
+ classDiagram
73
+ class AggregateRoot {
74
+ +id: String
75
+ +behavior()
76
+ }
77
+ class Entity {
78
+ +id: String
79
+ }
80
+ class ValueObject {
81
+ +value: Type
82
+ }
83
+ AggregateRoot *-- Entity
84
+ AggregateRoot *-- ValueObject
85
+ ```
86
+
87
+ ### 4.2 聚合设计(DDD增强,可选)
88
+
89
+ > 适用于复杂业务系统,定义一致性边界
90
+
91
+ | 聚合名称 | 聚合根 | 包含实体 | 包含值对象 | 一致性规则 |
92
+ |---------|--------|---------|-----------|-----------|
93
+ | | | | | |
94
+
95
+ **聚合设计原则**:
96
+ - 小聚合优于大聚合
97
+ - 通过ID引用其他聚合
98
+ - 聚合边界 = 一致性边界 = 事务边界
99
+
100
+ ### 4.3 领域事件(DDD增强,可选)
101
+
102
+ > 适用于事件驱动架构,聚合间通信
103
+
104
+ | 事件名称 | 触发条件 | 携带数据 | 订阅方 |
105
+ |---------|---------|---------|--------|
106
+ | | | | |
107
+
108
+ **事件命名规范**:过去时(OrderCreated, PaymentCompleted)
109
+
110
+ ### 4.4 状态机
111
+
112
+ {状态流转图}
113
+
114
+ ```mermaid
115
+ stateDiagram-v2
116
+ [*] --> 初始状态
117
+ 初始状态 --> 状态A: 事件1
118
+ 状态A --> 状态B: 事件2
119
+ 状态B --> [*]: 事件3
120
+ ```
121
+
122
+ ### 4.5 数据库设计
123
+
124
+ {ER 图或表结构}
125
+
126
+ ---
127
+
128
+ ## 5. 发布依赖 (涉及共享组件/依赖库变更时必须)
129
+
130
+ > ⏳ 待补充
131
+
132
+ | 组件/依赖库 (groupId:artifactId) | 当前版本 | 升级版本 | 变更内容 | 需升级的系统 |
133
+ |--------------------------------|---------|---------|---------|-------------|
134
+ | {groupId:artifactId} | {当前版本} | {新版本} | {变更说明} | {系统列表} |
135
+
136
+ ---
137
+
138
+ ## 6. 风险分析 (可选)
139
+
140
+ > ⏳ 待补充
141
+
142
+ | 风险项 | 影响 | 缓解措施 |
143
+ |-------|------|---------|
144
+ | {风险 1} | {影响} | {措施} |
145
+
146
+ ---
147
+
148
+ # 详细设计模板(单个功能点)
149
+
150
+ > 将以下内容填充到每个功能点的详细设计中
151
+
152
+ ## {功能点名称}
153
+
154
+ ### 概述
155
+
156
+ {功能点的业务目标和实现思路}
157
+
158
+ ### 流程图 (可选)
159
+
160
+ ```mermaid
161
+ sequenceDiagram
162
+ participant U as 用户/上游
163
+ participant S as 本系统
164
+ participant D as 下游系统
165
+
166
+ U->>S: 1. 请求描述
167
+ S->>D: 2. 调用下游
168
+ D-->>S: 3. 返回结果
169
+ S-->>U: 4. 响应
170
+ ```
171
+
172
+ ### 下游交互 (可选)
173
+
174
+ {描述与下游系统的交互细节}
175
+
176
+ ### 对外接口 (可选)
177
+
178
+ {描述对外提供的接口定义}
179
+
180
+ ### 异常处理 (可选)
181
+
182
+ {描述异常处理逻辑}
183
+
184
+ ### 业务规则 (可选)
185
+
186
+ {描述涉及的业务规则}
187
+
188
+ ---
189
+
190
+ ## 模板使用说明
191
+
192
+ ### 两步生成流程
193
+
194
+ **Phase 1: 大纲生成**
195
+ 1. 填写第 1-2 章(项目背景、业务用例)
196
+ 2. 生成 3.1 功能点列表(全部标记 `- [ ]`)
197
+ 3. 3.2 详细设计仅占位符
198
+
199
+ **Phase 2: 逐个细化**
200
+ 1. 对每个功能点编写详细设计
201
+ 2. 每完成一个功能点,立即在 3.1 打钩 `- [x]`
202
+ 3. 补充第 4-6 章(如需要)
203
+
204
+ ### 必填章节
205
+
206
+ 以下章节为必填,缺少则设计文档不完整:
207
+
208
+ - [ ] 1. 项目背景
209
+ - [ ] 2. 业务用例
210
+ - [ ] 3.1 功能点列表
211
+ - [ ] 3.2 所有功能点的详细设计
212
+
213
+ ### 可选章节
214
+
215
+ 以下章节根据需求复杂度选择性填写:
216
+
217
+ - 4. 领域模型(涉及复杂领域模型时需要)
218
+ - 5. 发布依赖(涉及共享组件/依赖库变更时必须)
219
+ - 6. 风险分析(高风险操作需要)
220
+
221
+ ### 最佳实践
222
+
223
+ 1. **功能点原子化**: 每个功能点应该是原子的,职责单一
224
+ 2. **流程图优先**: 能用图表达的不用文字
225
+ 3. **进度可视化**: Phase 2 时每完成一个功能点立即打钩
226
+ 4. **领域模型**: 核心业务逻辑应该内聚到领域对象中
227
+ 5. **风险分析**: 提前识别风险并制定缓解措施
@@ -0,0 +1,107 @@
1
+ # Tasks: {需求名}/{系统名}
2
+
3
+ > **版本**: v1.0
4
+ > **模板来源**: 业界任务管理最佳实践 / 结构化任务分解方法
5
+ > **适用范围**: 所有任务分解文档
6
+ > **上游文档**: [design.md](./design.md)
7
+
8
+ ---
9
+
10
+ ## Meta
11
+
12
+ - **design**: {design.md 路径}
13
+ - **system**: @wiki/system/apps/{系统名}/
14
+
15
+ ---
16
+
17
+ ## Tasks
18
+
19
+ ### T1: {任务名}
20
+
21
+ **Goal**: {一句话说明任务目标}
22
+
23
+ **Depends**: 无 | T{n}
24
+
25
+ **Files**:
26
+ - CREATE: {新建文件路径}
27
+ - MODIFY: {修改文件路径}
28
+ - DELETE: {删除文件路径}(如需要)
29
+
30
+ **Done when**: {验收标准,一句话}
31
+
32
+ ---
33
+
34
+ ### T2: {任务名}
35
+
36
+ **Goal**: {一句话说明任务目标}
37
+
38
+ **Depends**: T1
39
+
40
+ **Files**:
41
+ - CREATE: {新建文件路径}
42
+ - MODIFY: {修改文件路径}
43
+
44
+ **Done when**: {验收标准,一句话}
45
+
46
+ ---
47
+
48
+ ### T3: {任务名}
49
+
50
+ {同上}
51
+
52
+ ---
53
+
54
+ ## Progress
55
+
56
+ - [ ] T1: {任务名}
57
+ - [ ] T2: {任务名}
58
+ - [ ] T3: {任务名}
59
+
60
+ ---
61
+
62
+ ## Validation
63
+
64
+ - [ ] `mvn test -pl {module}`
65
+ - [ ] `mvn checkstyle:check`
66
+
67
+ ---
68
+
69
+ ## 模板使用说明
70
+
71
+ ### 任务拆解原则(ATOMIC)
72
+
73
+ 每个任务必须满足以下原则:
74
+
75
+ | 原则 | 说明 | 检查项 |
76
+ |------|------|--------|
77
+ | **A**utonomous | 可独立执行 | 不依赖其他任务的中间状态 |
78
+ | **T**estable | 有明确的验证标准 | 不是"看起来对" |
79
+ | **O**bservable | 执行结果可观测 | 有输出、有日志 |
80
+ | **M**odest | 2-4 小时工作量 | 当前 AI sweet spot |
81
+ | **I**nformed | 包含完整上下文 | 不假设执行者知道任何背景 |
82
+ | **C**onstrained | 明确边界 | 做什么、不做什么、不能碰什么 |
83
+
84
+ ### 依赖类型
85
+
86
+ | 类型 | 说明 | 示例 |
87
+ |------|------|------|
88
+ | `→data` | 数据依赖 | 上游产出作为下游输入 |
89
+ | `→logic` | 逻辑依赖 | 业务流程顺序约束 |
90
+ | `→res` | 资源依赖 | 共享资源需串行访问 |
91
+ | `→contract` | 契约解耦 | 通过定义标准产出物解耦 |
92
+ | `→mock` | Mock 并行 | 下游基于 Mock 开发 |
93
+
94
+ ### 任务规模
95
+
96
+ | 规模 | 工时 | 适用场景 |
97
+ |------|------|---------|
98
+ | Task | 2-4 小时 | 基本任务单元 |
99
+ | Phase | 4-16 小时 | 子系统/大功能 |
100
+
101
+ ### 最佳实践
102
+
103
+ 1. **从 design.md 提取**: 每个功能点拆解为 1-N 个任务
104
+ 2. **明确验收标准**: Done when 必须清晰可判断
105
+ 3. **文件级精确**: CREATE/MODIFY 精确到文件路径
106
+ 4. **依赖可视化**: Progress 列表清晰展示完成度
107
+ 5. **可并行任务**: 无依赖的任务可并行执行
@@ -0,0 +1,170 @@
1
+ # Testcase: {需求名}/{系统名}
2
+
3
+ > **版本**: v1.0
4
+ > **模板来源**: 业界测试用例设计最佳实践 / 结构化测试方法
5
+ > **适用范围**: 所有测试用例文档
6
+ > **来源模式**: A/B/C/D 四种来源
7
+
8
+ ---
9
+
10
+ ## 1. 测试概要
11
+
12
+ - **需求**: {需求名称}
13
+ - **系统**: {系统名}
14
+ - **来源**: design.md | design.md + code-diff
15
+ - **相关文档**:
16
+ - [design.md]({相对路径})
17
+ - [proposal.md]({相对路径})
18
+ - **代码变更**: {M}个文件(来源 D 时)
19
+ - **用例统计**: 共 {N} 个 (P0: {X}, P1: {Y}, P2: {Z})
20
+
21
+ ---
22
+
23
+ ## 2. 交叉验证结果(仅交叉验证时输出)
24
+
25
+ ### 2.1 需求覆盖度
26
+
27
+ | proposal 需求点 | design.md 功能点 | 状态 | 备注 |
28
+ |----------------|-----------------|------|------|
29
+ | {需求 1} | FP-01 | 已覆盖 | |
30
+ | {需求 2} | FP-02 | 已覆盖 | |
31
+
32
+ ### 2.2 疑点清单
33
+
34
+ | 编号 | 类型 | 描述 | 严重程度 | 对应测试用例 |
35
+ |------|------|------|---------|-------------|
36
+ | Q-01 | 需求遗漏 | {描述} | 高/中/低 | TC-CV-001 |
37
+
38
+ ---
39
+
40
+ ## 3. 测试用例
41
+
42
+ ### 正向场景 (P0)
43
+
44
+ | 用例编号 | 场景 | 优先级 | 前置条件 | 测试步骤 | 预期结果 |
45
+ |----------|------|--------|----------|----------|----------|
46
+ | TC-P-001 | {场景} | P0 | {前置条件} | 1. {步骤 1}<br>2. {步骤 2} | {预期} |
47
+ | TC-P-002 | {场景} | P0 | {前置条件} | 1. {步骤} | {预期} |
48
+
49
+ ### 异常场景 (P0)
50
+
51
+ | 用例编号 | 场景 | 优先级 | 前置条件 | 测试步骤 | 预期结果 |
52
+ |----------|------|--------|----------|----------|----------|
53
+ | TC-E-001 | {异常场景} | P0 | {前置条件} | 1. {步骤} | {错误处理} |
54
+ | TC-E-002 | {异常场景} | P0 | {前置条件} | 1. {步骤} | {错误处理} |
55
+
56
+ ### 边界场景 (P1)
57
+
58
+ | 用例编号 | 场景 | 优先级 | 前置条件 | 测试步骤 | 预期结果 |
59
+ |----------|------|--------|----------|----------|----------|
60
+ | TC-B-001 | {边界场景} | P1 | {前置条件} | 1. {步骤} | {预期} |
61
+ | TC-B-002 | {边界场景} | P1 | {前置条件} | 1. {步骤} | {预期} |
62
+
63
+ ### 幂等场景 (P1)
64
+
65
+ | 用例编号 | 场景 | 优先级 | 前置条件 | 测试步骤 | 预期结果 |
66
+ |----------|------|--------|----------|----------|----------|
67
+ | TC-I-001 | {幂等场景} | P1 | {前置条件} | 1. 首次调用<br>2. 重复调用 | {幂等结果} |
68
+ | TC-I-002 | {幂等场景} | P1 | {前置条件} | 1. 首次调用<br>2. 重复调用 | {幂等结果} |
69
+
70
+ ### 业务规则补充 (P1)
71
+
72
+ | 用例编号 | 场景 | 优先级 | 前置条件 | 测试步骤 | 预期结果 |
73
+ |----------|------|--------|----------|----------|----------|
74
+ | TC-BR-001 | {业务规则} | P1 | {前置条件} | 1. {步骤} | {预期} |
75
+
76
+ ### 回归场景 (P1)
77
+
78
+ | 用例编号 | 场景 | 优先级 | 前置条件 | 测试步骤 | 预期结果 |
79
+ |----------|------|--------|----------|----------|----------|
80
+ | TC-R-001 | {原有功能不受影响} | P1 | {前置条件} | 1. {步骤} | {预期不变} |
81
+
82
+ ### 交叉验证用例(仅交叉验证时输出)
83
+
84
+ | 用例编号 | 场景 | 优先级 | 前置条件 | 测试步骤 | 预期结果 | 关联疑点 |
85
+ |----------|------|--------|----------|----------|----------|----------|
86
+ | TC-CV-001 | {疑点验证} | P0 | {前置条件} | 1. {步骤} | {预期} | Q-01 |
87
+
88
+ ### 代码风险验证(来源 D 时输出)
89
+
90
+ | 用例编号 | 场景 | 优先级 | 前置条件 | 测试步骤 | 预期结果 | 风险类型 |
91
+ |----------|------|--------|----------|----------|----------|----------|
92
+ | TC-CR-001 | {风险验证} | P0 | {前置条件} | 1. {步骤} | {预期} | {异常处理/并发/资金安全} |
93
+
94
+ ---
95
+
96
+ ## 4. 覆盖矩阵
97
+
98
+ | 维度 | 覆盖项 |
99
+ |------|--------|
100
+ | 接口 | {接口列表} |
101
+ | 场景 | {场景列表} |
102
+ | 业务规则 | {规则列表} |
103
+ | 代码变更 | {变更文件覆盖率}(来源 D 时) |
104
+
105
+ ---
106
+
107
+ ## 5. 覆盖统计
108
+
109
+ | 类型 | 数量 | P0 | P1 | P2 |
110
+ |------|------|----|----|-----|
111
+ | 正向 | X | X | X | X |
112
+ | 异常 | X | X | X | X |
113
+ | 边界 | X | X | X | X |
114
+ | 幂等 | X | X | X | X |
115
+ | 业务规则 | X | X | X | X |
116
+ | 回归 | X | X | X | X |
117
+ | 交叉验证 | X | X | X | X |
118
+ | 代码风险 | X | X | X | X |
119
+ | **合计** | **X** | **X** | **X** | **X** |
120
+
121
+ ---
122
+
123
+ ## 用例编号规则
124
+
125
+ | 场景类型 | 编号前缀 | 示例 |
126
+ |----------|----------|------|
127
+ | 正向场景 | TC-P-XXX | TC-P-001, TC-P-002 |
128
+ | 异常场景 | TC-E-XXX | TC-E-001, TC-E-002 |
129
+ | 边界场景 | TC-B-XXX | TC-B-001, TC-B-002 |
130
+ | 幂等场景 | TC-I-XXX | TC-I-001, TC-I-002 |
131
+ | 业务规则 | TC-BR-XXX | TC-BR-001, TC-BR-002 |
132
+ | 回归场景 | TC-R-XXX | TC-R-001, TC-R-002 |
133
+ | 交叉验证 | TC-CV-XXX | TC-CV-001, TC-CV-002 |
134
+ | 代码风险 | TC-CR-XXX | TC-CR-001, TC-CR-002 |
135
+
136
+ ---
137
+
138
+ ## 模板使用说明
139
+
140
+ ### 四种来源模式
141
+
142
+ | 来源 | 说明 | 适用场景 |
143
+ |------|------|---------|
144
+ | **A** | 基于 design.md | 从设计文档生成测试用例 |
145
+ | **B** | 基于 code-diff-specified | 从指定代码变更生成 |
146
+ | **C** | 基于 code-diff-full | 从完整代码变更生成 |
147
+ | **D** | design.md + code-diff | 设计 + 代码交叉验证 |
148
+
149
+ ### 必填章节
150
+
151
+ 以下章节为必填,缺少则测试用例文档不完整:
152
+
153
+ - [ ] 1. 测试概要
154
+ - [ ] 3. 测试用例(至少包含正向和异常场景)
155
+ - [ ] 5. 覆盖统计
156
+
157
+ ### 可选章节
158
+
159
+ 以下章节根据来源模式选择性填写:
160
+
161
+ - 2. 交叉验证结果(仅来源 D 时输出)
162
+ - 代码风险验证(来源 D 时输出)
163
+
164
+ ### 最佳实践
165
+
166
+ 1. **P0 优先级**: 核心业务流程必须覆盖
167
+ 2. **异常场景**: 每个接口至少一个异常用例
168
+ 3. **幂等性**: 写操作必须验证幂等
169
+ 4. **回归验证**: 确保变更不影响原有功能
170
+ 5. **代码风险**: 关注异常处理、并发、资金安全
package/package.json ADDED
@@ -0,0 +1,53 @@
1
+ {
2
+ "name": "@chongyan/autospec",
3
+ "version": "1.0.1",
4
+ "description": "AI驱动的无人值守自动化产品研发流程 —— 从需求到交付的全流程自动化",
5
+ "type": "module",
6
+ "bin": {
7
+ "autospec": "bin/autospec.js"
8
+ },
9
+ "files": [
10
+ "bin/",
11
+ "scripts/",
12
+ "knowledge/",
13
+ "plugins/"
14
+ ],
15
+ "scripts": {
16
+ "postinstall": "node scripts/postinstall.js",
17
+ "test": "vitest",
18
+ "test:run": "vitest run",
19
+ "test:coverage": "vitest run --coverage"
20
+ },
21
+ "engines": {
22
+ "node": ">=18.0.0"
23
+ },
24
+ "dependencies": {
25
+ "commander": "^13.1.0",
26
+ "chalk": "^5.4.1",
27
+ "fs-extra": "^11.3.0",
28
+ "js-yaml": "^4.1.0"
29
+ },
30
+ "devDependencies": {
31
+ "vitest": "^2.0.0"
32
+ },
33
+ "keywords": [
34
+ "ai",
35
+ "automation",
36
+ "sdlc",
37
+ "claude-code",
38
+ "pipeline",
39
+ "code-review",
40
+ "requirement-analysis",
41
+ "autonomous-development"
42
+ ],
43
+ "author": "AutoSpec Team",
44
+ "license": "MIT",
45
+ "homepage": "https://github.com/chenjianzeng0604/autospec#readme",
46
+ "repository": {
47
+ "type": "git",
48
+ "url": "git+https://github.com/chenjianzeng0604/autospec.git"
49
+ },
50
+ "bugs": {
51
+ "url": "https://github.com/chenjianzeng0604/autospec/issues"
52
+ }
53
+ }
@@ -0,0 +1,134 @@
1
+ {
2
+ "name": "autospec",
3
+ "version": "1.0.0",
4
+ "namespace": "autospec",
5
+ "description": "自动化产品研发框架 - AI Native创业团队多代理协作",
6
+
7
+ "commands": [
8
+ { "name": "run", "path": "commands/run.md", "description": "启动完整流程" },
9
+ { "name": "explore", "path": "commands/explore.md", "description": "需求探索" },
10
+ { "name": "propose", "path": "commands/propose.md", "description": "方案设计" },
11
+ { "name": "apply", "path": "commands/apply.md", "description": "编码实施" },
12
+ { "name": "archive", "path": "commands/archive.md", "description": "交付归档" },
13
+ { "name": "status", "path": "commands/status.md", "description": "查看状态" },
14
+ { "name": "review", "path": "commands/review.md", "description": "审查各阶段交付物" },
15
+ { "name": "validate", "path": "commands/validate.md", "description": "Layer 1 验证" },
16
+ { "name": "env", "path": "commands/env.md", "description": "环境管理" },
17
+ { "name": "env-validate", "path": "commands/env-validate.md", "description": "环境校验" },
18
+ { "name": "env-sync", "path": "commands/env-sync.md", "description": "环境同步" },
19
+ { "name": "env-export", "path": "commands/env-export.md", "description": "导出知识库" },
20
+ { "name": "env-update", "path": "commands/env-update.md", "description": "环境知识更新" },
21
+ { "name": "project-evolve", "path": "commands/project-evolve.md", "description": "项目自我进化" },
22
+ { "name": "field-evolve", "path": "commands/field-evolve.md", "description": "领域进化" },
23
+ { "name": "memory", "path": "commands/memory.md", "description": "记忆管理" },
24
+ { "name": "env-template", "path": "commands/env-template.md", "description": "环境模板" }
25
+ ],
26
+
27
+ "agents": [
28
+ { "name": "ceo", "path": "agents/roles/ceo.md", "description": "CEO视角需求探索" },
29
+ { "name": "product-owner", "path": "agents/roles/product-owner.md", "description": "产品负责人" },
30
+ { "name": "tech-lead", "path": "agents/roles/tech-lead.md", "description": "技术负责人" },
31
+ { "name": "backend-engineer", "path": "agents/roles/backend-engineer.md", "description": "后端工程师" },
32
+ { "name": "frontend-engineer", "path": "agents/roles/frontend-engineer.md", "description": "前端工程师" },
33
+ { "name": "data-engineer", "path": "agents/roles/data-engineer.md", "description": "数据工程师" },
34
+ { "name": "ai-engineer", "path": "agents/roles/ai-engineer.md", "description": "AI工程师" },
35
+ { "name": "quality-engineer", "path": "agents/roles/quality-engineer.md", "description": "质量工程师" },
36
+ { "name": "security-engineer", "path": "agents/roles/security-engineer.md", "description": "安全工程师" },
37
+ { "name": "devops-engineer", "path": "agents/roles/devops-engineer.md", "description": "运维工程师" },
38
+ { "name": "independent-reviewer", "path": "agents/support/independent-reviewer.md", "description": "独立审查员" },
39
+ { "name": "consistency-checker", "path": "agents/support/consistency-checker.md", "description": "一致性检查器" },
40
+ { "name": "stage-gate-evaluator", "path": "agents/support/stage-gate-evaluator.md", "description": "阶段门禁评估" },
41
+ { "name": "safety-auditor", "path": "agents/support/safety-auditor.md", "description": "安全审计" },
42
+ { "name": "failure-diagnostician", "path": "agents/support/failure-diagnostician.md", "description": "故障诊断" }
43
+ ],
44
+
45
+ "skills": [
46
+ { "name": "requirement-stage", "path": "skills/requirement-stage/SKILL.md", "description": "需求阶段流程" },
47
+ { "name": "design-stage", "path": "skills/design-stage/SKILL.md", "description": "设计阶段流程" },
48
+ { "name": "implementation-stage", "path": "skills/implementation-stage/SKILL.md", "description": "实施阶段流程" },
49
+ { "name": "testing-stage", "path": "skills/testing-stage/SKILL.md", "description": "测试阶段流程" },
50
+ { "name": "delivery-stage", "path": "skills/delivery-stage/SKILL.md", "description": "交付阶段流程" },
51
+ { "name": "layer1-validation", "path": "skills/layer1-validation/SKILL.md", "description": "Layer 1 验证" },
52
+ { "name": "startup-guard", "path": "skills/startup-guard/SKILL.md", "description": "启动门禁守护" },
53
+ { "name": "pending-dashboard", "path": "skills/pending-dashboard/SKILL.md", "description": "待处理仪表盘" },
54
+ { "name": "evolution-process", "path": "skills/evolution-process/SKILL.md", "description": "进化流程" },
55
+ { "name": "skill-forge", "path": "skills/skill-forge/SKILL.md", "description": "技能锻造" },
56
+ { "name": "project-evolution", "path": "skills/project-evolution/SKILL.md", "description": "项目进化技能" },
57
+ { "name": "benchmark-generator", "path": "skills/benchmark-generator/SKILL.md", "description": "Benchmark生成器" },
58
+ { "name": "benchmark-executor", "path": "skills/benchmark-executor/SKILL.md", "description": "Benchmark执行器" },
59
+ { "name": "exploration-phase", "path": "skills/exploration-phase/SKILL.md", "description": "探索阶段技能" }
60
+ ],
61
+
62
+ "hooks": [
63
+ { "event": "PreToolUse", "matcher": "Write", "path": "hooks/trace-initialization.js" },
64
+ { "event": "PreToolUse", "matcher": "Write|Edit", "path": "hooks/frozen-zone-guard.js" },
65
+ { "event": "PreToolUse", "matcher": "Write|Edit", "path": "hooks/scope-sentinel.js" },
66
+ { "event": "PreToolUse", "matcher": "Write|Edit", "path": "hooks/constitution-guard.js" },
67
+ { "event": "PreToolUse", "matcher": "Write|Edit|Bash", "path": "hooks/layer1-validator.js" },
68
+ { "event": "PreToolUse", "matcher": "Write|Edit", "path": "hooks/environment-manager.js" },
69
+ { "event": "PreToolUse", "matcher": "", "path": "hooks/ai-project-guard.js" },
70
+ { "event": "PostToolUse", "matcher": "Write", "path": "hooks/artifact-evaluation-hook.js" },
71
+ { "event": "PostToolUse", "matcher": "Write|Edit|Agent", "path": "hooks/execution-tracker.js" },
72
+ { "event": "PostToolUse", "matcher": "Write|Edit|Bash|Agent|AskUserQuestion", "path": "hooks/layer1-validator.js" },
73
+ { "event": "PostToolUse", "matcher": "Bash", "path": "hooks/ai-project-guard.js" },
74
+ { "event": "PostToolUse", "matcher": "", "path": "hooks/pipeline-observer.js" },
75
+ { "event": "Stop", "matcher": "", "path": "hooks/pipeline-observer.js" },
76
+ { "event": "Stop", "matcher": "", "path": "hooks/environment-manager.js" }
77
+ ],
78
+
79
+ "components": {
80
+ "roles": {
81
+ "core": ["ceo", "product-owner", "tech-lead"],
82
+ "engineers": ["backend-engineer", "frontend-engineer", "ai-engineer", "data-engineer"],
83
+ "quality": ["quality-engineer", "security-engineer", "devops-engineer"],
84
+ "support": ["independent-reviewer", "consistency-checker", "stage-gate-evaluator"]
85
+ },
86
+ "roleGroups": {
87
+ "seed-team": ["ceo", "product-owner", "tech-lead"],
88
+ "growth-team": ["ceo", "product-owner", "tech-lead", "backend-engineer", "frontend-engineer", "ai-engineer"],
89
+ "mature-team": ["ceo", "product-owner", "tech-lead", "backend-engineer", "frontend-engineer", "ai-engineer", "data-engineer", "quality-engineer"]
90
+ },
91
+ "dependencies": {
92
+ "ai-engineer": {
93
+ "requires": ["tech-lead"],
94
+ "note": "AI工程师需要技术负责人确认架构方案"
95
+ },
96
+ "data-engineer": {
97
+ "requires": [],
98
+ "note": "数据工程师可独立工作"
99
+ },
100
+ "security-engineer": {
101
+ "requires": ["tech-lead"],
102
+ "note": "安全工程师需要技术负责人配合"
103
+ }
104
+ }
105
+ },
106
+
107
+ "aiNativeCulture": {
108
+ "principles": [
109
+ "AI思维贯穿:每个角色都具备AI思维特质",
110
+ "数据驱动:决策有数据支撑,效果有评测验证",
111
+ "快速验证:AI功能先验证可行性再大规模开发",
112
+ "人机协作:明确AI与人各自擅长的领域"
113
+ ],
114
+ "roleTraits": {
115
+ "ceo": "战略决策考虑AI能力边界",
116
+ "product-owner": "AI产品思维:理解AI能力边界",
117
+ "tech-lead": "AI架构思维:评估AI方案可行性",
118
+ "backend-engineer": "AI集成思维:API设计考虑AI调用",
119
+ "frontend-engineer": "AI交互思维:AI结果展示优化",
120
+ "ai-engineer": "核心能力:模型选型、Prompt工程、效果优化",
121
+ "data-engineer": "数据驱动基石:数据质量、管道、特征工程",
122
+ "quality-engineer": "AI评测思维:效果评测、Badcase分析",
123
+ "security-engineer": "AI安全思维:Prompt注入防护、数据隐私"
124
+ }
125
+ },
126
+
127
+ "extensions": {
128
+ "teamStagePath": "knowledge/config/team-stage.yaml",
129
+ "roleCompositionPath": "knowledge/config/role-composition.yaml",
130
+ "roleExtensionsPath": "knowledge/config/role-extensions.yaml",
131
+ "skillCompositionsPath": "knowledge/config/skill-compositions.yaml",
132
+ "teamTasksPath": "knowledge/config/team-tasks.yaml"
133
+ }
134
+ }