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.
- package/.claude/SDD_ORCHESTRATOR_PROMPT.md +301 -0
- package/.claude/agents/orchestrator.md +83 -124
- package/.claude/commands/bug.md +2 -5
- package/.claude/commands/dev.md +2 -5
- package/.claude/commands/env.md +2 -5
- package/.claude/commands/flow.md +4 -8
- package/.claude/commands/full.md +2 -5
- package/.claude/commands/git.md +1 -4
- package/.claude/commands/release.md +2 -5
- package/.claude/commands/review.md +2 -5
- package/.claude/commands/save.md +2 -5
- package/.claude/commands/sdd.md +2 -5
- package/.claude/commands/ui.md +2 -5
- package/.claude/rules/project_rules.md +21 -17
- package/.claude/rules/trae-rules.md +50 -0
- package/.claude/settings.json +40 -0
- package/.claude/skills/README.md +31 -11
- package/.claude/skills/ai-coding-rules/SKILL.md +5 -1
- package/.claude/skills/bdd-acceptance/SKILL.md +5 -1
- package/.claude/skills/brainstorming/SKILL.md +5 -1
- package/.claude/skills/bug-reproduction-confirm/SKILL.md +5 -1
- package/.claude/skills/claudeception/SKILL.md +28 -53
- package/.claude/skills/competitive-brief/SKILL.md +5 -1
- package/.claude/skills/design-to-code/SKILL.md +5 -1
- package/.claude/skills/env-check/SKILL.md +5 -1
- package/.claude/skills/finishing-a-development-branch/SKILL.md +5 -1
- package/.claude/skills/flutter-add-integration-test/SKILL.md +5 -1
- package/.claude/skills/flutter-add-widget-preview/SKILL.md +5 -1
- package/.claude/skills/flutter-add-widget-test/SKILL.md +5 -1
- package/.claude/skills/flutter-apply-architecture-best-practices/SKILL.md +5 -1
- package/.claude/skills/flutter-build-responsive-layout/SKILL.md +5 -1
- package/.claude/skills/flutter-errors/SKILL.md +5 -1
- package/.claude/skills/flutter-fix-layout-issues/SKILL.md +5 -1
- package/.claude/skills/flutter-implement-json-serialization/SKILL.md +5 -1
- package/.claude/skills/flutter-setup-declarative-routing/SKILL.md +5 -1
- package/.claude/skills/flutter-setup-localization/SKILL.md +5 -1
- package/.claude/skills/flutter-test/SKILL.md +5 -1
- package/.claude/skills/flutter-use-http-package/SKILL.md +5 -1
- package/.claude/skills/ios-full-auto-debug/SKILL.md +5 -1
- package/.claude/skills/market-research/SKILL.md +5 -1
- package/.claude/skills/performance-optimize/SKILL.md +5 -1
- package/.claude/skills/prd-write/SKILL.md +5 -1
- package/.claude/skills/quality-gate/SKILL.md +5 -1
- package/.claude/skills/receiving-code-review/SKILL.md +5 -1
- package/.claude/skills/release-flow/SKILL.md +5 -1
- package/.claude/skills/requesting-code-review/SKILL.md +5 -1
- package/.claude/skills/requirement-completion-officer/SKILL.md +5 -1
- package/.claude/skills/role-roundtable-review/SKILL.md +5 -1
- package/.claude/skills/sdd/SKILL.md +97 -163
- package/.claude/skills/sdd-add/SKILL.md +5 -1
- package/.claude/skills/sdd-code/SKILL.md +5 -1
- package/.claude/skills/sdd-deploy/SKILL.md +5 -1
- package/.claude/skills/sdd-full/SKILL.md +3 -17
- package/.claude/skills/sdd-test/SKILL.md +5 -1
- package/.claude/skills/security-audit/SKILL.md +5 -1
- package/.claude/skills/systematic-debugging/SKILL.md +5 -1
- package/.claude/skills/templates/API-SDD.md +4 -3
- 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
- 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
- package/.claude/skills/templates/Base-SDD.md +4 -3
- package/.claude/skills/templates/Brain-SDD.md +4 -3
- package/.claude/skills/templates/BugReproduction-SDD.md +4 -2
- package/.claude/skills/templates/Code-SDD.md +4 -3
- package/.claude/skills/templates/Competitor-SDD.md +4 -3
- package/.claude/skills/templates/Env-SDD.md +4 -3
- 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
- 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
- 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
- package/.claude/skills/templates/Flutter/351/237/263/350/247/206/351/242/221/345/205/250/346/240/210SDD.md +0 -1
- package/.claude/skills/templates/PRD-SDD.md +4 -3
- package/.claude/skills/templates/Performance-SDD.md +4 -2
- package/.claude/skills/templates/SKILL.md +5 -1
- package/.claude/skills/templates/Test-SDD.md +4 -3
- package/.claude/skills/templates/UI-SDD.md +4 -3
- package/.claude/skills/templates/UI-SDD/344/270/223/347/224/250/346/250/241/346/235/277.md +0 -1
- 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
- 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
- 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
- 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
- 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
- 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
- package/.claude/skills/test-driven-development/SKILL.md +5 -1
- package/.claude/skills/ui-motion-interaction-standard/SKILL.md +5 -1
- package/.claude/skills/ui-sdd/SKILL.md +5 -1
- package/.claude/skills/verification-before-completion/SKILL.md +5 -1
- package/.claude/skills/writing-plans/SKILL.md +5 -1
- package/bin.js +123 -29
- package/package.json +1 -1
- package/.claude/commands/debug.md +0 -21
- package/.claude/commands/iter.md +0 -22
- package/.claude/commands/new.md +0 -25
- package/.claude/skills/mempalace-auto-saver/SKILL.md +0 -302
- package/README.md +0 -94
|
@@ -1,9 +1,8 @@
|
|
|
1
|
-
|
|
1
|
+
***
|
|
2
2
|
|
|
3
|
-
---
|
|
4
3
|
name: sdd
|
|
5
|
-
description:
|
|
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
|
|
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
|
-
| 分批交付
|
|
94
|
-
| 并行开发
|
|
95
|
-
| 契约版本化 | 每批故事对应一个契约版本,变更只影响当前批次
|
|
96
|
-
| 子代理适配 | 每个SDD对应一个子代理任务,完成后自动审查
|
|
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
|
-
| **按平台适配拆分**
|
|
148
|
-
| **按复杂度分层拆分** | 功能复杂度差异大的功能
|
|
149
|
-
| **按时间阶段拆分**
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
把"页面+接口+数据"
|
|
711
|
+
把"页面+接口+数据"按**用户故事维度垂直切分**,生成子代理可直接执行、测试、交付的规格文档,适配**子代理驱动开发**与**测试驱动开发**工作流。
|
|
695
712
|
|
|
696
713
|
### SDD 目录结构
|
|
697
714
|
|
|
698
715
|
```
|
|
716
|
+
|
|
699
717
|
specs/
|
|
700
|
-
|
|
701
|
-
|
|
702
|
-
|
|
703
|
-
|
|
704
|
-
|
|
705
|
-
|
|
706
|
-
|
|
707
|
-
|
|
708
|
-
|
|
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
|
-
| **性能**
|
|
800
|
-
| **安全性**
|
|
801
|
-
| **可用性**
|
|
802
|
-
| **兼容性**
|
|
803
|
-
| **可维护性** | 代码覆盖率≥80%
|
|
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
|
-
##
|
|
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
|
-
-
|
|
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
|
|
969
|
-
| 1
|
|
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,21 +1,8 @@
|
|
|
1
|
-
【claude code调用标识:sdd-full-flow】【trae调用标识:sdd-full-flow+全流程开发】【流程场景:快速启动开发流程】
|
|
2
|
-
|
|
3
1
|
---
|
|
4
2
|
name: sdd-full-flow
|
|
5
|
-
description:
|
|
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
|
-
<TRIGGER-WORDS>
|
|
9
|
-
- 启动开发流程
|
|
10
|
-
- 开始开发
|
|
11
|
-
- 快速开始
|
|
12
|
-
- 快速启动
|
|
13
|
-
</TRIGGER-WORDS>
|
|
14
|
-
|
|
15
|
-
<SUBAGENT-STOP>
|
|
16
|
-
如果您被派作为子代理执行特定任务,请跳过此技能。
|
|
17
|
-
</SUBAGENT-STOP>
|
|
18
|
-
|
|
19
6
|
# SDD全流程开发(简化版入口)
|
|
20
7
|
|
|
21
8
|
## 📌 定位说明
|
|
@@ -451,7 +438,7 @@ description: "简化版全流程入口,适合快速启动开发。完整智能
|
|
|
451
438
|
|
|
452
439
|
---
|
|
453
440
|
|
|
454
|
-
|
|
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,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
|
-
|
|
27
|
+
<!-- Trae-only: trae调用参数说明 -->
|
|
28
|
+
|
|
29
29
|
- 调用路径:skills/templates/API-SDD.md
|
|
30
30
|
- 必传参数:接口模块名称、API路径、请求方法
|
|
31
|
-
- 可选参数:认证方式、返回值说明补充内容
|
|
31
|
+
- 可选参数:认证方式、返回值说明补充内容
|
|
32
|
+
<!-- End Trae-only -->
|