sdd-full 2.2.0 → 3.0.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.
- package/package.json +1 -1
- package/skills/rules/project_rules.md +167 -0
- package/skills/rules/user_rules.md +223 -0
- 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
- 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
- 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
- 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
- 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
- package/skills/templates/Flutter/351/237/263/350/247/206/351/242/221/345/205/250/346/240/210SDD.md +121 -0
- package/skills/templates/UI-SDD/344/270/223/347/224/250/346/250/241/346/235/277.md +141 -0
- 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
- package/skills/templates//345/212/237/350/203/275SDD/344/270/223/347/224/250/346/250/241/346/235/277.md +132 -0
- 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
- 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
- package/skills//346/212/200/350/203/275/345/206/263/347/255/226/346/240/221.md +16 -0
package/package.json
CHANGED
|
@@ -0,0 +1,167 @@
|
|
|
1
|
+
# 项目规则 - SDD全流程开发技能体系(团队共享)
|
|
2
|
+
|
|
3
|
+
## 一、项目概述
|
|
4
|
+
|
|
5
|
+
本项目是一个完整的SDD(Software Design Document)全流程开发技能包,包含从需求分析到发布运维的全流程技能,支持Trae和Claude Code双调用机制。
|
|
6
|
+
|
|
7
|
+
## 二、核心流程规范
|
|
8
|
+
|
|
9
|
+
### 2.1 新项目开发流程
|
|
10
|
+
```
|
|
11
|
+
需求收集 → 头脑风暴 → 市场调研 → PRD编写 → SDD拆分 → UI设计 → 代码设计 → 测试设计 → 开发 → 测试 → 质量检查 → 发布 → 复盘
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
### 2.2 Bug修复流程
|
|
15
|
+
```
|
|
16
|
+
问题定位 → Test-SDD补充回归用例 → 代码修复 → 验证 → 质量检查 → 经验沉淀
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
### 2.3 小型功能迭代流程
|
|
20
|
+
```
|
|
21
|
+
需求澄清 → SDD快速拆分 → 开发 → 验证 → 质量检查 → 发布
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
## 三、技能使用规范
|
|
25
|
+
|
|
26
|
+
### 3.1 技能分类与职责
|
|
27
|
+
| 分类 | 技能 | 职责描述 |
|
|
28
|
+
|------|------|---------|
|
|
29
|
+
| 需求分析 | brainstorming, market-research, competitive-brief, prd-write, requirement-completion-officer, sdd, sdd-full | 需求收集、分析、拆分 |
|
|
30
|
+
| 设计规划 | ui-sdd, sdd-code, sdd-test, sdd-deploy, sdd-ops, writing-plans | 设计方案制定 |
|
|
31
|
+
| 开发执行 | sdd-add, test-driven-development, systematic-debugging, verification-before-completion | 代码实现 |
|
|
32
|
+
| 质量保障 | quality-gate, security-audit | 质量把关 |
|
|
33
|
+
| 发布运维 | finishing-a-development-branch, release-flow | 发布管理 |
|
|
34
|
+
| 知识沉淀 | claudeception, mempalace-auto-saver | 经验积累 |
|
|
35
|
+
|
|
36
|
+
### 3.2 强制使用技能
|
|
37
|
+
- ✅ **所有发布前必须通过 quality-gate**
|
|
38
|
+
- ✅ **所有需求必须经过 sdd/sdd-full 拆分**
|
|
39
|
+
- ✅ **所有Bug修复必须经过 systematic-debugging**
|
|
40
|
+
- ✅ **发布后必须进行 claudeception 经验沉淀**
|
|
41
|
+
|
|
42
|
+
## 四、文档规范
|
|
43
|
+
|
|
44
|
+
### 4.1 SDD模板规范
|
|
45
|
+
项目使用9种标准化SDD模板:
|
|
46
|
+
1. **Base-SDD** - 全局通用基线规范
|
|
47
|
+
2. **Brain-SDD** - 头脑风暴文档
|
|
48
|
+
3. **Competitor-SDD** - 竞品分析文档
|
|
49
|
+
4. **PRD-SDD** - 产品需求文档
|
|
50
|
+
5. **UI-SDD** - UI设计文档
|
|
51
|
+
6. **Code-SDD** - 代码实现文档
|
|
52
|
+
7. **API-SDD** - 接口设计文档
|
|
53
|
+
8. **Env-SDD** - 环境配置文档
|
|
54
|
+
9. **Test-SDD** - 测试设计文档
|
|
55
|
+
|
|
56
|
+
### 4.2 文档命名规范
|
|
57
|
+
```
|
|
58
|
+
{项目名称}-{模板名称}-{版本}.md
|
|
59
|
+
示例:个人备忘录APP-Base-SDD-v1.0.md
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
### 4.3 文档归档规范
|
|
63
|
+
```
|
|
64
|
+
docs/
|
|
65
|
+
├── specs/ # SDD规范文档
|
|
66
|
+
│ ├── ui/ # UI-SDD
|
|
67
|
+
│ ├── function-implementation-sdd/ # Code-SDD
|
|
68
|
+
│ └── test/ # Test-SDD
|
|
69
|
+
├── stories/ # 用户故事
|
|
70
|
+
├── architecture/ # 架构文档
|
|
71
|
+
├── database/ # 数据库设计
|
|
72
|
+
├── api/ # API契约
|
|
73
|
+
└── deploy/ # 部署文档
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
## 五、质量标准
|
|
77
|
+
|
|
78
|
+
### 5.1 代码质量标准
|
|
79
|
+
- 单元测试覆盖率 ≥ 80%
|
|
80
|
+
- 代码审查必须通过
|
|
81
|
+
- 无 P0/P1 级别 Bug
|
|
82
|
+
|
|
83
|
+
### 5.2 文档质量标准
|
|
84
|
+
- 所有SDD模板必须完整填写
|
|
85
|
+
- 文档版本管理规范
|
|
86
|
+
- 文档与代码同步更新
|
|
87
|
+
|
|
88
|
+
### 5.3 发布标准
|
|
89
|
+
- 所有测试用例通过
|
|
90
|
+
- quality-gate 检查通过
|
|
91
|
+
- security-audit 无高危漏洞
|
|
92
|
+
|
|
93
|
+
## 六、协作规范
|
|
94
|
+
|
|
95
|
+
### 6.1 分支管理
|
|
96
|
+
- `main` - 主分支,稳定版本
|
|
97
|
+
- `develop` - 开发分支
|
|
98
|
+
- `feature/*` - 功能分支
|
|
99
|
+
- `bugfix/*` - Bug修复分支
|
|
100
|
+
- `release/*` - 发布分支
|
|
101
|
+
|
|
102
|
+
### 6.2 代码审查流程
|
|
103
|
+
1. 功能开发完成后提交 PR
|
|
104
|
+
2. 触发 requesting-code-review
|
|
105
|
+
3. 审查通过后触发 receiving-code-review
|
|
106
|
+
4. 合并到 develop 分支
|
|
107
|
+
|
|
108
|
+
### 6.3 沟通规范
|
|
109
|
+
- 使用明确的技能触发关键词
|
|
110
|
+
- 及时更新状态
|
|
111
|
+
- 遇到问题及时反馈
|
|
112
|
+
|
|
113
|
+
## 七、调用机制规范
|
|
114
|
+
|
|
115
|
+
### 7.1 Trae调用格式
|
|
116
|
+
```
|
|
117
|
+
trae调用 模板名称 项目名称=XXX 阶段=XXX 流程场景=XXX
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
### 7.2 Claude Code调用格式
|
|
121
|
+
```
|
|
122
|
+
调用 技能名称 参数
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
### 7.3 流程场景参数
|
|
126
|
+
| 参数值 | 说明 |
|
|
127
|
+
|--------|------|
|
|
128
|
+
| 完整3阶段SDD流程 | 大型项目完整流程 |
|
|
129
|
+
| 从零开始新项目 | 新项目立项 |
|
|
130
|
+
| 小型功能迭代 | 快速迭代 |
|
|
131
|
+
| Bug处理 | Bug修复 |
|
|
132
|
+
| 代码发布 | 版本发布 |
|
|
133
|
+
|
|
134
|
+
## 八、工具与环境
|
|
135
|
+
|
|
136
|
+
### 8.1 推荐工具
|
|
137
|
+
- **Figma** - UI设计
|
|
138
|
+
- **GitHub** - 代码托管
|
|
139
|
+
- **Trae** - 技能调用
|
|
140
|
+
- **Claude Code** - AI协作
|
|
141
|
+
|
|
142
|
+
### 8.2 环境要求
|
|
143
|
+
- Node.js ≥ 18.x
|
|
144
|
+
- npm ≥ 9.x
|
|
145
|
+
- sdd-full ≥ 2.2.0
|
|
146
|
+
|
|
147
|
+
## 九、版本管理
|
|
148
|
+
|
|
149
|
+
### 9.1 版本命名规范
|
|
150
|
+
```
|
|
151
|
+
v{主版本}.{次版本}.{修订版本}
|
|
152
|
+
示例:v2.2.0
|
|
153
|
+
```
|
|
154
|
+
|
|
155
|
+
### 9.2 版本发布流程
|
|
156
|
+
1. 完成功能开发与测试
|
|
157
|
+
2. 更新版本号
|
|
158
|
+
3. 通过 quality-gate
|
|
159
|
+
4. 执行 release-flow
|
|
160
|
+
5. 发布到 npm
|
|
161
|
+
|
|
162
|
+
---
|
|
163
|
+
|
|
164
|
+
**版本**: v1.0
|
|
165
|
+
**更新时间**: 2026-05-06
|
|
166
|
+
**适用项目**: sdd-full-npm
|
|
167
|
+
**团队**: SDD开发团队
|
|
@@ -0,0 +1,223 @@
|
|
|
1
|
+
# 个人规则 - SDD全流程开发技能体系
|
|
2
|
+
|
|
3
|
+
## 一、技能地图
|
|
4
|
+
|
|
5
|
+
### 需求分析类
|
|
6
|
+
| 技能名称 | 触发关键词 | 适用场景 |
|
|
7
|
+
|---------|-----------|---------|
|
|
8
|
+
| brainstorming | 头脑风暴、创意、想法、需求发散 | 项目初期、需求不确定时 |
|
|
9
|
+
| market-research | 市场调研、竞品分析、用户需求 | 了解竞品、市场情况 |
|
|
10
|
+
| competitive-brief | 竞品简报、竞品对比 | 分析竞品差异 |
|
|
11
|
+
| prd-write | 写PRD、产品需求文档 | 新项目立项、需求定义 |
|
|
12
|
+
| requirement-completion-officer | 需求补全、需求澄清 | 需求不明确时 |
|
|
13
|
+
| sdd | SDD拆分、需求拆分 | 大型需求结构化拆分 |
|
|
14
|
+
| sdd-full | 完整SDD流程、全流程 | 需要完整SDD流程 |
|
|
15
|
+
|
|
16
|
+
### 设计规划类
|
|
17
|
+
| 技能名称 | 触发关键词 | 适用场景 |
|
|
18
|
+
|---------|-----------|---------|
|
|
19
|
+
| ui-sdd | UI设计、界面设计、交互设计 | UI设计阶段 |
|
|
20
|
+
| sdd-code | 代码设计、实现方案、技术方案 | 功能实现设计 |
|
|
21
|
+
| sdd-test | 测试设计、测试方案 | 测试设计阶段 |
|
|
22
|
+
| sdd-deploy | 部署设计、发布方案 | 部署设计阶段 |
|
|
23
|
+
| sdd-ops | 运维设计、监控方案 | 运维设计阶段 |
|
|
24
|
+
| writing-plans | 制定计划、开发计划 | 需要制定详细计划 |
|
|
25
|
+
|
|
26
|
+
### 开发执行类
|
|
27
|
+
| 技能名称 | 触发关键词 | 适用场景 |
|
|
28
|
+
|---------|-----------|---------|
|
|
29
|
+
| sdd-add | 快速开发、小功能、临时需求 | 快速迭代、小型功能 |
|
|
30
|
+
| test-driven-development | TDD、测试驱动、先写测试 | TDD开发模式 |
|
|
31
|
+
| systematic-debugging | 调试、Bug排查、问题定位 | 调试Bug时 |
|
|
32
|
+
| verification-before-completion | 验证、代码检查、提交前检查 | 提交/发布前验证 |
|
|
33
|
+
|
|
34
|
+
### 质量保障类
|
|
35
|
+
| 技能名称 | 触发关键词 | 适用场景 |
|
|
36
|
+
|---------|-----------|---------|
|
|
37
|
+
| quality-gate | 质量检查、门禁、发布检查 | 发布前质量把关 |
|
|
38
|
+
| security-audit | 安全检查、安全审计 | 安全漏洞检查 |
|
|
39
|
+
|
|
40
|
+
### 发布运维类
|
|
41
|
+
| 技能名称 | 触发关键词 | 适用场景 |
|
|
42
|
+
|---------|-----------|---------|
|
|
43
|
+
| finishing-a-development-branch | 完成分支、合并分支 | 合并开发分支前 |
|
|
44
|
+
| release-flow | 发布流程、版本发布 | 完整发布生命周期 |
|
|
45
|
+
|
|
46
|
+
### 知识沉淀类
|
|
47
|
+
| 技能名称 | 触发关键词 | 适用场景 |
|
|
48
|
+
|---------|-----------|---------|
|
|
49
|
+
| claudeception | 提取技能、保存经验、持续学习 | 沉淀可复用知识 |
|
|
50
|
+
| mempalace-auto-saver | 保存记忆、自动存档 | 自动保存会话记忆 |
|
|
51
|
+
|
|
52
|
+
### 专项工具类
|
|
53
|
+
| 技能名称 | 触发关键词 | 适用场景 |
|
|
54
|
+
|---------|-----------|---------|
|
|
55
|
+
| using-superpowers | 全流程、自动化流程 | 使用Superpowers全流程 |
|
|
56
|
+
| requesting-code-review | 请求审查、代码审查 | 需要代码审查 |
|
|
57
|
+
| receiving-code-review | 接收审查、处理审查意见 | 处理代码审查反馈 |
|
|
58
|
+
|
|
59
|
+
---
|
|
60
|
+
|
|
61
|
+
## 二、调用决策树
|
|
62
|
+
|
|
63
|
+
### 问题1:我现在要做什么?
|
|
64
|
+
|
|
65
|
+
#### 选项A:我有一个新项目,从零开始
|
|
66
|
+
→ 子问题:需要先创意/调研吗?
|
|
67
|
+
→ → 是:**brainstorming** / **market-research** / **competitive-brief**
|
|
68
|
+
→ → 否:跳过
|
|
69
|
+
→ 然后:**prd-write**(写PRD,可选)→ **sdd**(拆需求)或 **sdd-full**(完整SDD流程)
|
|
70
|
+
→ 然后到「选项E:我要设计/开发了」
|
|
71
|
+
|
|
72
|
+
#### 选项B:我要做新功能/大需求
|
|
73
|
+
→ **sdd**(基础SDD拆分)或 **sdd-full**(完整SDD流程)→ 到「选项E:我要设计/开发了」
|
|
74
|
+
|
|
75
|
+
#### 选项C:我要做小功能迭代/Bug修复
|
|
76
|
+
→ 子问题:需求是否明确?
|
|
77
|
+
→ → 否:**requirement-completion-officer**(需求补全)
|
|
78
|
+
→ → 是:跳过
|
|
79
|
+
→ **sdd-add**(快速落地)
|
|
80
|
+
→ 如果需要UI:补充调用 **ui-sdd**
|
|
81
|
+
→ 如果需要调试:**systematic-debugging**
|
|
82
|
+
→ 如果需要制定计划:**writing-plans**
|
|
83
|
+
|
|
84
|
+
#### 选项D:我要发布代码
|
|
85
|
+
→ 子问题:质量检查做了吗?
|
|
86
|
+
→ → 否:**quality-gate**(先做质量检查)
|
|
87
|
+
→ → 是:继续
|
|
88
|
+
→ 子问题:是否完成开发分支?
|
|
89
|
+
→ → 是:**finishing-a-development-branch**
|
|
90
|
+
→ → 否:跳过
|
|
91
|
+
→ **sdd-deploy**(部署设计,可选)→ **release-flow**(发布管理)
|
|
92
|
+
|
|
93
|
+
#### 选项E:我要设计/开发了
|
|
94
|
+
→ 子问题1:需要UI设计吗?
|
|
95
|
+
→ → 是:**ui-sdd**
|
|
96
|
+
→ → 否:跳过
|
|
97
|
+
→ 子问题2:需要拆实现SDD吗?
|
|
98
|
+
→ → 是:**sdd-code**(含代码规范、技术债务、重构计划)
|
|
99
|
+
→ → 否:跳过
|
|
100
|
+
→ 子问题3:需要设计测试吗?
|
|
101
|
+
→ → 是:**sdd-test**
|
|
102
|
+
→ → 否:跳过
|
|
103
|
+
→ 子问题4:需要设计部署吗?
|
|
104
|
+
→ → 是:**sdd-deploy**
|
|
105
|
+
→ → 否:跳过
|
|
106
|
+
→ 子问题5:需要设计运维吗?
|
|
107
|
+
→ → 是:**sdd-ops**
|
|
108
|
+
→ → 否:跳过
|
|
109
|
+
→ 然后开始开发(sdd-add/test-driven-development/等)
|
|
110
|
+
|
|
111
|
+
#### 选项F:我要调试问题
|
|
112
|
+
→ **systematic-debugging**
|
|
113
|
+
|
|
114
|
+
#### 选项G:我要做测试
|
|
115
|
+
→ **sdd-test**(设计测试)→ **test-driven-development**(TDD开发)
|
|
116
|
+
|
|
117
|
+
#### 选项H:我要做竞品分析
|
|
118
|
+
→ **competitive-brief** / **market-research**
|
|
119
|
+
|
|
120
|
+
#### 选项I:我要安全检查
|
|
121
|
+
→ **security-audit**
|
|
122
|
+
|
|
123
|
+
#### 选项J:我要保存/提取经验
|
|
124
|
+
→ **claudeception** / **mempalace-auto-saver**
|
|
125
|
+
|
|
126
|
+
---
|
|
127
|
+
|
|
128
|
+
## 三、快捷触发关键词
|
|
129
|
+
|
|
130
|
+
### 新项目快速启动
|
|
131
|
+
- `/new` 或 `新项目` → 触发新项目流程(brainstorming → prd-write → sdd)
|
|
132
|
+
- `/brain` 或 `头脑风暴` → 触发 brainstorming
|
|
133
|
+
- `/prd` 或 `写PRD` → 触发 prd-write
|
|
134
|
+
|
|
135
|
+
### 开发快捷命令
|
|
136
|
+
- `/dev` 或 `开发` → 触发 sdd-add
|
|
137
|
+
- `/tdd` 或 `测试驱动` → 触发 test-driven-development
|
|
138
|
+
- `/debug` 或 `调试` → 触发 systematic-debugging
|
|
139
|
+
|
|
140
|
+
### 质量与发布
|
|
141
|
+
- `/quality` 或 `质量检查` → 触发 quality-gate
|
|
142
|
+
- `/release` 或 `发布` → 触发 release-flow
|
|
143
|
+
- `/deploy` 或 `部署` → 触发 sdd-deploy
|
|
144
|
+
|
|
145
|
+
### 设计相关
|
|
146
|
+
- `/ui` 或 `UI设计` → 触发 ui-sdd
|
|
147
|
+
- `/code` 或 `代码设计` → 触发 sdd-code
|
|
148
|
+
- `/test` 或 `测试设计` → 触发 sdd-test
|
|
149
|
+
|
|
150
|
+
### 知识沉淀
|
|
151
|
+
- `/save` 或 `保存经验` → 触发 claudeception
|
|
152
|
+
- `/mem` 或 `记忆保存` → 触发 mempalace-auto-saver
|
|
153
|
+
|
|
154
|
+
### 全流程命令
|
|
155
|
+
- `/full` 或 `完整流程` → 触发 sdd-full(完整SDD流程)
|
|
156
|
+
- `/flow` 或 `流程` → 显示技能决策树
|
|
157
|
+
|
|
158
|
+
---
|
|
159
|
+
|
|
160
|
+
## 四、Trae快捷调用格式
|
|
161
|
+
|
|
162
|
+
### 方式1:模板快捷调用
|
|
163
|
+
```
|
|
164
|
+
trae调用 模板名称 项目名称=XXX 阶段=XXX 流程场景=XXX
|
|
165
|
+
```
|
|
166
|
+
示例:
|
|
167
|
+
- `trae调用 Brain-SDD 项目名称=个人备忘录APP 阶段=初期想法收集 流程场景=从零开始新项目`
|
|
168
|
+
- `trae调用 PRD-SDD 项目名称=电商平台 需求优先级=P0 流程场景=完整3阶段SDD流程`
|
|
169
|
+
|
|
170
|
+
### 方式2:简称快捷调用
|
|
171
|
+
```
|
|
172
|
+
trae快捷 模板简称 项目名称=XXX 阶段=XXX 流程场景=XXX
|
|
173
|
+
```
|
|
174
|
+
示例:
|
|
175
|
+
- `trae快捷 Brain 项目名称=个人备忘录APP 阶段=初期想法收集 流程场景=从零开始新项目`
|
|
176
|
+
- `trae快捷 Code 项目名称=电商平台 功能模块=用户登录 流程场景=小型功能迭代`
|
|
177
|
+
|
|
178
|
+
### 模板简称映射
|
|
179
|
+
| 简称 | 模板名称 |
|
|
180
|
+
|------|---------|
|
|
181
|
+
| Base | Base-SDD.md |
|
|
182
|
+
| Brain | Brain-SDD.md |
|
|
183
|
+
| Competitor | Competitor-SDD.md |
|
|
184
|
+
| PRD | PRD-SDD.md |
|
|
185
|
+
| UI | UI-SDD.md |
|
|
186
|
+
| Code | Code-SDD.md |
|
|
187
|
+
| API | API-SDD.md |
|
|
188
|
+
| Env | Env-SDD.md |
|
|
189
|
+
| Test | Test-SDD.md |
|
|
190
|
+
| UI提示词 | UI资源提示词生成SDD.md |
|
|
191
|
+
|
|
192
|
+
---
|
|
193
|
+
|
|
194
|
+
## 五、流程场景参数说明
|
|
195
|
+
|
|
196
|
+
| 场景编号 | 流程场景 | 说明 |
|
|
197
|
+
|---------|---------|------|
|
|
198
|
+
| 1 | 完整3阶段SDD流程 | 大型项目,需要完整的SDD全流程 |
|
|
199
|
+
| 2 | 从零开始新项目 | 新项目立项,需要创意、调研、PRD |
|
|
200
|
+
| 3 | 小型功能迭代 | 快速迭代,小功能开发 |
|
|
201
|
+
| 4 | Bug处理 | Bug修复,调试问题 |
|
|
202
|
+
| 5 | 代码发布 | 版本发布,质量检查 |
|
|
203
|
+
|
|
204
|
+
---
|
|
205
|
+
|
|
206
|
+
## 六、个人偏好设置
|
|
207
|
+
|
|
208
|
+
### 默认项目名称
|
|
209
|
+
- 默认项目:个人备忘录APP
|
|
210
|
+
|
|
211
|
+
### 自动保存设置
|
|
212
|
+
- [x] 自动保存记忆(mempalace-auto-saver)
|
|
213
|
+
- [x] 定期提取经验(claudeception)
|
|
214
|
+
|
|
215
|
+
### 质量检查设置
|
|
216
|
+
- [x] 发布前自动触发 quality-gate
|
|
217
|
+
- [x] 提交前自动触发 verification-before-completion
|
|
218
|
+
|
|
219
|
+
---
|
|
220
|
+
|
|
221
|
+
**版本**: v1.0
|
|
222
|
+
**更新时间**: 2026-05-06
|
|
223
|
+
**适用项目**: sdd-full-npm
|
|
@@ -0,0 +1,117 @@
|
|
|
1
|
+
【claude code调用标识:Andrej Karpathy AI编码规则落地SDD】【trae调用标识:Andrej Karpathy AI编码规则落地SDD+编码规范】【流程场景:1.完整3阶段SDD流程、3.小型功能迭代】
|
|
2
|
+
|
|
3
|
+
# Andrej Karpathy AI编码规则落地SDD:[项目名称]
|
|
4
|
+
|
|
5
|
+
## 一、编码约束
|
|
6
|
+
|
|
7
|
+
### 1.1 THINK BEFORE YOU CODE
|
|
8
|
+
| 规则 | 说明 | 执行方式 |
|
|
9
|
+
|------|------|---------|
|
|
10
|
+
| 明确需求 | 先理解需求再编码 | 需求评审 |
|
|
11
|
+
| 无范围蔓延 | 严格按需求实现 | 需求文档确认 |
|
|
12
|
+
| 简洁优先 | 优先简洁方案 | 方案评审 |
|
|
13
|
+
|
|
14
|
+
### 1.2 MAKE SURGICAL CHANGES
|
|
15
|
+
| 规则 | 说明 | 执行方式 |
|
|
16
|
+
|------|------|---------|
|
|
17
|
+
| 最小变更 | 只修改必要代码 | 代码审查 |
|
|
18
|
+
| 不碰无关代码 | 不修改无关代码 | CI检查 |
|
|
19
|
+
| 不重构 | 除非明确要求 | 变更审批 |
|
|
20
|
+
|
|
21
|
+
### 1.3 KEEP IT SIMPLE
|
|
22
|
+
| 规则 | 说明 | 执行方式 |
|
|
23
|
+
|------|------|---------|
|
|
24
|
+
| 简单优先 | 选择简单方案 | 方案评审 |
|
|
25
|
+
| 避免复杂 | 不使用复杂模式 | 代码审查 |
|
|
26
|
+
| 易理解 | 代码易于理解 | peer review |
|
|
27
|
+
|
|
28
|
+
### 1.4 VERIFY YOUR WORK
|
|
29
|
+
| 规则 | 说明 | 执行方式 |
|
|
30
|
+
|------|------|---------|
|
|
31
|
+
| 测试验证 | 测试覆盖 | 单元测试 |
|
|
32
|
+
| 边缘案例 | 考虑边界 | 边界测试 |
|
|
33
|
+
| 确认方案 | 不确定就问 | 沟通确认 |
|
|
34
|
+
|
|
35
|
+
### 1.5 COMMUNICATE CLEARLY
|
|
36
|
+
| 规则 | 说明 | 执行方式 |
|
|
37
|
+
|------|------|---------|
|
|
38
|
+
| 简洁说明 | 简要说明变更 | PR描述 |
|
|
39
|
+
| 说明原因 | 说明变更原因 | 文档更新 |
|
|
40
|
+
| 聚焦任务 | 专注当前任务 | 任务管理 |
|
|
41
|
+
|
|
42
|
+
---
|
|
43
|
+
|
|
44
|
+
## 二、开源/商用方案对比范式
|
|
45
|
+
|
|
46
|
+
### 2.1 对比维度
|
|
47
|
+
| 维度 | 开源方案 | 商用方案 |
|
|
48
|
+
|------|---------|---------|
|
|
49
|
+
| 成本 | 免费 | 付费 |
|
|
50
|
+
| 支持 | 社区支持 | 官方支持 |
|
|
51
|
+
| 定制 | 高度定制 | 有限定制 |
|
|
52
|
+
| 稳定性 | 可能不稳定 | 稳定可靠 |
|
|
53
|
+
|
|
54
|
+
### 2.2 选择原则
|
|
55
|
+
| 场景 | 推荐方案 |
|
|
56
|
+
|------|---------|
|
|
57
|
+
| 核心功能 | 商用方案 |
|
|
58
|
+
| 非核心功能 | 开源方案 |
|
|
59
|
+
| 快速迭代 | 开源方案 |
|
|
60
|
+
| 企业级稳定 | 商用方案 |
|
|
61
|
+
|
|
62
|
+
### 2.3 决策流程
|
|
63
|
+
```
|
|
64
|
+
需求评估 → 方案调研 → 成本分析 → 风险评估 → 方案选择 → 验证 → 落地
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
---
|
|
68
|
+
|
|
69
|
+
## 三、禁止自由发挥落地细则
|
|
70
|
+
|
|
71
|
+
### 3.1 禁止项清单
|
|
72
|
+
| 禁止行为 | 说明 | 后果 |
|
|
73
|
+
|---------|------|------|
|
|
74
|
+
| 自行添加功能 | 未确认需求 | 返工 |
|
|
75
|
+
| 修改无关代码 | 改动超出范围 | 引入bug |
|
|
76
|
+
| 使用未批准库 | 未评审依赖 | 安全风险 |
|
|
77
|
+
| 跳过测试 | 未测试提交 | 质量问题 |
|
|
78
|
+
|
|
79
|
+
### 3.2 审批流程
|
|
80
|
+
| 步骤 | 内容 | 负责人 |
|
|
81
|
+
|------|------|--------|
|
|
82
|
+
| 1 | 需求确认 | 产品经理 |
|
|
83
|
+
| 2 | 方案评审 | 技术负责人 |
|
|
84
|
+
| 3 | 代码审查 | 技术评审 |
|
|
85
|
+
| 4 | 测试验证 | QA |
|
|
86
|
+
|
|
87
|
+
### 3.3 变更控制
|
|
88
|
+
| 变更类型 | 审批级别 |
|
|
89
|
+
|---------|---------|
|
|
90
|
+
| 功能新增 | 技术负责人 |
|
|
91
|
+
| Bug修复 | 技术评审 |
|
|
92
|
+
| 文档更新 | 自行审批 |
|
|
93
|
+
| 基础设施 | 架构师 |
|
|
94
|
+
|
|
95
|
+
---
|
|
96
|
+
|
|
97
|
+
## 四、验收标准
|
|
98
|
+
|
|
99
|
+
### 4.1 编码规范验证
|
|
100
|
+
- [ ] 代码符合约束规则
|
|
101
|
+
- [ ] 无自由发挥变更
|
|
102
|
+
- [ ] 方案经过评审
|
|
103
|
+
- [ ] 变更经过审批
|
|
104
|
+
|
|
105
|
+
### 4.2 代码质量验证
|
|
106
|
+
- [ ] 代码简洁易懂
|
|
107
|
+
- [ ] 测试覆盖达标
|
|
108
|
+
- [ ] 无未授权修改
|
|
109
|
+
- [ ] 文档同步更新
|
|
110
|
+
|
|
111
|
+
---
|
|
112
|
+
|
|
113
|
+
## 五、trae调用参数说明
|
|
114
|
+
- **调用路径**: skills/templates/Andrej Karpathy AI编码规则落地SDD.md
|
|
115
|
+
- **必传参数**: 项目名称
|
|
116
|
+
- **可选参数**: 团队规模、项目类型
|
|
117
|
+
- **流程场景**: 1.完整3阶段SDD流程、3.小型功能迭代
|
|
@@ -0,0 +1,147 @@
|
|
|
1
|
+
【claude code调用标识:BDD风格验收标准SDD】【trae调用标识:BDD风格验收标准SDD+验收规范】【流程场景:1.完整3阶段SDD流程、3.小型功能迭代、4.Bug处理】
|
|
2
|
+
|
|
3
|
+
# BDD风格验收标准SDD:[需求名称]
|
|
4
|
+
|
|
5
|
+
## 一、需求概述
|
|
6
|
+
|
|
7
|
+
### 1.1 需求描述
|
|
8
|
+
【必填】简明描述需求的核心内容
|
|
9
|
+
|
|
10
|
+
### 1.2 需求来源
|
|
11
|
+
- Jira/工单编号:【如:PROJ-001】
|
|
12
|
+
- 提出人:【姓名/角色】
|
|
13
|
+
- 优先级:【P0/P1/P2】
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## 二、场景定义
|
|
18
|
+
|
|
19
|
+
### 2.1 正常场景
|
|
20
|
+
| 场景编号 | 场景描述 | 前置条件 |
|
|
21
|
+
|---------|---------|---------|
|
|
22
|
+
| SC001 | 【用户正常使用功能A】 | 【用户已登录】 |
|
|
23
|
+
| SC002 | 【用户完成操作B】 | 【数据已加载】 |
|
|
24
|
+
|
|
25
|
+
### 2.2 异常场景
|
|
26
|
+
| 场景编号 | 场景描述 | 前置条件 |
|
|
27
|
+
|---------|---------|---------|
|
|
28
|
+
| EC001 | 【网络异常时操作】 | 【无网络连接】 |
|
|
29
|
+
| EC002 | 【数据为空时操作】 | 【数据库无数据】 |
|
|
30
|
+
|
|
31
|
+
### 2.3 边界场景
|
|
32
|
+
| 场景编号 | 场景描述 | 前置条件 |
|
|
33
|
+
|---------|---------|---------|
|
|
34
|
+
| BC001 | 【参数达到最大限制】 | 【输入达到上限】 |
|
|
35
|
+
| BC002 | 【并发操作场景】 | 【多个用户同时操作】 |
|
|
36
|
+
|
|
37
|
+
---
|
|
38
|
+
|
|
39
|
+
## 三、验收句式
|
|
40
|
+
|
|
41
|
+
### 3.1 Given-When-Then格式
|
|
42
|
+
|
|
43
|
+
#### 正常场景示例
|
|
44
|
+
```gherkin
|
|
45
|
+
Scenario: 用户登录成功
|
|
46
|
+
Given 用户在登录页面
|
|
47
|
+
And 用户输入正确的用户名和密码
|
|
48
|
+
When 用户点击登录按钮
|
|
49
|
+
Then 系统跳转到首页
|
|
50
|
+
And 显示用户信息
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
#### 异常场景示例
|
|
54
|
+
```gherkin
|
|
55
|
+
Scenario: 用户登录失败(密码错误)
|
|
56
|
+
Given 用户在登录页面
|
|
57
|
+
And 用户输入正确的用户名和错误的密码
|
|
58
|
+
When 用户点击登录按钮
|
|
59
|
+
Then 显示错误提示"密码错误"
|
|
60
|
+
And 用户停留在登录页面
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
### 3.2 前置条件模板
|
|
64
|
+
| 类型 | 格式 | 示例 |
|
|
65
|
+
|------|------|------|
|
|
66
|
+
| 用户状态 | Given 用户【状态】 | Given 用户已登录 |
|
|
67
|
+
| 系统状态 | Given 系统【状态】 | Given 系统正常运行 |
|
|
68
|
+
| 数据状态 | Given 数据【状态】 | Given 数据库中有10条记录 |
|
|
69
|
+
|
|
70
|
+
### 3.3 预期结果模板
|
|
71
|
+
| 类型 | 格式 | 示例 |
|
|
72
|
+
|------|------|------|
|
|
73
|
+
| 页面跳转 | Then 跳转到【页面】 | Then 跳转到首页 |
|
|
74
|
+
| 信息展示 | Then 显示【信息】 | Then 显示欢迎消息 |
|
|
75
|
+
| 数据变化 | Then 【数据】【变化】 | Then 用户积分增加100 |
|
|
76
|
+
| 错误提示 | Then 显示错误【提示】 | Then 显示错误"网络异常" |
|
|
77
|
+
|
|
78
|
+
---
|
|
79
|
+
|
|
80
|
+
## 四、准入标准
|
|
81
|
+
|
|
82
|
+
### 4.1 需求澄清完成
|
|
83
|
+
- [ ] 需求描述清晰明确
|
|
84
|
+
- [ ] 需求范围已确认
|
|
85
|
+
- [ ] 需求优先级已确定
|
|
86
|
+
- [ ] 利益相关方已确认
|
|
87
|
+
|
|
88
|
+
### 4.2 设计稿就绪
|
|
89
|
+
- [ ] UI设计稿已完成
|
|
90
|
+
- [ ] 交互设计已确认
|
|
91
|
+
- [ ] 技术方案已评审
|
|
92
|
+
- [ ] API接口已定义
|
|
93
|
+
|
|
94
|
+
### 4.3 依赖确认
|
|
95
|
+
- [ ] 外部依赖已确认
|
|
96
|
+
- [ ] 内部依赖已协调
|
|
97
|
+
- [ ] 测试环境已准备
|
|
98
|
+
- [ ] 数据准备已完成
|
|
99
|
+
|
|
100
|
+
---
|
|
101
|
+
|
|
102
|
+
## 五、准出标准
|
|
103
|
+
|
|
104
|
+
### 5.1 功能验证通过
|
|
105
|
+
- [ ] 所有正常场景测试通过
|
|
106
|
+
- [ ] 所有异常场景测试通过
|
|
107
|
+
- [ ] 所有边界场景测试通过
|
|
108
|
+
- [ ] 性能测试通过
|
|
109
|
+
|
|
110
|
+
### 5.2 测试覆盖率
|
|
111
|
+
- [ ] 单元测试覆盖率 ≥ 80%
|
|
112
|
+
- [ ] 集成测试覆盖率 ≥ 70%
|
|
113
|
+
- [ ] E2E测试覆盖核心流程
|
|
114
|
+
- [ ] 安全测试通过
|
|
115
|
+
|
|
116
|
+
### 5.3 文档完整
|
|
117
|
+
- [ ] 需求文档已更新
|
|
118
|
+
- [ ] API文档已更新
|
|
119
|
+
- [ ] 测试文档已更新
|
|
120
|
+
- [ ] 用户手册已更新
|
|
121
|
+
|
|
122
|
+
---
|
|
123
|
+
|
|
124
|
+
## 六、测试用例
|
|
125
|
+
|
|
126
|
+
### 6.1 单元测试
|
|
127
|
+
| 测试编号 | 测试方法 | 测试内容 | 预期结果 |
|
|
128
|
+
|---------|---------|---------|---------|
|
|
129
|
+
| UT001 | 【方法名】 | 【测试场景】 | 【预期结果】 |
|
|
130
|
+
|
|
131
|
+
### 6.2 集成测试
|
|
132
|
+
| 测试编号 | 测试场景 | 接口调用 | 预期结果 |
|
|
133
|
+
|---------|---------|---------|---------|
|
|
134
|
+
| IT001 | 【集成场景】 | 【接口列表】 | 【预期结果】 |
|
|
135
|
+
|
|
136
|
+
### 6.3 E2E测试
|
|
137
|
+
| 测试编号 | 测试场景 | 操作步骤 | 预期结果 |
|
|
138
|
+
|---------|---------|---------|---------|
|
|
139
|
+
| E2E001 | 【端到端场景】 | 【步骤列表】 | 【预期结果】 |
|
|
140
|
+
|
|
141
|
+
---
|
|
142
|
+
|
|
143
|
+
## 七、trae调用参数说明
|
|
144
|
+
- **调用路径**: skills/templates/BDD风格验收标准SDD.md
|
|
145
|
+
- **必传参数**: 需求名称
|
|
146
|
+
- **可选参数**: Jira编号、优先级、提出人
|
|
147
|
+
- **流程场景**: 1.完整3阶段SDD流程、3.小型功能迭代、4.Bug处理
|