sdd-full 4.2.0 → 4.3.0

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 (127) hide show
  1. package/bin.js +31 -63
  2. package/package.json +1 -1
  3. package/skills/README.md +97 -0
  4. package/skills/call-adaptation/SKILL.md +23 -0
  5. package/skills/call-adaptation/call-adaptation-guide.md +136 -0
  6. package/skills/call-adaptation/claude-code-call-spec.md +50 -0
  7. package/skills/call-adaptation/trae-call-spec.md +56 -0
  8. package/skills/checklist.md +154 -0
  9. package/skills/design-planning/ai-coding-rules/SKILL.md +52 -0
  10. package/skills/design-planning/design-to-code/SKILL.md +53 -0
  11. package/skills/design-planning/enterprise-spec/SKILL.md +52 -3
  12. package/skills/design-planning/flutter-av/SKILL.md +44 -34
  13. package/skills/design-planning/flutter-map/SKILL.md +41 -31
  14. package/skills/design-planning/function-sdd/SKILL.md +54 -0
  15. package/skills/design-planning/sdd-code/SKILL.md +347 -0
  16. package/skills/design-planning/sdd-deploy/SKILL.md +501 -0
  17. package/skills/design-planning/sdd-ops/SKILL.md +306 -0
  18. package/skills/design-planning/sdd-test/SKILL.md +383 -0
  19. package/skills/design-planning/ui-sdd/SKILL.md +291 -0
  20. package/skills/design-planning/ui-sdd-specialized/SKILL.md +46 -40
  21. package/skills/design-planning/writing-plans/SKILL.md +144 -0
  22. package/skills/development-execution/flutter-errors/SKILL.md +44 -34
  23. package/skills/development-execution/sdd-add/SKILL.md +540 -0
  24. package/skills/development-execution/systematic-debugging/SKILL.md +298 -0
  25. package/skills/development-execution/test-driven-development/SKILL.md +373 -0
  26. package/skills/development-execution/verification-before-completion/SKILL.md +141 -0
  27. package/skills/knowledge-precipitation/claudeception/SKILL.md +96 -0
  28. package/skills/knowledge-precipitation/mempalace-auto-saver/SKILL.md +302 -0
  29. package/skills/quality-assurance/bdd-acceptance/SKILL.md +44 -37
  30. package/skills/quality-assurance/flutter-test/SKILL.md +56 -0
  31. package/skills/quality-assurance/quality-gate/SKILL.md +350 -0
  32. package/skills/quality-assurance/security-audit/SKILL.md +386 -0
  33. package/skills/release-ops/finishing-a-development-branch/SKILL.md +202 -0
  34. package/skills/release-ops/release-flow/SKILL.md +404 -0
  35. package/skills/requirement-analysis/brainstorming/SKILL.md +166 -0
  36. package/skills/requirement-analysis/competitive-brief/SKILL.md +121 -0
  37. package/skills/requirement-analysis/market-research/SKILL.md +143 -0
  38. package/skills/requirement-analysis/prd-write/SKILL.md +111 -0
  39. package/skills/requirement-analysis/requirement-completion-officer/SKILL.md +124 -0
  40. package/skills/requirement-analysis/sdd/SKILL.md +1044 -0
  41. package/skills/requirement-analysis/sdd-full/SKILL.md +717 -36
  42. package/skills/requirement-analysis/unified-flow/SKILL.md +128 -26
  43. package/skills/rules/project_rules.md +167 -0
  44. package/skills/rules/user_rules.md +254 -69
  45. package/skills/special-tools/env-check/SKILL.md +40 -34
  46. package/skills/special-tools/receiving-code-review/SKILL.md +215 -0
  47. package/skills/special-tools/requesting-code-review/SKILL.md +107 -0
  48. package/skills/special-tools/using-superpowers/SKILL.md +117 -0
  49. package/skills/templates/API-SDD.md +31 -0
  50. package/skills/templates/Andrej Karpathy AI/347/274/226/347/240/201/350/247/204/345/210/231/350/220/275/345/234/260SDD.md" +117 -0
  51. package/skills/templates/BDD/351/243/216/346/240/274/351/252/214/346/224/266/346/240/207/345/207/206SDD.md +147 -0
  52. package/skills/templates/Base-SDD.md +38 -0
  53. package/skills/templates/Brain-SDD.md +36 -0
  54. package/skills/templates/Code-SDD.md +41 -0
  55. package/skills/templates/Competitor-SDD.md +34 -0
  56. package/skills/templates/Env-SDD.md +37 -0
  57. package/skills/templates/Flutter/345/205/250/347/261/273/345/236/213/346/265/213/350/257/225/347/255/226/347/225/245SDD.md +162 -0
  58. package/skills/templates/Flutter/345/234/260/345/233/276/345/257/274/350/210/252/344/270/232/345/212/241SDD.md +136 -0
  59. package/skills/templates/Flutter/345/270/270/350/247/201/345/274/202/345/270/270/344/270/223/351/241/271SDD.md +159 -0
  60. package/skills/templates/Flutter/351/237/263/350/247/206/351/242/221/345/205/250/346/240/210SDD.md +121 -0
  61. package/skills/templates/PRD-SDD.md +45 -0
  62. package/skills/templates/SKILL.md +91 -0
  63. package/skills/templates/Test-SDD.md +34 -0
  64. package/skills/templates/UI-SDD.md +38 -0
  65. package/skills/templates/UI-SDD/344/270/223/347/224/250/346/250/241/346/235/277.md +141 -0
  66. package/skills/templates/UI/350/265/204/346/272/220/346/217/220/347/244/272/350/257/215/347/224/237/346/210/220SDD.md +67 -0
  67. package/skills/templates//344/274/201/344/270/232/347/272/247/345/205/250/346/240/210/345/267/245/347/250/213/350/247/204/350/214/203SDD.md +152 -0
  68. package/skills/templates//345/205/250/346/265/201/347/250/213SDD/350/236/215/345/220/210/344/275/223/347/263/273.md +198 -0
  69. package/skills/templates//345/212/237/350/203/275SDD/344/270/223/347/224/250/346/250/241/346/235/277.md +132 -0
  70. package/skills/templates//347/216/257/345/242/203/351/242/204/346/243/200/346/240/207/345/207/206/345/214/226SDD.md +153 -0
  71. package/skills/templates//351/253/230/344/277/235/347/234/237/350/256/276/350/256/241/350/275/254/344/273/243/347/240/201SDD.md +119 -0
  72. package/skills//345/256/214/346/225/264/345/274/200/345/217/221/346/265/201/347/250/213/346/211/213/345/206/214.md +408 -0
  73. package/skills//346/212/200/350/203/275/344/275/223/347/263/273/345/256/214/345/226/204/345/273/272/350/256/256.md +305 -0
  74. package/skills//346/212/200/350/203/275/344/275/277/347/224/250/346/214/207/345/215/227.md +285 -0
  75. package/skills//346/212/200/350/203/275/345/206/263/347/255/226/346/240/221.md +320 -0
  76. package/skills/brainstorming/SKILL.md +0 -164
  77. package/skills/brainstorming/scripts/frame-template.html +0 -214
  78. package/skills/brainstorming/scripts/helper.js +0 -88
  79. package/skills/brainstorming/scripts/server.cjs +0 -338
  80. package/skills/brainstorming/scripts/start-server.sh +0 -153
  81. package/skills/brainstorming/scripts/stop-server.sh +0 -55
  82. package/skills/brainstorming/spec-document-reviewer-prompt.md +0 -48
  83. package/skills/brainstorming/visual-companion.md +0 -286
  84. package/skills/chinese-code-review/SKILL.md +0 -277
  85. package/skills/chinese-commit-conventions/SKILL.md +0 -364
  86. package/skills/chinese-documentation/SKILL.md +0 -448
  87. package/skills/chinese-git-workflow/SKILL.md +0 -510
  88. package/skills/dispatching-parallel-agents/SKILL.md +0 -182
  89. package/skills/executing-plans/SKILL.md +0 -175
  90. package/skills/finishing-a-development-branch/SKILL.md +0 -200
  91. package/skills/mcp-builder/SKILL.md +0 -255
  92. package/skills/receiving-code-review/SKILL.md +0 -213
  93. package/skills/requesting-code-review/SKILL.md +0 -105
  94. package/skills/requesting-code-review/code-reviewer.md +0 -146
  95. package/skills/rules/skill-map.md +0 -97
  96. package/skills/subagent-driven-development/SKILL.md +0 -277
  97. package/skills/subagent-driven-development/code-quality-reviewer-prompt.md +0 -26
  98. package/skills/subagent-driven-development/implementer-prompt.md +0 -113
  99. package/skills/subagent-driven-development/spec-reviewer-prompt.md +0 -61
  100. package/skills/systematic-debugging/CREATION-LOG.md +0 -119
  101. package/skills/systematic-debugging/SKILL.md +0 -296
  102. package/skills/systematic-debugging/condition-based-waiting-example.ts +0 -158
  103. package/skills/systematic-debugging/condition-based-waiting.md +0 -115
  104. package/skills/systematic-debugging/defense-in-depth.md +0 -122
  105. package/skills/systematic-debugging/find-polluter.sh +0 -63
  106. package/skills/systematic-debugging/root-cause-tracing.md +0 -169
  107. package/skills/systematic-debugging/test-academic.md +0 -14
  108. package/skills/systematic-debugging/test-pressure-1.md +0 -58
  109. package/skills/systematic-debugging/test-pressure-2.md +0 -68
  110. package/skills/systematic-debugging/test-pressure-3.md +0 -69
  111. package/skills/test-driven-development/SKILL.md +0 -371
  112. package/skills/test-driven-development/testing-anti-patterns.md +0 -299
  113. package/skills/using-git-worktrees/SKILL.md +0 -218
  114. package/skills/using-superpowers/SKILL.md +0 -134
  115. package/skills/using-superpowers/references/codex-tools.md +0 -25
  116. package/skills/using-superpowers/references/gemini-tools.md +0 -33
  117. package/skills/verification-before-completion/SKILL.md +0 -139
  118. package/skills/workflow-runner/SKILL.md +0 -172
  119. package/skills/writing-plans/SKILL.md +0 -152
  120. package/skills/writing-plans/plan-document-reviewer-prompt.md +0 -49
  121. package/skills/writing-skills/SKILL.md +0 -654
  122. package/skills/writing-skills/anthropic-best-practices.md +0 -1149
  123. package/skills/writing-skills/examples/CLAUDE_MD_TESTING.md +0 -189
  124. package/skills/writing-skills/graphviz-conventions.dot +0 -172
  125. package/skills/writing-skills/persuasion-principles.md +0 -187
  126. package/skills/writing-skills/render-graphs.js +0 -168
  127. package/skills/writing-skills/testing-skills-with-subagents.md +0 -384
@@ -0,0 +1,320 @@
1
+ 【claude code调用标识:技能决策树】【trae调用标识:技能决策树+技能选择指南】【流程场景:1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代、4.Bug处理、5.代码发布】
2
+
3
+ # 技能决策树(个人开发版)
4
+
5
+ ## 如何使用
6
+
7
+ 从「我现在要做什么?」开始,顺着问题选择,快速找到应该用什么技能。本文档专为个人开发者设计,不包含团队协作相关内容。
8
+
9
+ ---
10
+
11
+ ## 决策树
12
+
13
+ ### 问题1:我现在要做什么?
14
+
15
+ #### 选项A:我有一个新项目,从零开始
16
+
17
+ → 子问题:需要先创意/调研吗?
18
+ → → 是:**brainstorming** / **market-research** / **competitive-brief**
19
+ → → 否:跳过
20
+
21
+ → 然后:**prd-write**(写PRD,可选)→ **sdd**(拆需求)或 **sdd-full**(完整SDD流程)
22
+
23
+ → 然后到「选项E:我要设计/开发了」
24
+
25
+ ---
26
+
27
+ #### 选项B:我要做新功能/大需求
28
+
29
+ → **sdd**(基础SDD拆分)或 **sdd-full**(完整SDD流程)→ 到「选项E:我要设计/开发了」
30
+
31
+ ---
32
+
33
+ #### 选项C:我要做小功能迭代/Bug修复
34
+
35
+ → 子问题:需求是否明确?
36
+ → → 否:**requirement-completion-officer**(需求补全)
37
+ → → 是:跳过
38
+
39
+ → **sdd-add**(快速落地)
40
+ → 如果需要UI:补充调用 **ui-sdd**
41
+ → 如果需要调试:**systematic-debugging**
42
+ → 如果需要制定计划:**writing-plans**
43
+
44
+ ---
45
+
46
+ #### 选项D:我要发布代码
47
+
48
+ → 子问题:质量检查做了吗?
49
+ → → 否:**quality-gate**(先做质量检查)
50
+ → → 是:继续
51
+
52
+ → 子问题:是否完成开发分支?
53
+ → → 是:**finishing-a-development-branch**
54
+ → → 否:跳过
55
+
56
+ → **sdd-deploy**(部署设计,可选)→ **release-flow**(发布管理)
57
+
58
+ ---
59
+
60
+ #### 选项E:我要设计/开发了
61
+
62
+ → 子问题1:需要UI设计吗?
63
+ → → 是:**ui-sdd**
64
+ → → 否:跳过
65
+
66
+ → 子问题2:需要拆实现SDD吗?
67
+ → → 是:**sdd-code**(含代码规范、技术债务、重构计划)
68
+ → → 否:跳过
69
+
70
+ → 子问题3:需要设计测试吗?
71
+ → → 是:**sdd-test**
72
+ → → 否:跳过
73
+
74
+ → 子问题4:需要设计部署吗?
75
+ → → 是:**sdd-deploy**
76
+ → → 否:跳过
77
+
78
+ → 子问题5:需要设计运维吗?
79
+ → → 是:**sdd-ops**
80
+ → → 否:跳过
81
+
82
+ → 然后开始开发(sdd-add/test-driven-development/等)
83
+
84
+ ---
85
+
86
+ #### 选项F:我要调试问题
87
+
88
+ → **systematic-debugging**
89
+
90
+ ---
91
+
92
+ #### 选项G:我要做测试
93
+
94
+ → **sdd-test**(设计测试)→ **test-driven-development**(TDD开发)
95
+
96
+ ---
97
+
98
+ #### 选项H:我要做竞品分析
99
+
100
+ → **competitive-brief** / **market-research**
101
+
102
+ ---
103
+
104
+ #### 选项I:我要安全检查
105
+
106
+ → **security-audit**
107
+
108
+ ---
109
+
110
+ #### 选项J:我要保存/提取经验
111
+
112
+ → **claudeception** / **mempalace-auto-saver**
113
+
114
+ ---
115
+
116
+ #### 选项K:我要完成开发分支
117
+
118
+ → **finishing-a-development-branch**
119
+
120
+ ---
121
+
122
+ #### 选项L:我要做TDD开发
123
+
124
+ → **test-driven-development**
125
+
126
+ ---
127
+
128
+ #### 选项M:我要验证代码(提交/发布前)
129
+
130
+ → **verification-before-completion**
131
+
132
+ ---
133
+
134
+ #### 选项N:我要走完整的自动化流程
135
+
136
+ → **using-superpowers**
137
+
138
+ ---
139
+
140
+ #### 选项O:我要补全需求
141
+
142
+ → **requirement-completion-officer**
143
+
144
+ ---
145
+
146
+ #### 选项P:我要制定计划
147
+
148
+ → **writing-plans**
149
+
150
+ ---
151
+
152
+ #### 选项Q:我要请求/接收代码审查
153
+
154
+ → **requesting-code-review** / **receiving-code-review**
155
+
156
+ ---
157
+
158
+ #### 选项R:我要进行Flutter专项开发
159
+
160
+ → 子问题1:开发什么功能?
161
+ → → 地图导航:**flutter-map**
162
+ → → 音视频功能:**flutter-av**
163
+ → → 异常排查:**flutter-errors**
164
+ → → 测试策略:**flutter-test**
165
+
166
+ → 子问题2:需要设计吗?
167
+ → → 是:**ui-sdd** / **sdd-code**(选择对应模板)
168
+ → → 否:跳过
169
+
170
+ → 子问题3:需要环境检查吗?
171
+ → → 是:**env-check**
172
+ → → 否:跳过
173
+
174
+ ---
175
+
176
+ #### 选项S:我要进行环境预检
177
+
178
+ → **env-check**
179
+
180
+ ---
181
+
182
+ ## 快速参考表(按场景)
183
+
184
+ | 场景 | 推荐技能 |
185
+ |-----|---------|
186
+ | 新项目立项 | brainstorming → prd-write → sdd/sdd-full → ui-sdd → sdd-code → sdd-test → ... |
187
+ | 大功能需求 | sdd/sdd-full → ui-sdd → sdd-code → sdd-test → ... |
188
+ | 小功能迭代 | requirement-completion-officer(可选) → writing-plans(可选) → sdd-add |
189
+ | Bug修复 | systematic-debugging → sdd-add → verification-before-completion |
190
+ | 代码发布 | verification-before-completion → quality-gate → finishing-a-development-branch(可选) → sdd-deploy → release-flow |
191
+ | UI设计 | ui-sdd |
192
+ | 测试设计 | sdd-test → test-driven-development |
193
+ | 安全检查 | security-audit |
194
+ | 代码审查 | requesting-code-review → receiving-code-review |
195
+ | 需求补全 | requirement-completion-officer |
196
+ | 制定计划 | writing-plans |
197
+ | 保存经验 | claudeception / mempalace-auto-saver |
198
+ | 完成分支 | finishing-a-development-branch |
199
+ | 全流程 | using-superpowers |
200
+ | Flutter开发 | flutter-map / flutter-av / flutter-test / flutter-errors |
201
+ | 环境预检 | env-check |
202
+
203
+ ---
204
+
205
+ ## 完整开发流程的技能顺序(大项目)
206
+
207
+ ```
208
+ 1. brainstorming/market-research(可选)
209
+ 2. prd-write(可选)
210
+ 3. sdd/sdd-full(必须)
211
+ 4. ui-sdd(建议)
212
+ 5. sdd-code(必须,含代码规范、技术债务、重构计划)
213
+ 6. sdd-test(建议)
214
+ 7. sdd-deploy(建议)
215
+ 8. sdd-ops(可选)
216
+ 9. writing-plans(建议,制定开发计划)
217
+ 10. 开发 + TDD(可选,test-driven-development)
218
+ 11. verification-before-completion(建议)
219
+ 12. quality-gate(必须,发布前)
220
+ 13. finishing-a-development-branch(可选)
221
+ 14. release-flow(必须,发布)
222
+ 15. claudeception/mempalace-auto-saver(建议,沉淀经验)
223
+ ```
224
+
225
+ ---
226
+
227
+ ## 记住这些关键组合
228
+
229
+ ### 需求组合
230
+ ```
231
+ brainstorming/market-research → prd-write → requirement-completion-officer(可选) → sdd/sdd-full
232
+ ```
233
+
234
+ ### 设计组合
235
+ ```
236
+ sdd/sdd-full → ui-sdd → sdd-code → sdd-test → sdd-deploy → sdd-ops
237
+ ```
238
+
239
+ ### 发布组合
240
+ ```
241
+ verification-before-completion → quality-gate → finishing-a-development-branch → sdd-deploy → release-flow
242
+ ```
243
+
244
+ ### 知识沉淀组合
245
+ ```
246
+ claudeception → mempalace-auto-saver
247
+ ```
248
+
249
+ ---
250
+
251
+ ## 还有疑问?
252
+
253
+ → 看「技能使用指南.md」
254
+ → 看「完整开发流程手册.md」
255
+ → 看「技能体系完善建议.md」
256
+ → 直接问我你的具体场景!
257
+
258
+ ---
259
+
260
+ ---
261
+
262
+ ## SDD融合框架(新增)
263
+
264
+ ### 9份标准化SDD模板
265
+
266
+ | 模板名称 | 核心内容 | 适用技能 |
267
+ |---------|---------|---------|
268
+ | **Base-SDD** | 全局通用基线规范 | sdd, sdd-full |
269
+ | **Brain-SDD** | 头脑风暴文档 | brainstorming |
270
+ | **Competitor-SDD** | 竞品分析文档 | competitive-brief, market-research |
271
+ | **PRD-SDD** | 产品需求文档 | prd-write, requirement-completion-officer |
272
+ | **UI-SDD** | UI设计文档 | ui-sdd |
273
+ | **Code-SDD** | 代码实现文档 | sdd-code, test-driven-development |
274
+ | **API-SDD** | 接口设计文档 | sdd(接口拆分) |
275
+ | **Env-SDD** | 环境配置文档 | sdd-deploy, sdd-ops |
276
+ | **Test-SDD** | 测试设计文档 | sdd-test, test-driven-development |
277
+
278
+ ### 专项SDD模板(新增)
279
+
280
+ | 模板名称 | 核心内容 | 适用场景 |
281
+ |---------|---------|---------|
282
+ | **UI-SDD专用模板** | UI设计稿结构化、交付标准 | UI设计阶段 |
283
+ | **功能SDD专用模板** | 业务功能专属模板、必填项规范 | 功能开发 |
284
+ | **BDD风格验收标准SDD** | BDD验收句式、准入/准出标准 | 测试验收 |
285
+ | **环境预检标准化SDD** | 本机配置、依赖版本、网络预检 | 项目启动 |
286
+ | **Flutter地图导航业务SDD** | 高德SDK集成、Marker处理 | 地图开发 |
287
+ | **Flutter音视频全栈SDD** | 离线ASR、TTS、OCR接入 | 音视频功能 |
288
+ | **Flutter全类型测试策略SDD** | Golden测试、E2E、TDD、冒烟测试 | 测试策略 |
289
+ | **Flutter常见异常专项SDD** | SocketException、渲染异常排查 | Bug修复 |
290
+ | **企业级全栈工程规范SDD** | 项目目录、版本管理、交付标准 | 工程规范 |
291
+ | **Andrej Karpathy AI编码规则SDD** | 编码约束、禁止自由发挥 | 编码规范 |
292
+ | **高保真设计转代码SDD** | Rive动画、Figma转Flutter | 设计转代码 |
293
+
294
+ ### 强制顺序流水线
295
+
296
+ ```
297
+ Base-SDD → Brain-SDD → Competitor-SDD → PRD-SDD → Figma设计 → UI-SDD → Code-SDD → API-SDD → Env-SDD → Test-SDD → TDD开发 → 分层测试 → Bug闭环 → quality-gate → sdd-deploy → release-flow → claudeception
298
+ ```
299
+
300
+ ### Bug修复流程(SDD融合版)
301
+
302
+ ```
303
+ systematic-debugging → Test-SDD补充回归用例 → sdd-add修复 → verification-before-completion → quality-gate → claudeception
304
+ ```
305
+
306
+ ### 精简流程判定标准
307
+
308
+ 满足任意2条即可使用精简流程:
309
+ - 开发周期≤1天,代码量≤500行
310
+ - 不涉及新接口、新UI组件,仅修改现有逻辑/文案
311
+ - 无复杂交互,不影响全局流程
312
+
313
+ ---
314
+
315
+ ## 更新日志
316
+ - v5.0(2026-05-06):新增SDD融合框架,9份标准化模板,全流程SDD融合体系
317
+ - v4.0(2026-05-05):发布到npm包,新增npx安装方式,支持Trae/Trae-cn/Claude Code多环境安装
318
+ - v3.0(2026-05-04):更新技能列表,匹配当前实际存在的技能
319
+ - v2.0(2024-05-04):重构为个人开发版,去掉团队协作内容,新增更多技能选项
320
+ - v1.0(2024-05-04):初始版本
@@ -1,164 +0,0 @@
1
- ---
2
- name: brainstorming
3
- description: "在任何创造性工作之前必须使用此技能——创建功能、构建组件、添加功能或修改行为。在实现之前先探索用户意图、需求和设计。"
4
- ---
5
-
6
- # 头脑风暴:将想法转化为设计
7
-
8
- 通过自然的协作对话,帮助将想法转化为完整的设计和规格说明。
9
-
10
- 首先了解当前项目的上下文,然后逐一提问来完善想法。一旦你理解了要构建的内容,就展示设计方案并获得用户批准。
11
-
12
- <HARD-GATE>
13
- 在你展示设计方案并获得用户批准之前,不要调用任何实现技能、编写任何代码、搭建任何项目或采取任何实现行动。这适用于所有项目,无论看起来多简单。
14
- </HARD-GATE>
15
-
16
- ## 反模式:"这个太简单了,不需要设计"
17
-
18
- 每个项目都要经过这个流程。一个待办事项列表、一个单函数工具、一个配置变更——全都需要。"简单"的项目恰恰是未经检验的假设造成最多浪费的地方。设计可以很简短(对于真正简单的项目几句话就够了),但你必须展示出来并获得批准。
19
-
20
- ## 检查清单
21
-
22
- 你必须为以下每个条目创建任务,并按顺序完成:
23
-
24
- 1. **探索项目上下文** — 检查文件、文档、最近的 commit
25
- 2. **提供视觉伴侣**(如果主题涉及视觉问题)— 这是一条独立的消息,不要与澄清问题合并。参见下方的"视觉伴侣"部分。
26
- 3. **提出澄清问题** — 每次一个,了解目的/约束/成功标准
27
- 4. **提出 2-3 种方案** — 附带权衡分析和你的推荐
28
- 5. **展示设计** — 按复杂度分节展示,每节展示后获得用户批准
29
- 6. **编写设计文档** — 保存到 `docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md` 并 commit
30
- 7. **规格自检** — 快速内联检查占位符、矛盾、模糊性、范围(详见下方)
31
- 8. **用户审查书面规格** — 在继续之前请用户审查规格文件
32
- 9. **过渡到实现** — 调用 writing-plans 技能创建实现计划
33
-
34
- ## 流程图
35
-
36
- ```dot
37
- digraph brainstorming {
38
- "探索项目上下文" [shape=box];
39
- "有视觉相关问题?" [shape=diamond];
40
- "提供视觉伴侣\n(独立消息,不含其他内容)" [shape=box];
41
- "提出澄清问题" [shape=box];
42
- "提出 2-3 种方案" [shape=box];
43
- "分节展示设计" [shape=box];
44
- "用户批准设计?" [shape=diamond];
45
- "编写设计文档" [shape=box];
46
- "规格自检\n(内联修复)" [shape=box];
47
- "用户审查规格?" [shape=diamond];
48
- "调用 writing-plans 技能" [shape=doublecircle];
49
-
50
- "探索项目上下文" -> "有视觉相关问题?";
51
- "有视觉相关问题?" -> "提供视觉伴侣\n(独立消息,不含其他内容)" [label="是"];
52
- "有视觉相关问题?" -> "提出澄清问题" [label="否"];
53
- "提供视觉伴侣\n(独立消息,不含其他内容)" -> "提出澄清问题";
54
- "提出澄清问题" -> "提出 2-3 种方案";
55
- "提出 2-3 种方案" -> "分节展示设计";
56
- "分节展示设计" -> "用户批准设计?";
57
- "用户批准设计?" -> "分节展示设计" [label="否,修改"];
58
- "用户批准设计?" -> "编写设计文档" [label="是"];
59
- "编写设计文档" -> "规格自检\n(内联修复)";
60
- "规格自检\n(内联修复)" -> "用户审查规格?";
61
- "用户审查规格?" -> "编写设计文档" [label="要求修改"];
62
- "用户审查规格?" -> "调用 writing-plans 技能" [label="批准"];
63
- }
64
- ```
65
-
66
- **终止状态是调用 writing-plans。** 不要调用 frontend-design、mcp-builder 或任何其他实现技能。头脑风暴之后你唯一要调用的技能是 writing-plans。
67
-
68
- ## 流程详述
69
-
70
- **理解想法:**
71
-
72
- - 首先查看当前项目状态(文件、文档、最近的 commit)
73
- - 在提出详细问题之前,先评估范围:如果需求描述了多个独立子系统(例如"构建一个包含聊天、文件存储、计费和分析的平台"),立即指出这一点。不要花时间用问题去细化一个需要先拆分的项目。
74
- - 如果项目规模过大,单个规格说明无法覆盖,帮助用户分解为子项目:有哪些独立的部分,它们之间有什么关系,应该按什么顺序构建?然后通过正常的设计流程进行第一个子项目的头脑风暴。每个子项目都有自己的规格 → 计划 → 实现周期。
75
- - 对于范围适当的项目,每次提一个问题来完善想法
76
- - 尽量使用选择题,开放式问题也可以
77
- - 每条消息只提一个问题——如果一个主题需要更多探索,拆分成多个问题
78
- - 重点理解:目的、约束、成功标准
79
-
80
- **探索方案:**
81
-
82
- - 提出 2-3 种不同的方案及其权衡
83
- - 以对话的方式展示选项,附上你的推荐和理由
84
- - 先展示你推荐的方案并解释原因
85
-
86
- **展示设计:**
87
-
88
- - 一旦你认为理解了要构建的内容,就展示设计
89
- - 每个部分的篇幅与其复杂度匹配:简单的几句话,复杂的最多 200-300 字
90
- - 每个部分展示后询问是否正确
91
- - 涵盖:架构、组件、数据流、错误处理、测试
92
- - 随时准备回头澄清不明确的地方
93
-
94
- **面向隔离和清晰的设计:**
95
-
96
- - 将系统拆分为更小的单元,每个单元有一个明确的职责,通过定义良好的接口通信,可以独立理解和测试
97
- - 对于每个单元,你应该能回答:它做什么,如何使用,它依赖什么?
98
- - 别人能否不看内部实现就理解一个单元的功能?你能否在不影响调用者的情况下修改内部实现?如果不能,边界需要调整。
99
- - 更小、边界清晰的单元也更便于你工作——你对能一次放入上下文的代码推理得更好,文件越专注你的编辑越可靠。当文件变大时,这通常意味着它承担了过多职责。
100
-
101
- **在现有代码库中工作:**
102
-
103
- - 在提出更改之前先探索现有结构。遵循现有模式。
104
- - 如果现有代码存在影响当前工作的问题(例如文件过大、边界不清、职责纠缠),在设计中包含有针对性的改进——就像一个优秀的开发者在工作中改进经手的代码一样。
105
- - 不要提议无关的重构。专注于服务当前目标的事情。
106
-
107
- ## 设计之后
108
-
109
- **文档:**
110
-
111
- - 将验证通过的设计(规格说明)写入 `docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md`
112
- - (用户对规格位置的偏好优先于此默认值)
113
- - 如果可用,使用 elements-of-style:writing-clearly-and-concisely 技能
114
- - 将设计文档 commit 到 git
115
-
116
- **规格自检:**
117
- 编写规格文档后,以全新的视角审视它:
118
-
119
- 1. **占位符扫描:** 有没有"待定"、"TODO"、未完成的章节或模糊的需求?修复它们。
120
- 2. **内部一致性:** 各章节之间有矛盾吗?架构和功能描述匹配吗?
121
- 3. **范围检查:** 这是否聚焦到可以用一个实现计划覆盖,还是需要进一步拆分?
122
- 4. **模糊性检查:** 有没有需求可以被两种方式理解?如果有,选择一种并明确写出来。
123
-
124
- 发现问题就直接内联修复。无需重新审查——修好继续推进。
125
-
126
- **用户审查关卡:**
127
- 规格自检完成后,请用户在继续之前审查书面规格:
128
-
129
- > "规格已编写并 commit 到 `<path>`。请审查一下,如果在我们开始编写实现计划之前你想做任何修改,请告诉我。"
130
-
131
- 等待用户回复。如果他们要求修改,做出修改并重新运行规格自检。只有在用户批准后才继续。
132
-
133
- **实现:**
134
-
135
- - 调用 writing-plans 技能创建详细的实现计划
136
- - 不要调用任何其他技能。writing-plans 是下一步。
137
-
138
- ## 核心原则
139
-
140
- - **每次一个问题** — 不要同时抛出多个问题
141
- - **优先选择题** — 在可能的情况下比开放式问题更容易回答
142
- - **严格遵循 YAGNI** — 从所有设计中移除不必要的功能
143
- - **探索替代方案** — 在做决定之前始终提出 2-3 种方案
144
- - **增量验证** — 展示设计,获得批准后再继续
145
- - **保持灵活** — 有不明确的地方就回头澄清
146
-
147
- ## 视觉伴侣
148
-
149
- 一个基于浏览器的伴侣工具,用于在头脑风暴过程中展示原型、图表和视觉选项。它是一个工具——不是一种模式。接受伴侣意味着它可用于适合视觉呈现的问题;并不意味着每个问题都要通过浏览器。
150
-
151
- **提供伴侣:** 当你预计后续问题会涉及视觉内容(原型、布局、图表)时,提供一次以获得同意:
152
- > "我们接下来讨论的一些内容,如果能在浏览器中展示给你看可能会更直观。我可以在讨论过程中为你制作原型、图表、对比图和其他视觉材料。这个功能还比较新,可能会消耗较多 token。要试试吗?(需要打开一个本地 URL)"
153
-
154
- **此提议必须是一条独立的消息。** 不要将它与澄清问题、上下文摘要或任何其他内容合并。消息中应该只包含上述提议,没有其他内容。等待用户回复后再继续。如果他们拒绝,继续纯文本的头脑风暴。
155
-
156
- **逐问题决策:** 即使用户接受了,也要对每个问题单独决定是使用浏览器还是终端。判断标准:**用户看到它是否比读到它更容易理解?**
157
-
158
- - **使用浏览器** 展示本身就是视觉的内容——原型、线框图、布局对比、架构图、并排视觉设计
159
- - **使用终端** 展示文本内容——需求问题、概念选择、权衡列表、A/B/C/D 文字选项、范围决策
160
-
161
- 关于 UI 主题的问题不一定是视觉问题。"在这个上下文中个性化是什么意思?"是一个概念问题——使用终端。"哪种向导布局更好?"是一个视觉问题——使用浏览器。
162
-
163
- 如果他们同意使用伴侣,在继续之前阅读详细指南:
164
- `skills/brainstorming/visual-companion.md`
@@ -1,214 +0,0 @@
1
- <!DOCTYPE html>
2
- <html>
3
- <head>
4
- <meta charset="utf-8">
5
- <title>Superpowers Brainstorming</title>
6
- <style>
7
- /*
8
- * BRAINSTORM COMPANION FRAME TEMPLATE
9
- *
10
- * This template provides a consistent frame with:
11
- * - OS-aware light/dark theming
12
- * - Fixed header and selection indicator bar
13
- * - Scrollable main content area
14
- * - CSS helpers for common UI patterns
15
- *
16
- * Content is injected via placeholder comment in #claude-content.
17
- */
18
-
19
- * { box-sizing: border-box; margin: 0; padding: 0; }
20
- html, body { height: 100%; overflow: hidden; }
21
-
22
- /* ===== THEME VARIABLES ===== */
23
- :root {
24
- --bg-primary: #f5f5f7;
25
- --bg-secondary: #ffffff;
26
- --bg-tertiary: #e5e5e7;
27
- --border: #d1d1d6;
28
- --text-primary: #1d1d1f;
29
- --text-secondary: #86868b;
30
- --text-tertiary: #aeaeb2;
31
- --accent: #0071e3;
32
- --accent-hover: #0077ed;
33
- --success: #34c759;
34
- --warning: #ff9f0a;
35
- --error: #ff3b30;
36
- --selected-bg: #e8f4fd;
37
- --selected-border: #0071e3;
38
- }
39
-
40
- @media (prefers-color-scheme: dark) {
41
- :root {
42
- --bg-primary: #1d1d1f;
43
- --bg-secondary: #2d2d2f;
44
- --bg-tertiary: #3d3d3f;
45
- --border: #424245;
46
- --text-primary: #f5f5f7;
47
- --text-secondary: #86868b;
48
- --text-tertiary: #636366;
49
- --accent: #0a84ff;
50
- --accent-hover: #409cff;
51
- --selected-bg: rgba(10, 132, 255, 0.15);
52
- --selected-border: #0a84ff;
53
- }
54
- }
55
-
56
- body {
57
- font-family: system-ui, -apple-system, BlinkMacSystemFont, sans-serif;
58
- background: var(--bg-primary);
59
- color: var(--text-primary);
60
- display: flex;
61
- flex-direction: column;
62
- line-height: 1.5;
63
- }
64
-
65
- /* ===== FRAME STRUCTURE ===== */
66
- .header {
67
- background: var(--bg-secondary);
68
- padding: 0.5rem 1.5rem;
69
- display: flex;
70
- justify-content: space-between;
71
- align-items: center;
72
- border-bottom: 1px solid var(--border);
73
- flex-shrink: 0;
74
- }
75
- .header h1 { font-size: 0.85rem; font-weight: 500; color: var(--text-secondary); }
76
- .header .status { font-size: 0.7rem; color: var(--success); display: flex; align-items: center; gap: 0.4rem; }
77
- .header .status::before { content: ''; width: 6px; height: 6px; background: var(--success); border-radius: 50%; }
78
-
79
- .main { flex: 1; overflow-y: auto; }
80
- #claude-content { padding: 2rem; min-height: 100%; }
81
-
82
- .indicator-bar {
83
- background: var(--bg-secondary);
84
- border-top: 1px solid var(--border);
85
- padding: 0.5rem 1.5rem;
86
- flex-shrink: 0;
87
- text-align: center;
88
- }
89
- .indicator-bar span {
90
- font-size: 0.75rem;
91
- color: var(--text-secondary);
92
- }
93
- .indicator-bar .selected-text {
94
- color: var(--accent);
95
- font-weight: 500;
96
- }
97
-
98
- /* ===== TYPOGRAPHY ===== */
99
- h2 { font-size: 1.5rem; font-weight: 600; margin-bottom: 0.5rem; }
100
- h3 { font-size: 1.1rem; font-weight: 600; margin-bottom: 0.25rem; }
101
- .subtitle { color: var(--text-secondary); margin-bottom: 1.5rem; }
102
- .section { margin-bottom: 2rem; }
103
- .label { font-size: 0.7rem; color: var(--text-secondary); text-transform: uppercase; letter-spacing: 0.05em; margin-bottom: 0.5rem; }
104
-
105
- /* ===== OPTIONS (for A/B/C choices) ===== */
106
- .options { display: flex; flex-direction: column; gap: 0.75rem; }
107
- .option {
108
- background: var(--bg-secondary);
109
- border: 2px solid var(--border);
110
- border-radius: 12px;
111
- padding: 1rem 1.25rem;
112
- cursor: pointer;
113
- transition: all 0.15s ease;
114
- display: flex;
115
- align-items: flex-start;
116
- gap: 1rem;
117
- }
118
- .option:hover { border-color: var(--accent); }
119
- .option.selected { background: var(--selected-bg); border-color: var(--selected-border); }
120
- .option .letter {
121
- background: var(--bg-tertiary);
122
- color: var(--text-secondary);
123
- width: 1.75rem; height: 1.75rem;
124
- border-radius: 6px;
125
- display: flex; align-items: center; justify-content: center;
126
- font-weight: 600; font-size: 0.85rem; flex-shrink: 0;
127
- }
128
- .option.selected .letter { background: var(--accent); color: white; }
129
- .option .content { flex: 1; }
130
- .option .content h3 { font-size: 0.95rem; margin-bottom: 0.15rem; }
131
- .option .content p { color: var(--text-secondary); font-size: 0.85rem; margin: 0; }
132
-
133
- /* ===== CARDS (for showing designs/mockups) ===== */
134
- .cards { display: grid; grid-template-columns: repeat(auto-fit, minmax(280px, 1fr)); gap: 1rem; }
135
- .card {
136
- background: var(--bg-secondary);
137
- border: 1px solid var(--border);
138
- border-radius: 12px;
139
- overflow: hidden;
140
- cursor: pointer;
141
- transition: all 0.15s ease;
142
- }
143
- .card:hover { border-color: var(--accent); transform: translateY(-2px); box-shadow: 0 4px 12px rgba(0,0,0,0.1); }
144
- .card.selected { border-color: var(--selected-border); border-width: 2px; }
145
- .card-image { background: var(--bg-tertiary); aspect-ratio: 16/10; display: flex; align-items: center; justify-content: center; }
146
- .card-body { padding: 1rem; }
147
- .card-body h3 { margin-bottom: 0.25rem; }
148
- .card-body p { color: var(--text-secondary); font-size: 0.85rem; }
149
-
150
- /* ===== MOCKUP CONTAINER ===== */
151
- .mockup {
152
- background: var(--bg-secondary);
153
- border: 1px solid var(--border);
154
- border-radius: 12px;
155
- overflow: hidden;
156
- margin-bottom: 1.5rem;
157
- }
158
- .mockup-header {
159
- background: var(--bg-tertiary);
160
- padding: 0.5rem 1rem;
161
- font-size: 0.75rem;
162
- color: var(--text-secondary);
163
- border-bottom: 1px solid var(--border);
164
- }
165
- .mockup-body { padding: 1.5rem; }
166
-
167
- /* ===== SPLIT VIEW (side-by-side comparison) ===== */
168
- .split { display: grid; grid-template-columns: 1fr 1fr; gap: 1.5rem; }
169
- @media (max-width: 700px) { .split { grid-template-columns: 1fr; } }
170
-
171
- /* ===== PROS/CONS ===== */
172
- .pros-cons { display: grid; grid-template-columns: 1fr 1fr; gap: 1rem; margin: 1rem 0; }
173
- .pros, .cons { background: var(--bg-secondary); border-radius: 8px; padding: 1rem; }
174
- .pros h4 { color: var(--success); font-size: 0.85rem; margin-bottom: 0.5rem; }
175
- .cons h4 { color: var(--error); font-size: 0.85rem; margin-bottom: 0.5rem; }
176
- .pros ul, .cons ul { margin-left: 1.25rem; font-size: 0.85rem; color: var(--text-secondary); }
177
- .pros li, .cons li { margin-bottom: 0.25rem; }
178
-
179
- /* ===== PLACEHOLDER (for mockup areas) ===== */
180
- .placeholder {
181
- background: var(--bg-tertiary);
182
- border: 2px dashed var(--border);
183
- border-radius: 8px;
184
- padding: 2rem;
185
- text-align: center;
186
- color: var(--text-tertiary);
187
- }
188
-
189
- /* ===== INLINE MOCKUP ELEMENTS ===== */
190
- .mock-nav { background: var(--accent); color: white; padding: 0.75rem 1rem; display: flex; gap: 1.5rem; font-size: 0.9rem; }
191
- .mock-sidebar { background: var(--bg-tertiary); padding: 1rem; min-width: 180px; }
192
- .mock-content { padding: 1.5rem; flex: 1; }
193
- .mock-button { background: var(--accent); color: white; border: none; padding: 0.5rem 1rem; border-radius: 6px; font-size: 0.85rem; }
194
- .mock-input { background: var(--bg-primary); border: 1px solid var(--border); border-radius: 6px; padding: 0.5rem; width: 100%; }
195
- </style>
196
- </head>
197
- <body>
198
- <div class="header">
199
- <h1><a href="https://github.com/obra/superpowers" style="color: inherit; text-decoration: none;">Superpowers Brainstorming</a></h1>
200
- <div class="status">Connected</div>
201
- </div>
202
-
203
- <div class="main">
204
- <div id="claude-content">
205
- <!-- CONTENT -->
206
- </div>
207
- </div>
208
-
209
- <div class="indicator-bar">
210
- <span id="indicator-text">Click an option above, then return to the terminal</span>
211
- </div>
212
-
213
- </body>
214
- </html>