sdd-full 4.6.2 → 4.8.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 (29) hide show
  1. package/bin.js +1 -1
  2. package/index.js +18 -12
  3. package/package.json +1 -1
  4. package/skills/VERSION.md +3 -3
  5. package/skills/design-planning/global-overlay-stack-standard/SKILL.md +83 -0
  6. package/skills/design-planning/ui-motion-interaction-standard/SKILL.md +79 -0
  7. package/skills/flutter/skills/flutter-add-integration-test/SKILL.md +165 -0
  8. package/skills/flutter/skills/flutter-add-widget-preview/SKILL.md +147 -0
  9. package/skills/flutter/skills/flutter-add-widget-test/SKILL.md +156 -0
  10. package/skills/flutter/skills/flutter-apply-architecture-best-practices/SKILL.md +164 -0
  11. package/skills/flutter/skills/flutter-build-responsive-layout/SKILL.md +141 -0
  12. package/skills/flutter/skills/flutter-fix-layout-issues/SKILL.md +132 -0
  13. package/skills/flutter/skills/flutter-implement-json-serialization/SKILL.md +155 -0
  14. package/skills/flutter/skills/flutter-setup-declarative-routing/SKILL.md +257 -0
  15. package/skills/flutter/skills/flutter-setup-localization/SKILL.md +212 -0
  16. package/skills/flutter/skills/flutter-use-http-package/SKILL.md +177 -0
  17. package/skills/requirement-analysis/sdd/mock_sdd.md +156 -0
  18. package/skills/writing-skills/SKILL.md +654 -0
  19. package/skills/writing-skills/anthropic-best-practices.md +1149 -0
  20. package/skills/writing-skills/examples/CLAUDE_MD_TESTING.md +189 -0
  21. package/skills/writing-skills/graphviz-conventions.dot +172 -0
  22. package/skills/writing-skills/persuasion-principles.md +187 -0
  23. package/skills/writing-skills/render-graphs.js +168 -0
  24. package/skills/writing-skills/testing-skills-with-subagents.md +384 -0
  25. package/skills/checklist.md +0 -154
  26. 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 +0 -454
  27. 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 +0 -308
  28. package/skills//346/212/200/350/203/275/344/275/277/347/224/250/346/214/207/345/215/227.md +0 -309
  29. package/skills//346/212/200/350/203/275/345/206/263/347/255/226/346/240/221.md +0 -338
@@ -1,454 +0,0 @@
1
- 【claude code调用标识:完整开发流程手册】【trae调用标识:完整开发流程手册+流程指南】【流程场景:1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代、4.Bug处理、5.代码发布】
2
-
3
- # 完整开发流程手册
4
-
5
- ## 概述
6
-
7
- 本文档定义从需求想法到上线发布的完整端到端开发流程,包含每个阶段的目标、使用技能、产出物、检查清单。
8
-
9
- ---
10
-
11
- ## 流程图(核心路径)
12
-
13
- ```
14
- 需求想法 → 1.需求分析 → 2.需求拆分 → 3.设计阶段 → 4.开发阶段 → 5.测试阶段 → 6.质量检查 → 7.发布准备 → 8.发布执行 → 9.发布验证 → 10.复盘总结
15
- ```
16
-
17
- ---
18
-
19
- ## 阶段1:需求分析
20
-
21
- ### 目标
22
- 明确需求价值,确定做还是不做,怎么做。
23
-
24
- ### 使用技能
25
- - brainstorming(头脑风暴,创意阶段)
26
- - market-research(市场调研,竞品分析)
27
- - competitive-brief(竞品简报)
28
- - requirement-completion-officer(需求补全)
29
- - **claudeception(知识沉淀,关键发现和最佳实践)**
30
-
31
- ### 产出物
32
- - 创意/调研记录
33
- - 技术初步评估
34
- - 需求优先级(可选)
35
- - **知识沉淀记录**
36
-
37
- ### 检查清单
38
- - [ ] 需求价值明确
39
- - [ ] 技术可行性初步评估
40
- - [ ] 已知风险识别
41
- - [ ] 大致范围确定
42
- - [ ] 关键知识已沉淀(claudeception)
43
-
44
- ---
45
-
46
- ## 阶段2:需求拆分(sdd)
47
-
48
- ### 目标
49
- 将模糊需求拆分为结构化、可执行的用户故事,确定UI、架构、数据库、接口。
50
-
51
- ### 使用技能
52
- - prd-write(写PRD,可选,大项目用)
53
- - sdd(基础SDD拆分,核心技能)或 sdd-full(完整SDD流程)
54
- - **claudeception(知识沉淀,架构决策和设计经验)
55
-
56
- ### 产出物
57
- ```
58
- docs/
59
- ├── stories/
60
- │ └── user_stories.md # 用户故事清单
61
- ├── ui/
62
- │ └── pages.md # UI页面清单
63
- ├── architecture/
64
- │ └── frontend-backend.md # 前后端架构
65
- ├── database/
66
- │ └── schema.md # 数据库设计
67
- └── api/
68
- └── contract.md # API契约
69
- ```
70
- - **知识沉淀记录**(架构设计决策和经验记录)
71
-
72
- ### 检查清单
73
- - [ ] Epic→Feature→User Story 拆分完成
74
- - [ ] 每个Story有验收标准
75
- - [ ] UI页面清单完整
76
- - [ ] 前后端职责清晰
77
- - [ ] 数据库/API契约明确
78
- - [ ] 知识沉淀已完成(claudeception)
79
-
80
- ---
81
-
82
- ## 阶段3:设计阶段
83
-
84
- ### 目标
85
- 设计UI交互、功能实现、测试策略、部署方案。
86
-
87
- ### 使用技能
88
- - ui-sdd(UI交互SDD)
89
- - sdd-code(功能实现SDD)
90
- - sdd-test(测试SDD)
91
- - sdd-deploy(部署SDD)
92
- - sdd-ops(运维SDD)
93
- - writing-plans(编写计划)
94
- - **claudeception(知识沉淀,设计经验和最佳实践)**
95
-
96
- ### 产出物
97
- ```
98
- specs/
99
- ├── ui/ # UI SDD(ui-sdd产出)
100
- ├── function-implementation-sdd/ # 功能实现SDD(sdd-code产出)
101
- └── test/ # 测试SDD(sdd-test产出)
102
- docs/
103
- └── deploy/ # 部署SDD(sdd-deploy产出)
104
- └── ops/ # 运维SDD(sdd-ops产出)
105
- ```
106
- - **知识沉淀记录**(设计经验和最佳实践)
107
-
108
- ### 检查清单
109
- - [ ] UI SDD覆盖所有页面/组件
110
- - [ ] 功能实现SDD独立可交付
111
- - [ ] 测试SDD覆盖单元/集成/E2E/性能/安全
112
- - [ ] 部署SDD包含回滚方案
113
- - [ ] 运维SDD包含监控/备份方案
114
- - [ ] 知识沉淀已完成(claudeception)
115
-
116
- ---
117
-
118
- ## 阶段4:开发阶段
119
-
120
- ### 目标
121
- 按SDD实现功能,保证代码质量。
122
-
123
- ### 使用技能
124
- - sdd-add(快速迭代,小型需求)
125
- - test-driven-development(TDD,推荐)
126
- - systematic-debugging(调试)
127
- - verification-before-completion(完成前验证)
128
- - **claudeception(知识沉淀,开发经验和问题解决)**
129
-
130
- ### 产出物
131
- - 可运行代码
132
- - 单元测试代码
133
- - **知识沉淀记录**(开发经验和问题解决方案)
134
-
135
- ### 检查清单
136
- - [ ] 代码按规范编写
137
- - [ ] 单元测试覆盖核心逻辑
138
- - [ ] 代码提交前验证通过
139
- - [ ] 知识沉淀已完成(claudeception)
140
-
141
- ---
142
-
143
- ## 阶段5:测试阶段
144
-
145
- ### 目标
146
- 全面测试,保证功能正常,性能达标,安全可靠。
147
-
148
- ### 使用技能
149
- - sdd-test产出的测试SDD
150
- - verification-before-completion(验证)
151
- - **performance-optimize(性能优化,可选,如发现性能问题)**
152
- - **claudeception(知识沉淀,测试经验和Bug修复经验)**
153
-
154
- ### 产出物
155
- - 测试用例执行记录
156
- - 测试报告
157
- - Bug清单(已修复)
158
- - **Performance-SDD(可选,如有性能优化)**
159
- - **知识沉淀记录**(测试经验和Bug修复经验)
160
-
161
- ### 检查清单
162
- - [ ] 所有测试用例执行完成
163
- - [ ] 单元测试覆盖率达标
164
- - [ ] 集成测试通过
165
- - [ ] 性能测试通过
166
- - [ ] 安全测试通过
167
- - [ ] 所有P0/P1 Bug已修复
168
- - [ ] 知识沉淀已完成(claudeception)
169
-
170
- ---
171
-
172
- ## 阶段6:质量检查
173
-
174
- ### 目标
175
- 发布前最后一道关卡,全面检查质量是否达标。
176
-
177
- ### 使用技能
178
- - quality-gate(质量门禁,核心技能)
179
- - security-audit(安全审计)
180
- - **performance-optimize(性能优化,可选,最终性能检查)**
181
- - **claudeception(知识沉淀,质量检查经验)**
182
-
183
- ### 产出物
184
- - 质量检查报告
185
- - 风险评估记录
186
- - 发布决策
187
- - **知识沉淀记录**(质量检查经验)
188
-
189
- ### 检查清单
190
- - [ ] 代码质量检查通过
191
- - [ ] 测试覆盖率检查通过
192
- - [ ] 性能基准检查通过
193
- - [ ] 安全漏洞扫描通过
194
- - [ ] 文档完整性检查通过
195
- - [ ] 知识沉淀已完成(claudeception)
196
-
197
- ---
198
-
199
- ## 阶段7:发布准备
200
-
201
- ### 目标
202
- 准备发布计划、回滚方案、通知相关人员。
203
-
204
- ### 使用技能
205
- - sdd-deploy(部署SDD,复用阶段3产出)
206
- - finishing-a-development-branch(完成开发分支,可选)
207
- - release-flow(发布流程管理,计划阶段)
208
- - **claudeception(知识沉淀,发布准备经验)**
209
-
210
- ### 产出物
211
- ```
212
- docs/
213
- ├── deploy/
214
- │ └── ...(复用)
215
- └── release/
216
- └── release-plan.md # 发布计划
217
- ```
218
- - **知识沉淀记录**(发布准备经验)
219
-
220
- ### 检查清单
221
- - [ ] 发布计划完整
222
- - [ ] 回滚方案准备好
223
- - [ ] 数据备份完成
224
- - [ ] 发布通知已发送
225
- - [ ] 相关人员已到位
226
- - [ ] 知识沉淀已完成(claudeception)
227
-
228
- ---
229
-
230
- ## 阶段8:发布执行
231
-
232
- ### 目标
233
- 按计划执行发布,监控状态,处理问题。
234
-
235
- ### 使用技能
236
- - release-flow(发布执行阶段)
237
- - **claudeception(知识沉淀,发布执行经验)**
238
-
239
- ### 产出物
240
- - 发布执行记录
241
- - 实时监控数据
242
- - **知识沉淀记录**(发布执行经验)
243
-
244
- ### 检查清单
245
- - [ ] 按发布检查清单执行
246
- - [ ] 发布过程监控正常
247
- - [ ] 问题及时响应处理
248
- - [ ] 发布完成确认
249
- - [ ] 知识沉淀已完成(claudeception)
250
-
251
- ---
252
-
253
- ## 阶段9:发布验证
254
-
255
- ### 目标
256
- 验证发布后功能正常,数据正确,用户反馈良好。
257
-
258
- ### 使用技能
259
- - release-flow(发布验证阶段)
260
- - **performance-optimize(性能优化,可选,生产环境性能验证)**
261
- - **claudeception(知识沉淀,发布验证经验)**
262
-
263
- ### 产出物
264
- - 验证记录
265
- - 用户反馈收集
266
- - 发布记录文档
267
- - **知识沉淀记录**(发布验证经验)
268
-
269
- ### 检查清单
270
- - [ ] 冒烟测试通过
271
- - [ ] 功能验证完成
272
- - [ ] 性能验证通过
273
- - [ ] 监控数据正常
274
- - [ ] 用户反馈正常
275
- - [ ] 知识沉淀已完成(claudeception)
276
-
277
- ---
278
-
279
- ## 阶段10:复盘总结
280
-
281
- ### 目标
282
- 总结经验教训,识别改进点,优化流程。
283
-
284
- ### 使用技能
285
- - release-flow(发布复盘阶段)
286
- - **claudeception(沉淀经验,必须)**
287
- - **mempalace-auto-saver(自动保存记忆,必须)**
288
-
289
- ### 产出物
290
- ```
291
- docs/
292
- └── release/
293
- ├── release-record.md # 发布记录
294
- └── release-retrospective.md # 发布复盘
295
- ```
296
- - **完整的知识沉淀记录**(全流程经验总结)
297
-
298
- ### 检查清单
299
- - [ ] 发布记录完整
300
- - [ ] 问题根因分析完成
301
- - [ ] 经验教训总结
302
- - [ ] 改进计划制定
303
- - [ ] 经验已沉淀(claudeception + mempalace-auto-saver,必须)
304
-
305
- ---
306
-
307
- ## 完整流程检查清单(大项目)
308
-
309
- | 阶段 | 检查项 |
310
- |-----|--------|
311
- | 1.需求分析 | 价值明确、技术可行、需求补全、**知识沉淀** |
312
- | 2.需求拆分 | sdd/sdd-full完成、所有文档产出、**知识沉淀** |
313
- | 3.设计阶段 | ui-sdd、sdd-code、sdd-test、sdd-deploy、sdd-ops、writing-plans、**知识沉淀** |
314
- | 4.开发阶段 | 代码完成、单元测试、验证通过、**知识沉淀** |
315
- | 5.测试阶段 | 各类测试通过、P0/P1 Bug修复、**性能优化(可选)**、**知识沉淀** |
316
- | 6.质量检查 | quality-gate、security-audit全通过、**性能检查(可选)**、**知识沉淀** |
317
- | 7.发布准备 | 计划、回滚、通知都做好、**知识沉淀** |
318
- | 8.发布执行 | 发布过程顺利、**知识沉淀** |
319
- | 9.发布验证 | 功能正常、监控正常、**性能验证(可选)**、**知识沉淀** |
320
- | 10.复盘总结 | 记录完整、有改进计划、**知识沉淀(必须)** |
321
-
322
- ---
323
-
324
- ## 简化流程(小项目/快速迭代)
325
-
326
- 对于小项目或快速迭代,可以简化流程:
327
-
328
- ```
329
- 需求想法 → requirement-completion-officer(可选) → writing-plans(可选) → sdd-add → 开发 → verification-before-completion → **performance-optimize(可选)** → quality-gate → finishing-a-development-branch(可选) → 快速发布 → **claudeception(必须,沉淀经验)**
330
- ```
331
-
332
- ### 简化检查清单
333
- - [ ] 需求补全完成(可选)
334
- - [ ] 计划制定完成(可选)
335
- - [ ] sdd-add完成
336
- - [ ] 开发完成
337
- - [ ] 验证通过
338
- - [ ] 性能检查完成(可选)
339
- - [ ] quality-gate基础通过
340
- - [ ] 发布完成
341
- - [ ] 知识沉淀完成(claudeception,必须)
342
-
343
- ---
344
-
345
- ## Bug修复流程(精简合规版)
346
-
347
- ### 标准版(推荐,带复现确认)
348
- ```
349
- /bug 或 修复Bug → bug-reproduction-confirm → [Flutter iOS真机问题? ios-full-auto-debug] → systematic-debugging → verification-before-completion → quality-gate → claudeception
350
- ```
351
-
352
- ### 极简版(无复现确认)
353
- ```
354
- /bug 或 修复Bug → [Flutter iOS真机问题? ios-full-auto-debug] → systematic-debugging → verification-before-completion → quality-gate → claudeception
355
- ```
356
-
357
- ### 分支流转规则
358
- - **复现通过 → systematic-debugging
359
- - **复现不通过 → 直接归档闭环,关闭Bug
360
-
361
- ---
362
-
363
- ## 时间估算参考
364
-
365
- | 阶段 | 小项目 | 中项目 | 大项目 |
366
- |-----|--------|--------|--------|
367
- | 1.需求分析 | 0.5-1天 | 1-2天 | 3-5天 |
368
- | 2.需求拆分 | 1-2天 | 2-3天 | 3-7天 |
369
- | 3.设计阶段 | 1-2天 | 2-4天 | 4-10天 |
370
- | 4.开发阶段 | 2-5天 | 5-10天 | 10-30天 |
371
- | 5.测试阶段 | 1-2天 | 2-4天 | 4-10天 |
372
- | 6.质量检查 | 0.5天 | 0.5-1天 | 1-2天 |
373
- | 7.发布准备 | 0.5天 | 0.5-1天 | 1-2天 |
374
- | 8.发布执行 | 0.5-1天 | 1-2天 | 2-4天 |
375
- | 9.发布验证 | 0.5-1天 | 1-2天 | 2-3天 |
376
- | 10.复盘总结 | 0.5天 | 0.5-1天 | 1-2天 |
377
- | **合计** | **7-16天** | **14-30天** | **31-76天** |
378
-
379
- ---
380
-
381
- ## 最佳实践
382
-
383
- 1. **流程适配:** 大项目走完整流程,小项目简化流程
384
- 2. **质量第一:** 任何发布前至少走quality-gate
385
- 3. **可追溯:** 每个阶段的产出文档要保存好
386
- 4. **持续改进:** 每次复盘后要优化流程
387
- 5. **快速反馈:** 问题发现越早,修复成本越低
388
- 6. **知识管理嵌入全流程:** **每个关键阶段完成后必须用claudeception沉淀经验**
389
- 7. **性能优化常态化:** 在测试、质量检查、发布验证阶段都考虑性能,必要时使用performance-optimize
390
- 8. **需求明确:** 不明确时先用requirement-completion-officer补全需求
391
-
392
- ---
393
-
394
- ---
395
-
396
- ## SDD融合框架(新增)
397
-
398
- ### 9份标准化SDD模板
399
-
400
- | 模板名称 | 核心内容 | 适用技能 |
401
- |---------|---------|---------|
402
- | **Base-SDD** | 全局通用基线规范 | sdd, sdd-full |
403
- | **Brain-SDD** | 头脑风暴文档 | brainstorming |
404
- | **Competitor-SDD** | 竞品分析文档 | competitive-brief, market-research |
405
- | **PRD-SDD** | 产品需求文档 | prd-write, requirement-completion-officer |
406
- | **UI-SDD** | UI设计文档 | ui-sdd |
407
- | **Code-SDD** | 代码实现文档 | sdd-code, test-driven-development |
408
- | **API-SDD** | 接口设计文档 | sdd(接口拆分) |
409
- | **Env-SDD** | 环境配置文档 | sdd-deploy, sdd-ops |
410
- | **Test-SDD** | 测试设计文档 | sdd-test, test-driven-development |
411
-
412
- ### 强制顺序流水线
413
-
414
- ```
415
- 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
416
- ```
417
-
418
- ### Bug修复流程(SDD融合版)
419
-
420
- ```
421
- 1. [Flutter iOS真机问题? ios-full-auto-debug] → systematic-debugging → 更新Code-SDD技术债务记录
422
-
423
- 2. Test-SDD补充回归用例 → 关联bug编号
424
-
425
- 3. sdd-add修复 → 更新Code-SDD/API-SDD/Env-SDD
426
-
427
- 4. verification-before-completion → 更新Test-SDD测试结果
428
-
429
- 5. quality-gate → 校验所有SDD规范一致性
430
-
431
- 6. claudeception → 更新技术债务/经验沉淀章节
432
- ```
433
-
434
- ### 精简流程判定标准
435
-
436
- 满足任意2条即可使用精简流程:
437
- - 开发周期≤1天,代码量≤500行
438
- - 不涉及新接口、新UI组件,仅修改现有逻辑/文案
439
- - 无复杂交互,不影响全局流程
440
-
441
- ### 模板版本锁定规则
442
-
443
- - 所有SDD模板版本化管理
444
- - 每个项目绑定固定模板版本,不随意自动升级
445
- - 通过`template-version.lock`文件记录版本信息
446
-
447
- ---
448
-
449
- ## 更新日志
450
- - v5.1(2026-05-06):添加ios-full-auto-debug技能到Bug修复流程中
451
- - v4.0(2026-05-06):新增SDD融合框架,9份标准化模板,强制顺序流水线,Bug修复流程融合
452
- - v3.0(2026-05-05):发布到npm包,新增npx安装方式,支持Trae/Trae-cn/Claude Code多环境安装
453
- - v2.0(2026-05-04):更新技能列表,匹配当前实际存在的技能
454
- - v1.0(2024-05-04):初始版本,完整流程定义