sdd-full 5.0.6 → 5.0.8

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 (93) hide show
  1. package/.claude/SDD_ORCHESTRATOR_PROMPT.md +301 -0
  2. package/.claude/agents/orchestrator.md +83 -124
  3. package/.claude/commands/bug.md +2 -5
  4. package/.claude/commands/dev.md +2 -5
  5. package/.claude/commands/env.md +2 -5
  6. package/.claude/commands/flow.md +4 -8
  7. package/.claude/commands/full.md +2 -5
  8. package/.claude/commands/git.md +1 -4
  9. package/.claude/commands/release.md +2 -5
  10. package/.claude/commands/review.md +2 -5
  11. package/.claude/commands/save.md +2 -5
  12. package/.claude/commands/sdd.md +2 -5
  13. package/.claude/commands/ui.md +2 -5
  14. package/.claude/rules/project_rules.md +21 -17
  15. package/.claude/rules/trae-rules.md +50 -0
  16. package/.claude/settings.json +40 -0
  17. package/.claude/skills/README.md +31 -11
  18. package/.claude/skills/ai-coding-rules/SKILL.md +5 -1
  19. package/.claude/skills/bdd-acceptance/SKILL.md +5 -1
  20. package/.claude/skills/brainstorming/SKILL.md +5 -1
  21. package/.claude/skills/bug-reproduction-confirm/SKILL.md +5 -1
  22. package/.claude/skills/claudeception/SKILL.md +28 -53
  23. package/.claude/skills/competitive-brief/SKILL.md +5 -1
  24. package/.claude/skills/design-to-code/SKILL.md +5 -1
  25. package/.claude/skills/env-check/SKILL.md +5 -1
  26. package/.claude/skills/finishing-a-development-branch/SKILL.md +5 -1
  27. package/.claude/skills/flutter-add-integration-test/SKILL.md +5 -1
  28. package/.claude/skills/flutter-add-widget-preview/SKILL.md +5 -1
  29. package/.claude/skills/flutter-add-widget-test/SKILL.md +5 -1
  30. package/.claude/skills/flutter-apply-architecture-best-practices/SKILL.md +5 -1
  31. package/.claude/skills/flutter-build-responsive-layout/SKILL.md +5 -1
  32. package/.claude/skills/flutter-errors/SKILL.md +5 -1
  33. package/.claude/skills/flutter-fix-layout-issues/SKILL.md +5 -1
  34. package/.claude/skills/flutter-implement-json-serialization/SKILL.md +5 -1
  35. package/.claude/skills/flutter-setup-declarative-routing/SKILL.md +5 -1
  36. package/.claude/skills/flutter-setup-localization/SKILL.md +5 -1
  37. package/.claude/skills/flutter-test/SKILL.md +5 -1
  38. package/.claude/skills/flutter-use-http-package/SKILL.md +5 -1
  39. package/.claude/skills/ios-full-auto-debug/SKILL.md +5 -1
  40. package/.claude/skills/market-research/SKILL.md +5 -1
  41. package/.claude/skills/performance-optimize/SKILL.md +5 -1
  42. package/.claude/skills/prd-write/SKILL.md +5 -1
  43. package/.claude/skills/quality-gate/SKILL.md +5 -1
  44. package/.claude/skills/receiving-code-review/SKILL.md +5 -1
  45. package/.claude/skills/release-flow/SKILL.md +5 -1
  46. package/.claude/skills/requesting-code-review/SKILL.md +5 -1
  47. package/.claude/skills/requirement-completion-officer/SKILL.md +5 -1
  48. package/.claude/skills/role-roundtable-review/SKILL.md +5 -1
  49. package/.claude/skills/sdd/SKILL.md +97 -163
  50. package/.claude/skills/sdd-add/SKILL.md +5 -1
  51. package/.claude/skills/sdd-code/SKILL.md +5 -1
  52. package/.claude/skills/sdd-deploy/SKILL.md +5 -1
  53. package/.claude/skills/sdd-full/SKILL.md +3 -17
  54. package/.claude/skills/sdd-test/SKILL.md +5 -1
  55. package/.claude/skills/security-audit/SKILL.md +5 -1
  56. package/.claude/skills/systematic-debugging/SKILL.md +5 -1
  57. package/.claude/skills/templates/API-SDD.md +4 -3
  58. package/.claude/skills/templates/Andrej Karpathy AI/347/274/226/347/240/201/350/247/204/345/210/231/350/220/275/345/234/260SDD.md" +0 -1
  59. package/.claude/skills/templates/BDD/351/243/216/346/240/274/351/252/214/346/224/266/346/240/207/345/207/206SDD.md +0 -1
  60. package/.claude/skills/templates/Base-SDD.md +4 -3
  61. package/.claude/skills/templates/Brain-SDD.md +4 -3
  62. package/.claude/skills/templates/BugReproduction-SDD.md +4 -2
  63. package/.claude/skills/templates/Code-SDD.md +4 -3
  64. package/.claude/skills/templates/Competitor-SDD.md +4 -3
  65. package/.claude/skills/templates/Env-SDD.md +4 -3
  66. package/.claude/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 +0 -1
  67. package/.claude/skills/templates/Flutter/345/234/260/345/233/276/345/257/274/350/210/252/344/270/232/345/212/241SDD.md +0 -1
  68. package/.claude/skills/templates/Flutter/345/270/270/350/247/201/345/274/202/345/270/270/344/270/223/351/241/271SDD.md +0 -1
  69. package/.claude/skills/templates/Flutter/351/237/263/350/247/206/351/242/221/345/205/250/346/240/210SDD.md +0 -1
  70. package/.claude/skills/templates/PRD-SDD.md +4 -3
  71. package/.claude/skills/templates/Performance-SDD.md +4 -2
  72. package/.claude/skills/templates/SKILL.md +5 -1
  73. package/.claude/skills/templates/Test-SDD.md +4 -3
  74. package/.claude/skills/templates/UI-SDD.md +4 -3
  75. package/.claude/skills/templates/UI-SDD/344/270/223/347/224/250/346/250/241/346/235/277.md +0 -1
  76. package/.claude/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 +0 -1
  77. package/.claude/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 +0 -1
  78. package/.claude/skills/templates//345/205/250/346/265/201/347/250/213SDD/350/236/215/345/220/210/344/275/223/347/263/273.md +4 -3
  79. package/.claude/skills/templates//345/212/237/350/203/275SDD/344/270/223/347/224/250/346/250/241/346/235/277.md +0 -1
  80. package/.claude/skills/templates//347/216/257/345/242/203/351/242/204/346/243/200/346/240/207/345/207/206/345/214/226SDD.md +0 -1
  81. package/.claude/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 +0 -1
  82. package/.claude/skills/test-driven-development/SKILL.md +5 -1
  83. package/.claude/skills/ui-motion-interaction-standard/SKILL.md +5 -1
  84. package/.claude/skills/ui-sdd/SKILL.md +5 -1
  85. package/.claude/skills/verification-before-completion/SKILL.md +5 -1
  86. package/.claude/skills/writing-plans/SKILL.md +5 -1
  87. package/bin.js +123 -29
  88. package/package.json +1 -1
  89. package/.claude/commands/debug.md +0 -21
  90. package/.claude/commands/iter.md +0 -22
  91. package/.claude/commands/new.md +0 -25
  92. package/.claude/skills/mempalace-auto-saver/SKILL.md +0 -302
  93. package/README.md +0 -94
@@ -1,9 +1,8 @@
1
- 【claude code调用标识:sdd】【trae调用标识:sdd+需求拆分】【流程场景:需求分析阶段核心技能】
1
+ ***
2
2
 
3
- ---
4
3
  name: sdd
5
- description: 需求拆分核心技能,负责将需求拆分为用户故事、前后端架构边界、数据库/API契约,产出子代理可用的SDD功能规格。UI设计请使用ui-sdd,实现设计请使用sdd-code。
6
- ---
4
+ description: Use when splitting requirements into user stories, architecture boundaries, database/API contracts, and producing SDD specifications for implementation
5
+ --------------------------------------------------------------------------------------------------------------------------------------------------------------------
7
6
 
8
7
  # SDD 需求拆分(需求层核心技能)
9
8
 
@@ -14,23 +13,24 @@ description: 需求拆分核心技能,负责将需求拆分为用户故事、
14
13
  **大需求 → Epic拆分(超大需求适用)→ 用户故事拆分(INVEST原则)→ 前后端架构拆分 → 数据库+接口拆分 → SDD垂直切片**
15
14
 
16
15
  核心目的:
16
+
17
17
  - 产出符合INVEST原则的用户故事
18
18
  - 明确前后端权责边界与协作契约
19
19
  - 生成子代理可直接消费的SDD功能规格
20
20
 
21
- ---
21
+ ***
22
22
 
23
23
  ## 职责边界
24
24
 
25
- | 技能 | 职责 | 产出 |
26
- |------|------|------|
27
- | sdd | 需求层·业务拆分 | 用户故事、架构边界、接口契约 |
28
- | ui-sdd | 架构层·UI交互设计 | UI页面/组件/弹窗SDD |
29
- | sdd-code | 实现层·功能实现设计 | 代码实现SDD |
25
+ | 技能 | 职责 | 产出 |
26
+ | -------- | ---------- | -------------- |
27
+ | sdd | 需求层·业务拆分 | 用户故事、架构边界、接口契约 |
28
+ | ui-sdd | 架构层·UI交互设计 | UI页面/组件/弹窗SDD |
29
+ | sdd-code | 实现层·功能实现设计 | 代码实现SDD |
30
30
 
31
31
  **注意**:本技能不负责详细UI设计和代码实现设计,相关工作请分别调用 **ui-sdd** 和 **sdd-code**。
32
32
 
33
- ---
33
+ ***
34
34
 
35
35
  ## 何时使用
36
36
 
@@ -39,7 +39,7 @@ description: 需求拆分核心技能,负责将需求拆分为用户故事、
39
39
  - 在完整全流程开发中进行需求分析阶段工作
40
40
  - 需要为子代理驱动开发准备可执行的SDD规格
41
41
 
42
- ---
42
+ ***
43
43
 
44
44
  ## 核心流程
45
45
 
@@ -76,7 +76,7 @@ digraph requirement_splitting {
76
76
  流程本质:**先垂直切片(用户价值维度),再水平分层(技术栈维度)**
77
77
  优势:**既保证独立交付价值,又确保技术架构规范**
78
78
 
79
- ---
79
+ ***
80
80
 
81
81
  ## 个人敏捷工作流
82
82
 
@@ -88,14 +88,14 @@ digraph requirement_splitting {
88
88
 
89
89
  ### 2. 关键实践
90
90
 
91
- | 实践 | 具体做法 | 优势 |
92
- |------|----------|------|
93
- | 分批交付 | 按用户故事优先级分组,每批1–3个故事,分批完成水平拆分与开发 | 避免全量冻结,支持快速迭代,降低风险 |
94
- | 并行开发 | 前端按Mock数据开发,后端按契约开发,互不依赖 | 缩短迭代周期,提高开发效率 |
95
- | 契约版本化 | 每批故事对应一个契约版本,变更只影响当前批次 | 控制变更范围,减少返工成本 |
96
- | 子代理适配 | 每个SDD对应一个子代理任务,完成后自动审查 | 适配Superpowers/Trae-CN工作流,保证质量 |
91
+ | 实践 | 具体做法 | 优势 |
92
+ | ----- | ------------------------------- | ------------------ |
93
+ | 分批交付 | 按用户故事优先级分组,每批1–3个故事,分批完成水平拆分与开发 | 避免全量冻结,支持快速迭代,降低风险 |
94
+ | 并行开发 | 前端按Mock数据开发,后端按契约开发,互不依赖 | 缩短迭代周期,提高开发效率 |
95
+ | 契约版本化 | 每批故事对应一个契约版本,变更只影响当前批次 | 控制变更范围,减少返工成本 |
96
+ | 子代理适配 | 每个SDD对应一个子代理任务,完成后自动审查 | 适配工作流,保证质量 |
97
97
 
98
- ---
98
+ ***
99
99
 
100
100
  ## 第0步:Epic拆分(超大需求适用)
101
101
 
@@ -106,6 +106,7 @@ digraph requirement_splitting {
106
106
  ### Epic定义与识别标准
107
107
 
108
108
  什么是Epic?
109
+
109
110
  - **范围**:预计超过2周完成
110
111
  - **价值**:代表宏观用户价值或业务目标
111
112
  - **特点**:模糊性高,细节不明确,需要进一步拆解
@@ -140,15 +141,15 @@ digraph requirement_splitting {
140
141
 
141
142
  ### 6种Epic拆分模式(按场景选择)
142
143
 
143
- | 拆分模式 | 适用场景 | 示例 |
144
- |----------|----------|------|
145
- | **按用户旅程拆分** | 有明确用户操作流程的功能 | 购物流程:浏览→详情→加购→结算→订单 |
146
- | **按功能模块拆分** | 模块化强的系统 | 电商系统:用户→商品→订单→支付 |
147
- | **按平台适配拆分** | 跨平台开发 | 登录功能:Web→iOS→Android |
148
- | **按复杂度分层拆分** | 功能复杂度差异大的功能 | 搜索功能:基础搜索→高级筛选→智能推荐 |
149
- | **按时间阶段拆分** | 有明确时间节点的功能 | 会员系统:MVP版→高级版→尊享版 |
144
+ | 拆分模式 | 适用场景 | 示例 |
145
+ | ------------ | ------------ | -------------------- |
146
+ | **按用户旅程拆分** | 有明确用户操作流程的功能 | 购物流程:浏览→详情→加购→结算→订单 |
147
+ | **按功能模块拆分** | 模块化强的系统 | 电商系统:用户→商品→订单→支付 |
148
+ | **按平台适配拆分** | 跨平台开发 | 登录功能:Web→iOS→Android |
149
+ | **按复杂度分层拆分** | 功能复杂度差异大的功能 | 搜索功能:基础搜索→高级筛选→智能推荐 |
150
+ | **按时间阶段拆分** | 有明确时间节点的功能 | 会员系统:MVP版→高级版→尊享版 |
150
151
 
151
- ---
152
+ ***
152
153
 
153
154
  ## 第0.5步:拆用户故事
154
155
 
@@ -225,6 +226,7 @@ digraph requirement_splitting {
225
226
  ### 三种验收标准格式
226
227
 
227
228
  #### 1. BDD场景格式(推荐)
229
+
228
230
  ```markdown
229
231
  ### 主场景
230
232
  Given [初始状态/前置条件]
@@ -234,6 +236,7 @@ And [附加验证点1]
234
236
  ```
235
237
 
236
238
  #### 2. 规则列表格式(适合简单功能)
239
+
237
240
  ```markdown
238
241
  - ✅ 必须支持用户名/邮箱/手机号三种登录方式
239
242
  - ✅ 密码输入框必须隐藏明文显示
@@ -241,18 +244,19 @@ And [附加验证点1]
241
244
  ```
242
245
 
243
246
  #### 3. 多平台矩阵格式(适合复杂跨平台功能)
244
- | 场景 | 操作 | 预期结果(Web) | 预期结果(iOS) |
245
- |------|------|----------------|----------------|
246
- | 正常登录 | 输入正确账号密码 | 跳转首页 | 跳转首页 |
247
+
248
+ | 场景 | 操作 | 预期结果(Web) | 预期结果(iOS) |
249
+ | ---- | -------- | --------- | --------- |
250
+ | 正常登录 | 输入正确账号密码 | 跳转首页 | 跳转首页 |
247
251
 
248
252
  ### 敏捷故事拆分方法
249
253
 
250
- | 方法 | 适用场景 | 示例 |
251
- |------|----------|------|
254
+ | 方法 | 适用场景 | 示例 |
255
+ | ------- | ------------ | ------------------- |
252
256
  | 按用户旅程拆分 | 有明确用户操作流程的功能 | 购物流程:浏览→详情→加购→结算→订单 |
253
- | 按数据边界拆分 | 包含多数据实体的功能 | 简历功能:基本信息→工作经历→教育背景 |
254
- | 按操作路径拆分 | 有多种执行路径的功能 | 登录功能:正常登录→忘记密码→注册 |
255
- | 按优先级拆分 | 大型复杂功能 | 支付功能:基础支付→优惠券→积分抵扣 |
257
+ | 按数据边界拆分 | 包含多数据实体的功能 | 简历功能:基本信息→工作经历→教育背景 |
258
+ | 按操作路径拆分 | 有多种执行路径的功能 | 登录功能:正常登录→忘记密码→注册 |
259
+ | 按优先级拆分 | 大型复杂功能 | 支付功能:基础支付→优惠券→积分抵扣 |
256
260
 
257
261
  ### 故事拆分原则
258
262
 
@@ -262,7 +266,7 @@ And [附加验证点1]
262
266
  4. 优先拆分**核心价值**故事,再拆分边缘功能
263
267
  5. 每个故事必须有明确的**验收标准**和**优先级**
264
268
 
265
- ---
269
+ ***
266
270
 
267
271
  ## 第1步:拆UI设计
268
272
 
@@ -313,7 +317,7 @@ And [附加验证点1]
313
317
  - **严禁**出现接口字段、表结构、技术选型
314
318
  - 覆盖**核心用户旅程**,边缘页面可后续补充
315
319
 
316
- ---
320
+ ***
317
321
 
318
322
  ## 第2步:拆前后端分离架构
319
323
 
@@ -372,7 +376,7 @@ And [附加验证点1]
372
376
  - **边界刚性**:不允许前端写复杂业务、不允许后端渲染页面
373
377
  - **敏捷适配**:支持按用户故事分批交付,不要求全量完成后再上线
374
378
 
375
- ---
379
+ ***
376
380
 
377
381
  ## 第3步:拆数据库+接口
378
382
 
@@ -456,7 +460,7 @@ And [附加验证点1]
456
460
 
457
461
  ### 接口契约模板
458
462
 
459
- ```markdown
463
+ ````markdown
460
464
  # 接口契约(RESTful,JSON,版本 v1)
461
465
 
462
466
  ## 通用规则
@@ -473,13 +477,14 @@ And [附加验证点1]
473
477
  "message": "success",
474
478
  "data": {}
475
479
  }
476
- ```
480
+ ````
477
481
 
478
482
  ## 用户模块(关联故事1)
479
483
 
480
484
  ### POST /api/v1/auth/login - 用户登录
481
485
 
482
486
  请求:
487
+
483
488
  ```json
484
489
  {
485
490
  "username": "string",
@@ -489,6 +494,7 @@ And [附加验证点1]
489
494
  ```
490
495
 
491
496
  响应成功(200):
497
+
492
498
  ```json
493
499
  {
494
500
  "code": 0,
@@ -506,6 +512,7 @@ And [附加验证点1]
506
512
  ```
507
513
 
508
514
  响应失败(401):
515
+
509
516
  ```json
510
517
  {
511
518
  "code": 401,
@@ -517,6 +524,7 @@ And [附加验证点1]
517
524
  ### POST /api/v1/auth/register - 用户注册
518
525
 
519
526
  请求:
527
+
520
528
  ```json
521
529
  {
522
530
  "username": "string",
@@ -530,6 +538,7 @@ And [附加验证点1]
530
538
  需要认证。
531
539
 
532
540
  响应:
541
+
533
542
  ```json
534
543
  {
535
544
  "code": 0,
@@ -549,12 +558,14 @@ And [附加验证点1]
549
558
  ### GET /api/v1/goods/list - 商品列表(分页)
550
559
 
551
560
  请求参数(Query):
561
+
552
562
  - page(INT,页码,默认1)
553
563
  - pageSize(INT,每页数量,默认20)
554
564
  - categoryId(INT,分类ID,可选)
555
565
  - keyword(STRING,搜索关键词,可选)
556
566
 
557
567
  响应:
568
+
558
569
  ```json
559
570
  {
560
571
  "code": 0,
@@ -581,6 +592,7 @@ And [附加验证点1]
581
592
  ### GET /api/v1/goods/detail/:id - 商品详情
582
593
 
583
594
  响应:
595
+
584
596
  ```json
585
597
  {
586
598
  "code": 0,
@@ -607,6 +619,7 @@ And [附加验证点1]
607
619
  需要认证。
608
620
 
609
621
  请求:
622
+
610
623
  ```json
611
624
  {
612
625
  "goodsId": 1,
@@ -619,6 +632,7 @@ And [附加验证点1]
619
632
  需要认证。
620
633
 
621
634
  响应:
635
+
622
636
  ```json
623
637
  {
624
638
  "code": 0,
@@ -644,6 +658,7 @@ And [附加验证点1]
644
658
  需要认证。
645
659
 
646
660
  请求:
661
+
647
662
  ```json
648
663
  {
649
664
  "addressId": 1,
@@ -652,6 +667,7 @@ And [附加验证点1]
652
667
  ```
653
668
 
654
669
  响应:
670
+
655
671
  ```json
656
672
  {
657
673
  "code": 0,
@@ -670,6 +686,7 @@ And [附加验证点1]
670
686
  ### GET /api/v1/order/detail/:id - 订单详情
671
687
 
672
688
  需要认证。
689
+
673
690
  ```
674
691
 
675
692
  ### 拆分原则
@@ -691,23 +708,25 @@ SDD 是**给子代理的最小可执行单元**:一个 SDD = 一个用户故
691
708
 
692
709
  ### 目标
693
710
 
694
- 把"页面+接口+数据"按**用户故事维度垂直切分**,生成子代理可直接执行、测试、交付的规格文档,适配 Superpowers/Trae-CN 的**子代理驱动开发**与**测试驱动开发**工作流。
711
+ 把"页面+接口+数据"按**用户故事维度垂直切分**,生成子代理可直接执行、测试、交付的规格文档,适配**子代理驱动开发**与**测试驱动开发**工作流。
695
712
 
696
713
  ### SDD 目录结构
697
714
 
698
715
  ```
716
+
699
717
  specs/
700
- story1-login/
701
- login-frontend.md
702
- login-backend.md
703
- story2-goods/
704
- goods-list-frontend.md
705
- goods-list-backend.md
706
- goods-detail-frontend.md
707
- goods-detail-backend.md
708
- story3-order/
709
- ...
710
- ```
718
+ story1-login/
719
+ login-frontend.md
720
+ login-backend.md
721
+ story2-goods/
722
+ goods-list-frontend.md
723
+ goods-list-backend.md
724
+ goods-detail-frontend.md
725
+ goods-detail-backend.md
726
+ story3-order/
727
+ ...
728
+
729
+ ````
711
730
 
712
731
  ### 单个 SDD 模板
713
732
 
@@ -779,7 +798,7 @@ specs/
779
798
  1. 遵循 TDD 流程:先写测试 → 再写代码 → 重构
780
799
  2. 完成后通过两阶段审查:spec合规性审查 → 代码质量审查
781
800
  3. 审查通过后提交,进入下一个子任务
782
- ```
801
+ ````
783
802
 
784
803
  ### 拆分原则
785
804
 
@@ -788,19 +807,19 @@ specs/
788
807
  - **依赖显式化**:所有依赖必须引用已固化的设计文档
789
808
  - **验收标准可测试**:采用 BDD 风格,输入输出明确,无模糊描述
790
809
 
791
- ---
810
+ ***
792
811
 
793
812
  ## 非功能需求处理指南
794
813
 
795
814
  ### 非功能需求分类与处理方式
796
815
 
797
- | 分类 | 示例 | 处理方式 | 优先级 |
798
- |------|------|----------|--------|
799
- | **性能** | 响应时间≤2秒,并发用户≥100 | 融入Story验收标准 | 高 |
800
- | **安全性** | 数据加密,权限控制,防SQL注入 | 融入DoD + 独立测试 | 最高 |
801
- | **可用性** | 系统可用性≥99.9% | 架构设计 | 高 |
802
- | **兼容性** | 适配iOS 14+,Android 10+ | 平台适配Story | 中 |
803
- | **可维护性** | 代码覆盖率≥80% | 融入DoD | 中 |
816
+ | 分类 | 示例 | 处理方式 | 优先级 |
817
+ | -------- | --------------------- | ------------ | --- |
818
+ | **性能** | 响应时间≤2秒,并发用户≥100 | 融入Story验收标准 | 高 |
819
+ | **安全性** | 数据加密,权限控制,防SQL注入 | 融入DoD + 独立测试 | 最高 |
820
+ | **可用性** | 系统可用性≥99.9% | 架构设计 | 高 |
821
+ | **兼容性** | 适配iOS 14+,Android 10+ | 平台适配Story | 中 |
822
+ | **可维护性** | 代码覆盖率≥80% | 融入DoD | 中 |
804
823
 
805
824
  ### 个人DoD(完成的定义)
806
825
 
@@ -828,16 +847,16 @@ specs/
828
847
  4. 兼容性:在所有目标平台显示一致
829
848
  ```
830
849
 
831
- ---
850
+ ***
832
851
 
833
852
  ## 故事估算方法指南
834
853
 
835
854
  ### 两种核心估算方法对比
836
855
 
837
- | 估算方法 | 定义 | 优点 | 缺点 | 适用场景 |
838
- |------|------|------|------|------|
839
- | **理想人天** | 无中断情况下完成任务的时间(人天) | 直观易懂,适合个人开发 | 受个人能力影响大 | 个人开发、小项目 |
840
- | **故事点** | 相对工作量单位,基于复杂度综合评估 | 不依赖个人能力,长期稳定 | 需要历史数据校准 | 长期项目 |
856
+ | 估算方法 | 定义 | 优点 | 缺点 | 适用场景 |
857
+ | -------- | ----------------- | ------------ | -------- | -------- |
858
+ | **理想人天** | 无中断情况下完成任务的时间(人天) | 直观易懂,适合个人开发 | 受个人能力影响大 | 个人开发、小项目 |
859
+ | **故事点** | 相对工作量单位,基于复杂度综合评估 | 不依赖个人能力,长期稳定 | 需要历史数据校准 | 长期项目 |
841
860
 
842
861
  ### 理想人天估算方法(推荐个人开发使用)
843
862
 
@@ -878,7 +897,7 @@ specs/
878
897
  3. **缓冲预留**:计划时预留30-50%缓冲时间应对突发情况
879
898
  4. **回顾校准**:每个迭代后回顾估算准确性,调整方法
880
899
 
881
- ---
900
+ ***
882
901
 
883
902
  ## 最终目录结构
884
903
 
@@ -902,9 +921,9 @@ specs/
902
921
  └── story3-order/
903
922
  ```
904
923
 
905
- ---
924
+ ***
906
925
 
907
- ## Superpowers / Trae-CN 操作指南
926
+ ## 操作指南
908
927
 
909
928
  1. 先完成 `docs/stories/user_stories.md`,确定**故事优先级**与**分批计划**
910
929
  2. 按批次完成 `docs/` 下设计文档(UI→架构→数据库→接口)
@@ -913,7 +932,7 @@ specs/
913
932
  5. 批次内所有 SDD 完成后,进行**集成测试**
914
933
  6. 验收通过后上线,进入下一批故事开发
915
934
 
916
- ---
935
+ ***
917
936
 
918
937
  ## 常见错误与修复
919
938
 
@@ -937,7 +956,7 @@ specs/
937
956
  - **问题**:功能完成后发现性能、安全等问题
938
957
  - **修复**:**将非功能需求融入DoD或Story验收标准**
939
958
 
940
- ---
959
+ ***
941
960
 
942
961
  ## 合理性、边界与适应场景
943
962
 
@@ -945,7 +964,7 @@ specs/
945
964
 
946
965
  - **敏捷+架构规范双需求**的项目(互联网产品、中后台系统)
947
966
  - **大型复杂需求**,需要同时保证快速交付与技术可控
948
- - **Superpowers/Trae-CN 环境**,需要适配子代理驱动开发与测试驱动开发
967
+ - **子代理驱动开发与测试驱动开发**环境
949
968
  - **个人开发**,流程轻量但规范
950
969
 
951
970
  ### 边界(固有约束)
@@ -959,97 +978,12 @@ specs/
959
978
  - **非Web系统**(移动端原生、IoT、强实时系统)
960
979
  - **纯瀑布项目**(要求全量设计完成后再开发)
961
980
 
962
- ---
981
+ ***
963
982
 
964
983
  ## 快速参考表
965
984
 
966
- | 步骤 | 产出文件 | 核心关注点 |
967
- |------|----------|------------|
968
- | 0 | docs/stories/user_stories.md | 用户价值、垂直切片 |
969
- | 1 | docs/ui/pages.md | 用户看到什么、操作什么 |
970
- | 2 | docs/architecture/frontend-backend.md | 前后端技术边界、权责划分 |
971
- | 3 | docs/database/schema.md + docs/api/contract.md | 数据结构、接口契约 |
972
- | 4 | specs/xxx/xxx.md | 独立功能规格、子代理任务 |
973
-
974
- ---
975
-
976
- ## 与 ui-sdd、sdd-add 的配置建议
977
-
978
- ### 三层架构定位
979
-
980
- | 技能 | 核心定位 | 层级 | 产出 |
981
- |------|---------|------|------|
982
- | **sdd** | 需求层·业务拆分 | 顶层 | docs/stories/、docs/ui/pages.md、docs/architecture/、docs/database/、docs/api/、specs/ |
983
- | **ui-sdd** | 架构层·UI交互 | 中层 | spec/ui/ 下完整 SDD(100%覆盖) |
984
- | **sdd-add** | 迭代层·快速迭代 | 底层 | docs/temp-requirements/ 下临时迭代 |
985
-
986
- ### 完整流程配置
987
-
988
- #### 项目从零启动(需求→UI→实现)
989
-
990
- 1. **先用 sdd**:拆 Epic→Feature→Story,写验收标准、做估算
991
- 2. **再用 ui-sdd**:对 Story 中的 UI/交互需求,按「App全域盘点清单」勾出所有页面/组件/规则,建完整 SDD
992
- 3. **交付开发**(或用 sdd-add 做快速实现)
993
-
994
- #### 正常迭代开发(日常新功能)
995
-
996
- 1. **先用 sdd**:把新功能拆成 Story,写验收标准
997
- 2. **再用 ui-sdd**:回「盘点清单」补勾,补建/更新 spec/ui/ 下的 SDD
998
- 3. **最后用 sdd-add**:做快速实现,需求文档中必须**引用 sdd 的 Story 和 ui-sdd 的 SDD**
999
-
1000
- #### 临时需求/紧急修复
1001
-
1002
- 1. **直接用 sdd-add**:快速澄清、优先级、实现
1003
- 2. **如果涉及 UI/新增页面**:必须同步回 ui-sdd:补勾、补建 SDD
1004
- 3. **如果涉及 Story 拆分**:必须同步回 sdd:补 Story
1005
-
1006
- ### 文档关联引用规范
1007
-
1008
- #### sdd Story 中引用 ui-sdd
1009
-
1010
- 在 sdd 产出的 Story 文档中加入:
1011
-
1012
- ```markdown
1013
- ## 关联文档
1014
-
1015
- - 对应UI交互SDD:spec/ui/pages/xxx-page.sdd.md
1016
- - 复用组件SDD:spec/ui/common/ui-yyy.sdd.md
1017
- - 相关弹窗SDD:spec/ui/dialog/zzz-dialog.sdd.md
1018
- ```
1019
-
1020
- #### ui-sdd SDD 中引用 sdd Story
1021
-
1022
- 在 ui-sdd 产出的页面/组件SDD中加入:
1023
-
1024
- ```markdown
1025
- ## 关联用户故事
1026
-
1027
- - 主故事:US-001(在 docs/stories/user_stories.md)
1028
- - 相关故事:US-002、US-003
1029
- ```
1030
-
1031
- #### sdd-add 临时需求中引用前两者
1032
-
1033
- 在 sdd-add 产出的临时需求文档中加入:
1034
-
1035
- ```markdown
1036
- ## 关联文档
1037
-
1038
- - 关联Story:docs/stories/user_stories.md 中的 US-xxx
1039
- - 关联UI-SDD:spec/ui/pages/yyy-page.sdd.md
1040
- ```
1041
-
1042
- ### 高频场景决策表
1043
-
1044
- | 场景 | 第1步用 | 第2步用 | 第3步用 |
1045
- |------|---------|---------|---------|
1046
- | 新项目从零开始 | sdd(需求拆分) | ui-sdd(UI设计) | 开发 |
1047
- | 新增完整Story | sdd(Story拆分) | ui-sdd(补SDD) | 开发 |
1048
- | 临时小功能 | sdd-add(快速处理) | ui-sdd(可选,需UI) | 开发 |
1049
- | 新增复杂Epic | sdd(Epic拆分) | ui-sdd(批量建SDD) | 分批开发 |
1050
- | 临时小bug修复 | sdd-add | 无需 | 快速修复 |
1051
- | 优化现有交互 | sdd(更新Story) | ui-sdd(更新SDD) | sdd-add(实现) |
1052
-
1053
- ### 一句话原则
985
+ | 步骤 | 产出文件 | 核心关注点 |
986
+ | -- | ----------------------------- | --------- |
987
+ | 0 | docs/stories/user\_stories.md | 用户价值、垂直切片 |
988
+ | 1 | docs/ui/pages.md | <br /> |
1054
989
 
1055
- **「sdd 定方向(做什么),ui-sdd 定样子(怎么做),sdd-add 填细节(快速补);从上往下拆,从下往上补,互相引用不遗漏」**
@@ -1,4 +1,8 @@
1
- 【claude code调用标识:sdd-add】【trae调用标识:sdd-add+临时功能落地】【流程场景:开发执行阶段·个人快速开发】
1
+ ---
2
+ name: sdd-add
3
+ description: Use when implementing small features or quick iterations with minimal SDD documentation
4
+ ---
5
+
2
6
 
3
7
  ---
4
8
  name: sdd-add
@@ -1,4 +1,8 @@
1
- 【claude code调用标识:sdd-code】【trae调用标识:sdd-code+功能实现SDD拆分】【流程场景:设计规划阶段·实现设计】
1
+ ---
2
+ name: sdd-code
3
+ description: Use when designing code implementation details, coding standards, and technical debt management
4
+ ---
5
+
2
6
 
3
7
  ---
4
8
  name: "sdd-code"
@@ -1,4 +1,8 @@
1
- 【claude code调用标识:sdd-deploy】【trae调用标识:sdd-deploy+部署SDD拆分】【流程场景:1.完整3阶段SDD流程、5.代码发布】
1
+ ---
2
+ name: sdd-deploy
3
+ description: Use when designing deployment architecture, release processes, and rollback plans
4
+ ---
5
+
2
6
 
3
7
  ---
4
8
  name: "sdd-deploy"
@@ -1,21 +1,8 @@
1
- 【claude code调用标识:sdd-full-flow】【trae调用标识:sdd-full-flow+全流程开发】【流程场景:快速启动开发流程】
2
-
3
1
  ---
4
2
  name: sdd-full-flow
5
- description: "简化版全流程入口,适合快速启动开发。完整智能调度请使用Orchestrator Agent"
3
+ description: Use when starting development and need to choose between full SDD flow, new project, feature iteration, bug fix, or release
6
4
  ---
7
5
 
8
- &lt;TRIGGER-WORDS&gt;
9
- - 启动开发流程
10
- - 开始开发
11
- - 快速开始
12
- - 快速启动
13
- &lt;/TRIGGER-WORDS&gt;
14
-
15
- &lt;SUBAGENT-STOP&gt;
16
- 如果您被派作为子代理执行特定任务,请跳过此技能。
17
- &lt;/SUBAGENT-STOP&gt;
18
-
19
6
  # SDD全流程开发(简化版入口)
20
7
 
21
8
  ## 📌 定位说明
@@ -451,7 +438,7 @@ description: "简化版全流程入口,适合快速启动开发。完整智能
451
438
 
452
439
  ---
453
440
 
454
- #### 阶段 2:SDD拆分阶段(Split Phase)
441
+ ### 阶段 2:SDD拆分阶段(Split Phase)
455
442
 
456
443
  **目标**:从需求到可执行规格,完成全链路设计
457
444
 
@@ -890,5 +877,4 @@ MVP验证阶段已完成!
890
877
 
891
878
  ---
892
879
 
893
- **一句话总结**:阶段1做产品(市场→竞品→用户调研→头脑风暴→PRD)→ 阶段2做设计(SDD全系列拆分,含 ui-sdd,含安全测试)→ 阶段2.5做MVP验证(最小开发→用户介入测试→迭代→确认)→ 阶段3做开发(从 writing-plans 开始 → TDD+分支流程+安全审计)→ 每个阶段结束后询问是否继续!
894
-
880
+ **一句话总结**:阶段1做产品(市场→竞品→用户调研→头脑风暴→PRD)→ 阶段2做设计(SDD全系列拆分,含 ui-sdd,含安全测试)→ 阶段2.5做MVP验证(最小开发→用户介入测试→迭代→确认)→ 阶段3做开发(从 writing-plans 开始 → TDD+分支流程+安全审计)→ 每个阶段结束后询问是否继续!
@@ -1,4 +1,8 @@
1
- 【claude code调用标识:sdd-test】【trae调用标识:sdd-test+测试SDD拆分】【流程场景:设计规划阶段·测试设计】
1
+ ---
2
+ name: sdd-test
3
+ description: Use when designing test strategies, test cases, and test coverage requirements
4
+ ---
5
+
2
6
 
3
7
  ---
4
8
  name: "sdd-test"
@@ -1,4 +1,8 @@
1
- 【claude code调用标识:security-audit】【trae调用标识:security-audit+安全审计】【流程场景:1.完整3阶段SDD流程、5.代码发布】
1
+ ---
2
+ name: security-audit
3
+ description: Use when conducting security audits and vulnerability scanning
4
+ ---
5
+
2
6
 
3
7
  ---
4
8
  name: "security-audit"
@@ -1,4 +1,8 @@
1
- 【claude code调用标识:systematic-debugging】【trae调用标识:systematic-debugging+系统性调试】【流程场景:4.Bug处理】
1
+ ---
2
+ name: systematic-debugging
3
+ description: Use when systematically debugging and locating bugs
4
+ ---
5
+
2
6
 
3
7
  ---
4
8
  name: systematic-debugging
@@ -1,4 +1,3 @@
1
- 【claude code调用标识:API-SDD】【trae调用标识:API-SDD+sdd】【流程场景:1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代】
2
1
 
3
2
  # API-SDD:[接口模块名称](skill选项式设计)
4
3
 
@@ -25,7 +24,9 @@
25
24
  - 选项2:编码方式 → 选项:UTF-8/GBK → 自定义编码:__________
26
25
  - 选项3:超时时间 → 选项:5秒/10秒/30秒 → 自定义超时:__________
27
26
 
28
- ## trae调用参数说明(仅trae触发时使用)
27
+ <!-- Trae-only: trae调用参数说明 -->
28
+
29
29
  - 调用路径:skills/templates/API-SDD.md
30
30
  - 必传参数:接口模块名称、API路径、请求方法
31
- - 可选参数:认证方式、返回值说明补充内容
31
+ - 可选参数:认证方式、返回值说明补充内容
32
+ <!-- End Trae-only -->
@@ -1,4 +1,3 @@
1
- 【claude code调用标识:Andrej Karpathy AI编码规则落地SDD】【trae调用标识:Andrej Karpathy AI编码规则落地SDD+编码规范】【流程场景:1.完整3阶段SDD流程、3.小型功能迭代】
2
1
 
3
2
  # Andrej Karpathy AI编码规则落地SDD:[项目名称]
4
3
 
@@ -1,4 +1,3 @@
1
- 【claude code调用标识:BDD风格验收标准SDD】【trae调用标识:BDD风格验收标准SDD+验收规范】【流程场景:1.完整3阶段SDD流程、3.小型功能迭代、4.Bug处理】
2
1
 
3
2
  # BDD风格验收标准SDD:[需求名称]
4
3