sdd-full 1.5.2 → 1.7.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 (30) hide show
  1. package/package.json +1 -1
  2. package/skills/call-adaptation/call-adaptation-guide.md +59 -0
  3. package/skills/call-adaptation/claude-code-call-spec.md +50 -0
  4. package/skills/call-adaptation/trae-call-spec.md +56 -0
  5. package/skills/sdd-framework/API-SDD-template.md +26 -0
  6. package/skills/sdd-framework/Base-SDD-template.md +36 -0
  7. package/skills/sdd-framework/Brain-SDD-template.md +29 -0
  8. package/skills/sdd-framework/Code-SDD-template.md +29 -0
  9. package/skills/sdd-framework/Competitor-SDD-template.md +38 -0
  10. package/skills/sdd-framework/Env-SDD-template.md +29 -0
  11. package/skills/sdd-framework/PRD-SDD-template.md +35 -0
  12. package/skills/sdd-framework/SKILL.md +80 -0
  13. package/skills/sdd-framework/Test-SDD-template.md +26 -0
  14. package/skills/sdd-framework/UI-SDD-template.md +31 -0
  15. package/skills/sdd-framework/figma-spec.md +27 -0
  16. package/skills/sdd-framework/flow-charts.md +99 -0
  17. package/skills/sdd-framework/template-version.lock +14 -0
  18. package/skills/templates/API-SDD.md +30 -0
  19. package/skills/templates/Base-SDD.md +37 -0
  20. package/skills/templates/Brain-SDD.md +35 -0
  21. package/skills/templates/Code-SDD.md +40 -0
  22. package/skills/templates/Competitor-SDD.md +33 -0
  23. package/skills/templates/Env-SDD.md +36 -0
  24. package/skills/templates/PRD-SDD.md +44 -0
  25. package/skills/templates/Test-SDD.md +33 -0
  26. package/skills/templates/UI-SDD.md +37 -0
  27. 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 +56 -0
  28. 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 +58 -0
  29. package/skills//346/212/200/350/203/275/344/275/277/347/224/250/346/214/207/345/215/227.md +37 -0
  30. package/skills//346/212/200/350/203/275/345/206/263/347/255/226/346/240/221.md +40 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "sdd-full",
3
- "version": "1.5.2",
3
+ "version": "1.7.0",
4
4
  "description": "SDD Full - 完整的软件设计开发技能包",
5
5
  "main": "index.js",
6
6
  "bin": "./bin.js",
@@ -0,0 +1,59 @@
1
+ # 两种调用机制切换指南及异常处理
2
+
3
+ ## 一、切换逻辑
4
+
5
+ ### 1.1 使用claude code调用
6
+ - 直接通过关键词触发,无需额外操作
7
+ - 示例:"调用brainstorming技能,项目名称:XX"
8
+
9
+ ### 1.2 使用trae调用
10
+ - 需按固定格式输入调用指令,包含技能文档路径、必传参数
11
+ - 格式:trae调用 skills/对应分类目录/技能名称.md 参数1=值1 参数2=值2
12
+ - 示例:trae调用 skills/requirement-analysis/brainstorming.md 项目名称=XX 触发场景=需求分析
13
+
14
+ ## 二、异常处理方案
15
+
16
+ ### 2.1 trae调用失败
17
+ 优先核对以下3点:
18
+ 1. 技能文档路径是否正确
19
+ 2. 文档头部是否有trae调用标识
20
+ 3. 必传参数是否完整
21
+
22
+ 核对后重新触发调用。
23
+
24
+ ### 2.2 claude code调用失败
25
+ - 无需额外核对,直接重试或手动选择技能选项
26
+
27
+ ### 2.3 两种机制均调用失败
28
+ - 查看本指南及相关适配文档
29
+ - 检查技能文档是否符合统一规范
30
+
31
+ ## 三、技能文档规范检查清单
32
+
33
+ | 检查项 | 说明 |
34
+ |--------|------|
35
+ | 双调用标识 | 文档头部是否包含【claude code调用标识】和【trae调用标识】 |
36
+ | 命名规范 | 文件名是否与原始技能列表一致,无特殊字符 |
37
+ | 选项式设计 | 是否每个模块都有可选项和自定义补充入口 |
38
+ | 参数说明 | 是否包含trae调用参数说明(文档末尾) |
39
+ | 路径匹配 | 调用路径是否与实际目录结构一致 |
40
+
41
+ ## 四、技能目录结构参考
42
+
43
+ ```
44
+ skills/
45
+ ├─ requirement-analysis/ # 需求分析类
46
+ ├─ design-planning/ # 设计规划类
47
+ ├─ development-execution/ # 开发执行类
48
+ ├─ quality-assurance/ # 质量保障类
49
+ ├─ release-ops/ # 发布运维类
50
+ ├─ knowledge-precipitation/ # 知识沉淀类
51
+ ├─ special-tools/ # 专项工具类
52
+ ├─ call-adaptation/ # 调用机制适配
53
+ └─ templates/ # SDD模板
54
+ ```
55
+
56
+ ---
57
+
58
+ **版本**: v1.0
59
+ **适用场景**: 两种调用机制切换与异常处理
@@ -0,0 +1,50 @@
1
+ # claude code调用机制说明及技能文档适配规范
2
+
3
+ ## 一、claude code调用机制核心特性
4
+
5
+ ### 1.1 调用触发方式
6
+ - 支持关键词触发、主动调用两种方式
7
+ - 可直接读取技能文档中的选项式内容,自动匹配调用逻辑
8
+
9
+ ### 1.2 文档解析逻辑
10
+ - 可自动解析技能文档中的层级结构(标题、列表、选项)
11
+ - 无需额外标注,直接提取核心调用信息
12
+
13
+ ### 1.3 异常处理
14
+ - 调用失败时可自动重试,或提示手动选择技能选项
15
+
16
+ ## 二、技能文档适配规范
17
+
18
+ ### 2.1 调用标识要求
19
+ 所有技能文档头部添加claude code调用标识(可选但推荐):
20
+ ```markdown
21
+ 【claude code调用标识:技能名称】
22
+ ```
23
+
24
+ ### 2.2 选项式设计要求
25
+ 技能文档采用选项式设计,便于AI调用:
26
+ - 每个模块提供明确可选项
27
+ - 保留自定义补充入口
28
+ - 支持多选
29
+
30
+ ### 2.3 命名规范
31
+ - 技能文档命名格式:技能名称.md(与原始技能列表一致)
32
+ - 禁止使用特殊字符、空格
33
+
34
+ ## 三、调用示例
35
+
36
+ ```
37
+ 调用brainstorming技能,项目名称:个人备忘录APP
38
+ ```
39
+
40
+ ## 四、常见问题排查
41
+
42
+ | 问题现象 | 可能原因 | 排查方法 |
43
+ |---------|---------|---------|
44
+ | 调用失败 | 技能名称不匹配 | 核对技能名称是否与原始列表一致 |
45
+ | 选项缺失 | 选项式设计不完整 | 检查是否每个模块都有可选项 |
46
+
47
+ ---
48
+
49
+ **版本**: v1.0
50
+ **适用场景**: claude code平台技能调用
@@ -0,0 +1,56 @@
1
+ # trae调用机制说明及技能文档适配规范
2
+
3
+ ## 一、trae调用机制核心特性
4
+
5
+ ### 1.1 调用触发方式
6
+ - 仅支持指定格式触发,需明确技能文档路径、调用参数
7
+ - 不支持关键词触发、不支持模糊匹配
8
+
9
+ ### 1.2 文档解析逻辑
10
+ - 需在技能文档头部添加固定格式的调用标识
11
+ - 调用标识格式:【trae调用标识:技能名称+关联SDD】
12
+ - 示例:【trae调用标识:brainstorming+Brain-SDD】
13
+
14
+ ### 1.3 异常处理
15
+ - 调用失败后直接返回错误提示
16
+ - 需手动核对技能文档格式、调用路径后重新触发
17
+
18
+ ## 二、技能文档适配规范
19
+
20
+ ### 2.1 调用标识要求
21
+ 所有技能文档头部必须添加trae调用标识:
22
+ ```markdown
23
+ 【trae调用标识:技能名称+关联SDD模板名称】
24
+ ```
25
+
26
+ ### 2.2 参数说明要求
27
+ 在文档末尾补充trae调用参数说明:
28
+ ```markdown
29
+ ## trae调用参数说明(仅trae触发时使用)
30
+ - 调用路径:skills/对应分类目录/技能名称.md
31
+ - 必传参数:项目名称、技能触发场景
32
+ - 可选参数:自定义选项补充内容
33
+ ```
34
+
35
+ ### 2.3 命名规范
36
+ - 技能文档命名格式:技能名称.md(与原始技能列表一致)
37
+ - 禁止使用特殊字符、空格
38
+
39
+ ## 三、调用示例
40
+
41
+ ```
42
+ trae调用 skills/requirement-analysis/brainstorming.md 项目名称=个人备忘录APP 触发场景=需求分析阶段
43
+ ```
44
+
45
+ ## 四、常见问题排查
46
+
47
+ | 问题现象 | 可能原因 | 排查方法 |
48
+ |---------|---------|---------|
49
+ | 调用失败 | 文档路径错误 | 核对skills目录结构 |
50
+ | 解析失败 | 缺少调用标识 | 检查文档头部是否有trae调用标识 |
51
+ | 参数错误 | 必传参数缺失 | 确认必传参数是否完整 |
52
+
53
+ ---
54
+
55
+ **版本**: v1.0
56
+ **适用场景**: trae平台技能调用
@@ -0,0 +1,26 @@
1
+ # API-SDD:[接口模块名称]
2
+
3
+ ## 一、接口清单
4
+ | API路径 | 方法 | 功能描述 |
5
+ |--------|------|---------|
6
+ | [ ] | | |
7
+
8
+ ## 二、接口详细定义
9
+ ### [API名称]
10
+ - [ ] 路径:
11
+ - [ ] 方法:
12
+ - [ ] 认证:
13
+ - [ ] 参数:
14
+ - [ ] 返回值:
15
+ - [ ] 错误码:
16
+
17
+ ## 三、契约版本管理
18
+ - [ ]
19
+
20
+ ## 四、前后端约定
21
+ - [ ]
22
+
23
+ ---
24
+
25
+ **模板版本**: v4.1
26
+ **适用技能**: sdd(接口拆分)
@@ -0,0 +1,36 @@
1
+ # Base-SDD:全局通用基线规范
2
+
3
+ ## 一、全局UI交互基线
4
+ - [ ] 设计系统版本:
5
+ - [ ] 颜色规范:
6
+ - [ ] 字体规范:
7
+ - [ ] 间距规范:
8
+
9
+ ## 二、弹窗/浮层生命周期规范
10
+ - [ ] 弹窗打开规则:
11
+ - [ ] 弹窗关闭规则:
12
+ - [ ] 遮罩层行为:
13
+ - [ ] 层级规范:
14
+
15
+ ## 三、手势冲突通用规则
16
+ - [ ] 滑动冲突处理:
17
+ - [ ] 点击穿透处理:
18
+ - [ ] 双指缩放规则:
19
+
20
+ ## 四、通用编码规范
21
+ - [ ] 命名规范:
22
+ - [ ] 注释规范:
23
+ - [ ] 代码风格:
24
+
25
+ ## 五、错误码规范
26
+ - [ ] 通用错误码:
27
+ - [ ] 业务错误码:
28
+
29
+ ## 六、安全规范
30
+ - [ ] 隐私数据处理:
31
+ - [ ] 敏感信息脱敏:
32
+
33
+ ---
34
+
35
+ **模板版本**: v4.1
36
+ **适用技能**: sdd, sdd-full
@@ -0,0 +1,29 @@
1
+ # Brain-SDD:[项目名称]头脑风暴文档
2
+
3
+ ## 一、想法收集
4
+ - [ ] 基础功能类:
5
+ - [ ] 便捷交互类:
6
+ - [ ] 个性化类:
7
+ - [ ] 其他:
8
+
9
+ ## 二、初步脑洞
10
+ - [ ] 技术拓展类:
11
+ - [ ] 场景延伸类:
12
+ - [ ] 创新功能类:
13
+ - [ ] 其他:
14
+
15
+ ## 三、废弃方案(记录原因)
16
+ - [ ] 方案:→ 原因:
17
+ - [ ] 方案:→ 原因:
18
+
19
+ ## 四、灵感来源
20
+ - [ ] 来源链接/描述:
21
+ - [ ] 来源链接/描述:
22
+
23
+ ## 五、风险初步评估
24
+ - [ ] 风险点:→ 应对措施:
25
+
26
+ ---
27
+
28
+ **模板版本**: v4.1
29
+ **适用技能**: brainstorming
@@ -0,0 +1,29 @@
1
+ # Code-SDD:[功能模块名称]
2
+
3
+ ## 一、功能概述
4
+ - [ ]
5
+
6
+ ## 二、代码结构
7
+ - [ ]
8
+
9
+ ## 三、函数定义
10
+ | 函数名 | 功能 | 参数 | 返回值 |
11
+ |-------|------|------|--------|
12
+ | [ ] | | | |
13
+
14
+ ## 四、数据模型
15
+ - [ ]
16
+
17
+ ## 五、代码规范(对齐Base-SDD)
18
+ - [ ]
19
+
20
+ ## 六、技术债务记录
21
+ - [ ]
22
+
23
+ ## 七、重构计划
24
+ - [ ]
25
+
26
+ ---
27
+
28
+ **模板版本**: v4.1
29
+ **适用技能**: sdd-code, test-driven-development
@@ -0,0 +1,38 @@
1
+ # Competitor-SDD:[项目名称]竞品分析文档
2
+
3
+ ## 一、竞品列表
4
+ | 竞品名称 | 类型 | 核心功能 |
5
+ |---------|------|---------|
6
+ | [ ] | 直接竞品 | |
7
+ | [ ] | 间接竞品 | |
8
+ | [ ] | 潜在竞品 | |
9
+
10
+ ## 二、功能对比
11
+ | 功能点 | 竞品A | 竞品B | 竞品C |
12
+ |--------|------|------|------|
13
+ | [ ] | | | |
14
+ | [ ] | | | |
15
+ | [ ] | | | |
16
+
17
+ ## 三、优缺点分析
18
+ ### 竞品A
19
+ - [ ] 优点:
20
+ - [ ] 缺点:
21
+
22
+ ### 竞品B
23
+ - [ ] 优点:
24
+ - [ ] 缺点:
25
+
26
+ ## 四、可借鉴点
27
+ - [ ]
28
+
29
+ ## 五、避坑点
30
+ - [ ]
31
+
32
+ ## 六、差异化机会
33
+ - [ ]
34
+
35
+ ---
36
+
37
+ **模板版本**: v4.1
38
+ **适用技能**: competitive-brief, market-research
@@ -0,0 +1,29 @@
1
+ # Env-SDD:[项目名称]环境配置
2
+
3
+ ## 一、环境列表
4
+ | 环境 | URL | 用途 |
5
+ |------|-----|------|
6
+ | [ ] | | |
7
+
8
+ ## 二、权限配置
9
+ - [ ]
10
+
11
+ ## 三、SDK配置
12
+ - [ ]
13
+
14
+ ## 四、APIKey管理
15
+ - [ ]
16
+
17
+ ## 五、原生工程配置
18
+ - [ ]
19
+
20
+ ## 六、隐私配置
21
+ - [ ]
22
+
23
+ ## 七、敏感信息管理(不提交代码库)
24
+ - [ ]
25
+
26
+ ---
27
+
28
+ **模板版本**: v4.1
29
+ **适用技能**: sdd-deploy, sdd-ops
@@ -0,0 +1,35 @@
1
+ # PRD-SDD:[项目名称]产品需求文档
2
+
3
+ ## 一、需求背景
4
+ - [ ] 来源:
5
+ - [ ] 目的:
6
+ - [ ] 优先级:
7
+
8
+ ## 二、用户角色定义
9
+ | 角色 | 描述 | 需求关注点 |
10
+ |------|------|-----------|
11
+ | [ ] | | |
12
+
13
+ ## 三、用户旅程梳理
14
+ - [ ]
15
+
16
+ ## 四、功能范围界定
17
+ - [ ] 包含:
18
+ - [ ] 不包含:
19
+
20
+ ## 五、需求补全清单
21
+ - [ ]
22
+
23
+ ## 六、主干流程
24
+ - [ ]
25
+
26
+ ## 七、架构&模块拆分(附录)
27
+ - [ ]
28
+
29
+ ## 八、验收标准
30
+ - [ ]
31
+
32
+ ---
33
+
34
+ **模板版本**: v4.1
35
+ **适用技能**: prd-write, requirement-completion-officer
@@ -0,0 +1,80 @@
1
+ ---
2
+ name: sdd-framework
3
+ description: SDD融合框架 - 9份标准化SDD模板,覆盖从全局基线到测试的全流程
4
+ ---
5
+
6
+ # SDD融合框架
7
+
8
+ ## 概述
9
+
10
+ 本框架提供9份标准化SDD模板,将头脑风暴、竞品分析、PRD、UI设计、代码实现、API设计、环境配置、测试设计等环节纳入文档化管理,形成纯文档闭环。
11
+
12
+ ## 9份SDD模板
13
+
14
+ | 模板名称 | 核心内容 | 适用技能 |
15
+ |---------|---------|---------|
16
+ | **Base-SDD** | 全局通用基线规范 | sdd, sdd-full |
17
+ | **Brain-SDD** | 头脑风暴文档 | brainstorming |
18
+ | **Competitor-SDD** | 竞品分析文档 | competitive-brief, market-research |
19
+ | **PRD-SDD** | 产品需求文档 | prd-write, requirement-completion-officer |
20
+ | **UI-SDD** | UI设计文档 | ui-sdd |
21
+ | **Code-SDD** | 代码实现文档 | sdd-code, test-driven-development |
22
+ | **API-SDD** | 接口设计文档 | sdd(接口拆分) |
23
+ | **Env-SDD** | 环境配置文档 | sdd-deploy, sdd-ops |
24
+ | **Test-SDD** | 测试设计文档 | sdd-test, test-driven-development |
25
+
26
+ ## 强制顺序流水线
27
+
28
+ ```
29
+ 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
30
+ ```
31
+
32
+ ## 使用指南
33
+
34
+ ### 新项目完整流程
35
+ 1. 首先创建Base-SDD定义全局基线
36
+ 2. Brain-SDD进行头脑风暴
37
+ 3. Competitor-SDD进行竞品分析
38
+ 4. PRD-SDD编写产品需求
39
+ 5. Figma设计UI
40
+ 6. 依次创建UI-SDD、Code-SDD、API-SDD、Env-SDD、Test-SDD
41
+ 7. TDD开发、测试、发布
42
+
43
+ ### Bug修复流程
44
+ 1. systematic-debugging分析问题
45
+ 2. 更新Test-SDD添加回归用例
46
+ 3. sdd-add修复代码
47
+ 4. verification-before-completion验证
48
+ 5. quality-gate检查
49
+ 6. claudeception沉淀经验
50
+
51
+ ### 精简流程(小功能)
52
+ 满足任意2条可使用精简流程:
53
+ - 开发周期≤1天,代码量≤500行
54
+ - 不涉及新接口、新UI组件
55
+ - 无复杂交互,不影响全局流程
56
+
57
+ ## 模板版本管理
58
+
59
+ 所有模板采用版本化管理,通过`template-version.lock`文件记录版本信息,每个项目绑定固定版本,避免版本混乱。
60
+
61
+ ## Figma接入规范
62
+
63
+ - Figma链接失效时启用PDF/PNG备用文件
64
+ - 关键截图需标注核心尺寸
65
+ - UI-SDD中必须同时包含链接和备用文件
66
+
67
+ ## AI协作规范
68
+
69
+ | 阶段 | AI职责 | 人工校验要求 |
70
+ |------|--------|-------------|
71
+ | Brain-SDD | 发散想法、评估风险 | 确认想法合理性 |
72
+ | Competitor-SDD | 收集竞品信息、对比差异 | 确认分析准确性 |
73
+ | PRD-SDD | 补全需求、梳理用户旅程 | 必须人工二次确认 |
74
+ | Code-SDD | 编写测试用例、排查Bug | 确认代码规范 |
75
+ | 所有阶段 | 协助整理归档 | 校验完整性 |
76
+
77
+ ---
78
+
79
+ **模板版本**: v4.1
80
+ **适用场景**: 个人+AI开发模式的完整文档化流程
@@ -0,0 +1,26 @@
1
+ # Test-SDD:[测试模块名称]
2
+
3
+ ## 一、测试策略
4
+ - [ ]
5
+
6
+ ## 二、测试用例
7
+ | 用例ID | 测试场景 | 预期结果 |
8
+ |--------|---------|---------|
9
+ | [ ] | | |
10
+
11
+ ## 三、测试数据
12
+ - [ ]
13
+
14
+ ## 四、测试覆盖率目标
15
+ - [ ]
16
+
17
+ ## 五、性能测试指标
18
+ - [ ]
19
+
20
+ ## 六、安全测试要点
21
+ - [ ]
22
+
23
+ ---
24
+
25
+ **模板版本**: v4.1
26
+ **适用技能**: sdd-test, test-driven-development
@@ -0,0 +1,31 @@
1
+ # UI-SDD:[页面/组件名称]
2
+
3
+ ## 一、页面/组件概述
4
+ - [ ]
5
+
6
+ ## 二、Figma链接
7
+ - [ ] 设计稿:
8
+ - [ ] 备用方案(PDF/PNG):
9
+ - [ ] 关键截图:
10
+
11
+ ## 三、页面结构
12
+ - [ ]
13
+
14
+ ## 四、组件清单
15
+ | 组件名称 | 功能描述 | 状态 |
16
+ |---------|---------|------|
17
+ | [ ] | | |
18
+
19
+ ## 五、交互流程
20
+ - [ ]
21
+
22
+ ## 六、状态设计
23
+ - [ ]
24
+
25
+ ## 七、设计规范(对齐Base-SDD)
26
+ - [ ]
27
+
28
+ ---
29
+
30
+ **模板版本**: v4.1
31
+ **适用技能**: ui-sdd
@@ -0,0 +1,27 @@
1
+ # Figma接入规范
2
+
3
+ ## 一、Figma源文件管理
4
+ - 云端托管:统一存储到团队Figma空间
5
+ - 文件命名:[项目名]-[模块名].fig
6
+ - 版本管理:使用Figma版本历史功能
7
+
8
+ ## 二、UI-SDD嵌入要求
9
+ - 必须包含Figma设计稿链接
10
+ - 关键页面/组件需附截图,标注核心尺寸(按钮大小、间距)
11
+ - UI-SDD中必须同时包含链接和备用文件(PDF/PNG)
12
+
13
+ ## 三、设计规范同步
14
+ - Figma组件库版本与Base-SDD保持一致
15
+ - 颜色/字体/间距规范从Base-SDD导入
16
+ - 设计变更需同步更新UI-SDD
17
+
18
+ ## 四、协作流程
19
+ - 设计完成 → 评审 → 导出标注 → 更新UI-SDD → 开发
20
+
21
+ ## 五、备用方案
22
+ - Figma链接失效时启用PDF/PNG备用文件
23
+ - 截图需保持清晰,标注必要的尺寸信息
24
+
25
+ ---
26
+
27
+ **适用技能**: ui-sdd
@@ -0,0 +1,99 @@
1
+ # SDD融合流程图汇总
2
+
3
+ ## 一、新项目完整流程
4
+
5
+ ```
6
+ ┌─────────────────────────────────────────────────────────────────┐
7
+ │ 阶段0:全局基线 │
8
+ ├─────────────────────────────────────────────────────────────────┤
9
+ │ Base-SDD → 全局UI交互基线、弹窗/浮层规范、通用编码规范 │
10
+ └─────────────────────────────────────────────────────────────────┘
11
+
12
+ ┌─────────────────────────────────────────────────────────────────┐
13
+ │ 阶段1:需求发散 │
14
+ ├─────────────────────────────────────────────────────────────────┤
15
+ │ Brain-SDD → 想法、点子、灵感、初步脑洞、废弃方案 │
16
+ │ ↓ │
17
+ │ Competitor-SDD → 竞品功能、交互、优缺点、可借鉴点、避坑点 │
18
+ └─────────────────────────────────────────────────────────────────┘
19
+
20
+ ┌─────────────────────────────────────────────────────────────────┐
21
+ │ 阶段2:需求定义 │
22
+ ├─────────────────────────────────────────────────────────────────┤
23
+ │ PRD-SDD → 原始需求、用户场景、功能边界、需求补全 │
24
+ │ ├─ 用户角色定义 │
25
+ │ ├─ 用户旅程梳理 │
26
+ │ ├─ 产品方案设计 │
27
+ │ └─ 架构&模块拆分(附录) │
28
+ └─────────────────────────────────────────────────────────────────┘
29
+
30
+ ┌─────────────────────────────────────────────────────────────────┐
31
+ │ 阶段3:技术设计 │
32
+ ├─────────────────────────────────────────────────────────────────┤
33
+ │ Figma设计 → 设计稿、组件库(对齐Base-SDD) │
34
+ │ ↓ │
35
+ │ UI-SDD → 页面结构、组件清单、交互流程、内嵌Figma链接 │
36
+ │ ↓ │
37
+ │ Code-SDD → 代码结构、函数定义、数据模型、代码规范 │
38
+ │ ↓ │
39
+ │ API-SDD → 接口定义、参数、返回值、错误码、契约版本 │
40
+ │ ↓ │
41
+ │ Env-SDD → 环境配置、权限、SDK、APIKey、原生工程配置 │
42
+ │ ↓ │
43
+ │ Test-SDD → 测试用例、测试策略、测试数据 │
44
+ └─────────────────────────────────────────────────────────────────┘
45
+
46
+ ┌─────────────────────────────────────────────────────────────────┐
47
+ │ 阶段4:开发执行 │
48
+ ├─────────────────────────────────────────────────────────────────┤
49
+ │ TDD开发 → 按Test-SDD实施,测试先行 │
50
+ │ ↓ │
51
+ │ 分层测试 → 单元/UI/真机/E2E │
52
+ │ ↓ │
53
+ │ Bug闭环 → systematic-debugging → sdd-add │
54
+ └─────────────────────────────────────────────────────────────────┘
55
+
56
+ ┌─────────────────────────────────────────────────────────────────┐
57
+ │ 阶段5:发布归档 │
58
+ ├─────────────────────────────────────────────────────────────────┤
59
+ │ quality-gate → 质量门禁检查 │
60
+ │ ↓ │
61
+ │ sdd-deploy → 打包、发布、部署流程 │
62
+ │ ↓ │
63
+ │ release-flow → 版本发布 │
64
+ │ ↓ │
65
+ │ claudeception → 经验沉淀 │
66
+ └─────────────────────────────────────────────────────────────────┘
67
+ ```
68
+
69
+ ## 二、功能新增流程
70
+
71
+ ```
72
+ PRD-SDD补充 → Figma更新 → UI-SDD补充 → Code-SDD补充 → API-SDD补充 → Env-SDD补充 → Test-SDD补充 → sdd-add → verification-before-completion → quality-gate → release-flow
73
+ ```
74
+
75
+ ## 三、Bug修复流程
76
+
77
+ ```
78
+ systematic-debugging → Test-SDD补充回归用例 → sdd-add修复 → verification-before-completion → quality-gate → claudeception
79
+ ```
80
+
81
+ ## 四、快速迭代流程
82
+
83
+ ```
84
+ requirement-completion-officer(可选) → writing-plans(可选) → sdd-add → verification-before-completion → quality-gate → finishing-a-development-branch(可选) → 简单发布
85
+ ```
86
+
87
+ ## 五、技能映射关系
88
+
89
+ | SDD模板 | 对应技能 |
90
+ |---------|---------|
91
+ | Base-SDD | sdd, sdd-full |
92
+ | Brain-SDD | brainstorming |
93
+ | Competitor-SDD | competitive-brief, market-research |
94
+ | PRD-SDD | prd-write, requirement-completion-officer |
95
+ | UI-SDD | ui-sdd |
96
+ | Code-SDD | sdd-code, test-driven-development |
97
+ | API-SDD | sdd(接口拆分) |
98
+ | Env-SDD | sdd-deploy, sdd-ops |
99
+ | Test-SDD | sdd-test, test-driven-development |
@@ -0,0 +1,14 @@
1
+ {
2
+ "templateVersion": "v4.1",
3
+ "projectBind": {
4
+ "个人备忘录APP": "v4.1",
5
+ "简易记账工具": "v3.0"
6
+ },
7
+ "updateLog": [
8
+ {
9
+ "version": "v4.1",
10
+ "updateTime": "2026-05-06",
11
+ "updateContent": "skill选项式设计、全流程融合、AI协作规范、技能映射优化"
12
+ }
13
+ ]
14
+ }
@@ -0,0 +1,30 @@
1
+ # API-SDD:[接口模块名称](skill选项式设计)
2
+ 【claude code调用标识:API-SDD】【trae调用标识:API-SDD+sdd】
3
+
4
+ ## 一、接口清单(skill可选项,支持多选/自定义补充)
5
+ - 选项1:API路径 → 选项:/api/user/login(用户登录)/api/user/info(获取用户信息) → 自定义路径:__________
6
+ - 选项2:请求方法 → 选项:GET/POST/PUT/DELETE → 自定义方法:__________
7
+ - 选项3:功能描述 → 选项:用户登录/获取用户信息/更新用户信息 → 自定义描述:__________
8
+
9
+ ## 二、接口详细定义(skill可选项,支持多选/自定义补充)
10
+ ### [API名称]
11
+ - 选项1:路径 → 选项:/api/xxx(示例) → 自定义路径:__________
12
+ - 选项2:方法 → 选项:GET/POST/PUT/DELETE → 自定义方法:__________
13
+ - 选项3:认证方式 → 选项:JWT Token/API Key/无需认证 → 自定义认证:__________
14
+ - 选项4:请求参数 → 选项:参数1(类型:String,必填)/参数2(类型:Number,可选) → 自定义参数:__________
15
+ - 选项5:返回值 → 选项:code(状态码)/data(数据)/message(提示信息) → 自定义返回:__________
16
+ - 选项6:错误码 → 选项:1001(参数错误)/1002(认证失败) → 自定义错误码:__________
17
+
18
+ ## 三、契约版本管理(skill可选项,支持多选/自定义补充)
19
+ - 选项1:版本号 → 选项:v1.0/v2.0/v3.0 → 自定义版本:__________
20
+ - 选项2:版本说明 → 选项:新增接口/修改接口/删除接口 → 自定义说明:__________
21
+
22
+ ## 四、前后端约定(skill可选项,支持多选/自定义补充)
23
+ - 选项1:数据格式 → 选项:JSON/XML/form-data → 自定义格式:__________
24
+ - 选项2:编码方式 → 选项:UTF-8/GBK → 自定义编码:__________
25
+ - 选项3:超时时间 → 选项:5秒/10秒/30秒 → 自定义超时:__________
26
+
27
+ ## trae调用参数说明(仅trae触发时使用)
28
+ - 调用路径:skills/templates/API-SDD.md
29
+ - 必传参数:接口模块名称、API路径、请求方法
30
+ - 可选参数:认证方式、返回值说明补充内容
@@ -0,0 +1,37 @@
1
+ # Base-SDD:[项目名称]全局通用基线规范(skill选项式设计)
2
+ 【claude code调用标识:Base-SDD】【trae调用标识:Base-SDD+sdd】
3
+
4
+ ## 一、全局UI交互基线(skill可选项,支持多选/自定义补充)
5
+ - 选项1:设计系统版本 → 选项:Figma组件库v1.0/自研设计系统v2.0 → 自定义版本:__________
6
+ - 选项2:颜色规范 → 选项:品牌色+中性色组合/行业通用配色 → 自定义配色:__________
7
+ - 选项3:字体规范 → 选项:思源黑体(常规/粗体)/微软雅黑 → 自定义字体:__________
8
+ - 选项4:间距规范 → 选项:8px基准间距/16px基准间距 → 自定义间距:__________
9
+
10
+ ## 二、弹窗/浮层生命周期规范(skill可选项,支持多选/自定义补充)
11
+ - 选项1:弹窗打开规则 → 选项:点击触发/hover触发/自动弹出 → 自定义规则:__________
12
+ - 选项2:弹窗关闭规则 → 选项:点击关闭按钮/点击遮罩/ESC键关闭 → 自定义规则:__________
13
+ - 选项3:遮罩层行为 → 选项:遮罩可点击关闭/遮罩不可点击 → 自定义规则:__________
14
+ - 选项4:层级规范 → 选项:弹窗层级>遮罩层>页面内容 → 自定义层级:__________
15
+
16
+ ## 三、手势冲突通用规则(skill可选项,支持多选/自定义补充)
17
+ - 选项1:滑动冲突处理 → 选项:优先纵向滑动/优先横向滑动 → 自定义处理:__________
18
+ - 选项2:点击穿透处理 → 选项:添加遮罩防穿透/延迟点击判定 → 自定义处理:__________
19
+ - 选项3:双指缩放规则 → 选项:仅图片支持缩放/全页面支持缩放 → 自定义规则:__________
20
+
21
+ ## 四、通用编码规范(skill可选项,支持多选/自定义补充)
22
+ - 选项1:命名规范 → 选项:驼峰命名法/下划线命名法 → 自定义规范:__________
23
+ - 选项2:注释规范 → 选项:单行注释// /多行注释/* */ → 自定义规范:__________
24
+ - 选项3:代码风格 → 选项:ESLint标准/自定义代码风格 → 自定义风格:__________
25
+
26
+ ## 五、错误码规范(skill可选项,支持多选/自定义补充)
27
+ - 选项1:通用错误码 → 选项:000(成功)/100(参数错误)/200(系统错误) → 自定义错误码:__________
28
+ - 选项2:业务错误码 → 选项:300(用户相关)/400(功能相关) → 自定义错误码:__________
29
+
30
+ ## 六、安全规范(skill可选项,支持多选/自定义补充)
31
+ - 选项1:隐私数据处理 → 选项:加密存储/脱敏展示 → 自定义处理:__________
32
+ - 选项2:敏感信息脱敏 → 选项:手机号隐藏中间4位/身份证隐藏中间8位 → 自定义脱敏:__________
33
+
34
+ ## trae调用参数说明(仅trae触发时使用)
35
+ - 调用路径:skills/templates/Base-SDD.md
36
+ - 必传参数:项目名称、基线规范类型(如:UI交互/编码规范)
37
+ - 可选参数:自定义规范补充内容
@@ -0,0 +1,35 @@
1
+ # Brain-SDD:[项目名称]头脑风暴文档(skill选项式设计)
2
+ 【claude code调用标识:Brain-SDD】【trae调用标识:Brain-SDD+brainstorming】
3
+
4
+ ## 一、想法收集(skill可选项,支持多选/自定义补充)
5
+ - 选项1:基础功能类(如:语音记录、标签分类、定时提醒)
6
+ - 选项2:便捷交互类(如:快捷搜索、一键导出、云同步)
7
+ - 选项3:个性化类(如:主题切换、自定义布局)
8
+ - 选项4:自定义想法:__________
9
+
10
+ ## 二、初步脑洞(skill可选项,支持多选/自定义补充)
11
+ - 选项1:技术拓展类(如:手写识别、语音转文字)
12
+ - 选项2:场景延伸类(如:多设备互通、第三方工具联动)
13
+ - 选项3:创新功能类(如:智能分类、内容推荐)
14
+ - 选项4:自定义脑洞:__________
15
+
16
+ ## 三、废弃方案(skill可选项+原因填写,支持自定义)
17
+ - 选项1:方案:视频笔记 → 原因选项:使用场景少/开发复杂度高/偏离核心需求 → 自定义补充:__________
18
+ - 选项2:方案:多语言支持 → 原因选项:用户需求低/开发成本高 → 自定义补充:__________
19
+ - 选项3:自定义方案:__________ → 原因:__________
20
+
21
+ ## 四、灵感来源(skill可选项,支持多选/自定义补充)
22
+ - 选项1:竞品参考(如:某备忘录APP功能拆解,链接:__________)
23
+ - 选项2:用户需求反馈(描述:__________)
24
+ - 选项3:行业趋势(描述:__________)
25
+ - 选项4:自定义来源:__________
26
+
27
+ ## 五、风险初步评估(skill可选项+应对措施,支持自定义)
28
+ - 选项1:风险点:语音转文字准确率低 → 应对措施选项:选用成熟SDK/提前测试适配 → 自定义补充:__________
29
+ - 选项2:风险点:云同步稳定性差 → 应对措施选项:选择可靠云服务/增加异常处理 → 自定义补充:__________
30
+ - 选项3:自定义风险点:__________ → 应对措施:__________
31
+
32
+ ## trae调用参数说明(仅trae触发时使用)
33
+ - 调用路径:skills/templates/Brain-SDD.md
34
+ - 必传参数:项目名称、头脑风暴阶段(如:初期想法收集/脑洞筛选)
35
+ - 可选参数:自定义想法、自定义方案补充内容
@@ -0,0 +1,40 @@
1
+ # Code-SDD:[功能模块名称](skill选项式设计)
2
+ 【claude code调用标识:Code-SDD】【trae调用标识:Code-SDD+sdd-code】
3
+
4
+ ## 一、模块概述(skill可选项,支持多选/自定义补充)
5
+ - 选项1:模块类型 → 选项:核心业务模块/公共组件模块/工具模块 → 自定义类型:__________
6
+ - 选项2:核心功能 → 选项:数据处理/接口调用/业务逻辑实现 → 自定义功能:__________
7
+ - 选项3:关联模块 → 选项:用户模块/数据模块/UI模块 → 自定义关联模块:__________
8
+
9
+ ## 二、技术选型(skill可选项,支持多选/自定义补充)
10
+ - 选项1:开发语言 → 选项:JavaScript/TypeScript/Python → 自定义语言:__________
11
+ - 选项2:框架选型 → 选项:Vue/React/Node.js → 自定义框架:__________
12
+ - 选项3:工具依赖 → 选项:axios(接口请求)/lodash(工具函数)/jest(测试) → 自定义依赖:__________
13
+
14
+ ## 三、接口设计(skill可选项,支持多选/自定义补充)
15
+ - 选项1:接口类型 → 选项:GET(查询)/POST(提交)/PUT(修改)/DELETE(删除) → 自定义类型:__________
16
+ - 选项2:接口地址 → 选项:/api/xxx(示例) → 自定义地址:__________
17
+ - 选项3:请求参数 → 选项:参数1(类型:String,必填)/参数2(类型:Number,可选) → 自定义参数:__________
18
+ - 选项4:返回数据 → 选项:code(状态码)/data(数据)/message(提示信息) → 自定义返回:__________
19
+
20
+ ## 四、代码结构(skill可选项,支持多选/自定义补充)
21
+ - 选项1:目录结构 → 选项:src/xxx(模块目录)/index.js(入口文件)/utils.js(工具函数) → 自定义结构:__________
22
+ - 选项2:核心代码片段 → 选项:示例代码(可粘贴) → 自定义代码:__________
23
+
24
+ ## 五、异常处理(skill可选项,支持多选/自定义补充)
25
+ - 选项1:异常类型 → 选项:接口请求异常/数据处理异常/参数校验异常 → 自定义类型:__________
26
+ - 选项2:处理方案 → 选项:弹窗提示/日志记录/降级处理 → 自定义方案:__________
27
+
28
+ ## 六、技术债务记录(skill可选项,支持多选/自定义补充)
29
+ - 选项1:债务类型 → 选项:代码冗余/注释缺失/逻辑不清晰 → 自定义类型:__________
30
+ - 选项2:处理计划 → 选项:迭代优化/后续重构/暂时保留 → 自定义计划:__________
31
+
32
+ ## 七、关联技能调用(skill可选项,支持多选/自定义补充)
33
+ - 选项1:开发阶段调用 → 选项:test-driven-development(TDD开发)/sdd-add(快速迭代) → 自定义调用:__________
34
+ - 选项2:质量校验调用 → 选项:quality-gate(质量门禁)/security-audit(安全审计) → 自定义调用:__________
35
+ - 选项3:代码审查调用 → 选项:requesting-code-review(请求代码审查)/receiving-code-review(接收代码审查) → 自定义调用:__________
36
+
37
+ ## trae调用参数说明(仅trae触发时使用)
38
+ - 调用路径:skills/templates/Code-SDD.md
39
+ - 必传参数:功能模块名称、开发语言、核心功能
40
+ - 可选参数:接口设计、代码结构补充内容
@@ -0,0 +1,33 @@
1
+ # Competitor-SDD:[项目名称]竞品分析文档(skill选项式设计)
2
+ 【claude code调用标识:Competitor-SDD】【trae调用标识:Competitor-SDD+market-research/competitive-brief】
3
+
4
+ ## 一、竞品列表(skill可选项,支持多选/自定义补充)
5
+ - 选项1:竞品类型 → 选项:直接竞品/间接竞品/潜在竞品 → 自定义类型:__________
6
+ - 选项2:竞品名称及核心功能 → 选项1:竞品A(核心功能:__________) → 选项2:竞品B(核心功能:__________) → 自定义竞品:__________(核心功能:__________)
7
+
8
+ ## 二、功能对比(skill可选项,支持多选/自定义补充)
9
+ - 选项1:核心功能点 → 选项:基础功能/便捷功能/创新功能 → 自定义功能点:__________
10
+ - 选项2:对比维度 → 选项:功能完整性/交互体验/性能表现 → 自定义维度:__________
11
+ - 选项3:对比结果填写 → 选项:竞品A优于我方/我方优于竞品A/两者持平 → 自定义结果:__________
12
+
13
+ ## 三、优缺点分析(skill可选项,支持多选/自定义补充)
14
+ ### 竞品A(可替换为具体竞品)
15
+ - 优点选项:选项1:功能全面/选项2:交互流畅/选项3:性能稳定 → 自定义优点:__________
16
+ - 缺点选项:选项1:操作复杂/选项2:功能冗余/选项3:兼容性差 → 自定义缺点:__________
17
+
18
+ ## 四、可借鉴点(skill可选项,支持多选/自定义补充)
19
+ - 选项1:功能借鉴 → 选项:竞品的XX功能/竞品的交互逻辑 → 自定义借鉴点:__________
20
+ - 选项2:技术借鉴 → 选项:竞品的实现方式/竞品的优化思路 → 自定义借鉴点:__________
21
+
22
+ ## 五、避坑点(skill可选项,支持多选/自定义补充)
23
+ - 选项1:功能避坑 → 选项:竞品未做好的XX功能/用户反馈差的功能 → 自定义避坑点:__________
24
+ - 选项2:技术避坑 → 选项:竞品存在的性能问题/兼容性问题 → 自定义避坑点:__________
25
+
26
+ ## 六、差异化机会(skill可选项,支持多选/自定义补充)
27
+ - 选项1:功能差异化 → 选项:补充竞品缺失的功能/优化竞品不足的功能 → 自定义机会:__________
28
+ - 选项2:体验差异化 → 选项:优化交互流程/提升操作便捷性 → 自定义机会:__________
29
+
30
+ ## trae调用参数说明(仅trae触发时使用)
31
+ - 调用路径:skills/templates/Competitor-SDD.md
32
+ - 必传参数:项目名称、竞品类型、竞品名称
33
+ - 可选参数:对比维度、可借鉴点补充内容
@@ -0,0 +1,36 @@
1
+ # Env-SDD:[项目名称]环境配置文档(skill选项式设计)
2
+ 【claude code调用标识:Env-SDD】【trae调用标识:Env-SDD+sdd-deploy/sdd-ops】
3
+
4
+ ## 一、环境列表(skill可选项,支持多选/自定义补充)
5
+ - 选项1:环境类型 → 选项:开发环境/测试环境/预发环境/生产环境 → 自定义类型:__________
6
+ - 选项2:环境URL → 选项:http://localhost:3000(开发)/https://test.example.com(测试) → 自定义URL:__________
7
+ - 选项3:环境用途 → 选项:开发调试/功能测试/回归测试/正式上线 → 自定义用途:__________
8
+
9
+ ## 二、权限配置(skill可选项,支持多选/自定义补充)
10
+ - 选项1:权限类型 → 选项:管理员权限/开发权限/测试权限/只读权限 → 自定义类型:__________
11
+ - 选项2:权限范围 → 选项:全部权限/部分权限/特定模块权限 → 自定义范围:__________
12
+
13
+ ## 三、SDK配置(skill可选项,支持多选/自定义补充)
14
+ - 选项1:SDK类型 → 选项:前端SDK/后端SDK/移动端SDK → 自定义类型:__________
15
+ - 选项2:SDK版本 → 选项:v1.0/v2.0/v3.0 → 自定义版本:__________
16
+
17
+ ## 四、APIKey管理(skill可选项,支持多选/自定义补充)
18
+ - 选项1:Key类型 → 选项:测试Key/生产Key/临时Key → 自定义类型:__________
19
+ - 选项2:Key用途 → 选项:内部调用/第三方调用/测试调用 → 自定义用途:__________
20
+
21
+ ## 五、原生工程配置(skill可选项,支持多选/自定义补充)
22
+ - 选项1:工程类型 → 选项:iOS工程/Android工程/Flutter工程 → 自定义类型:__________
23
+ - 选项2:配置内容 → 选项:签名配置/权限配置/依赖配置 → 自定义内容:__________
24
+
25
+ ## 六、隐私配置(skill可选项,支持多选/自定义补充)
26
+ - 选项1:隐私类型 → 选项:用户隐私/数据隐私/日志隐私 → 自定义类型:__________
27
+ - 选项2:处理方式 → 选项:加密存储/脱敏展示/定期清理 → 自定义处理:__________
28
+
29
+ ## 七、敏感信息管理(不提交代码库)(skill可选项,支持多选/自定义补充)
30
+ - 选项1:敏感类型 → 选项:密码/密钥/证书 → 自定义类型:__________
31
+ - 选项2:管理方式 → 选项:环境变量/密钥管理服务/配置中心 → 自定义管理:__________
32
+
33
+ ## trae调用参数说明(仅trae触发时使用)
34
+ - 调用路径:skills/templates/Env-SDD.md
35
+ - 必传参数:项目名称、环境类型、环境URL
36
+ - 可选参数:权限配置、敏感信息管理补充内容
@@ -0,0 +1,44 @@
1
+ # PRD-SDD:[项目名称]产品需求文档(skill选项式设计)
2
+ 【claude code调用标识:PRD-SDD】【trae调用标识:PRD-SDD+prd-write/requirement-completion-officer】
3
+
4
+ ## 一、需求背景(skill可选项,支持多选/自定义补充)
5
+ - 选项1:需求来源 → 选项:用户反馈/市场需求/业务规划 → 自定义来源:__________
6
+ - 选项2:需求目的 → 选项:提升用户体验/完善功能闭环/解决核心痛点 → 自定义目的:__________
7
+ - 选项3:需求优先级 → 选项:P0(核心)/P1(重要)/P2(一般) → 自定义优先级:__________
8
+
9
+ ## 二、用户角色定义(skill可选项,支持多选/自定义补充)
10
+ - 选项1:核心用户 → 选项:普通用户/管理员/运营人员 → 自定义用户:__________
11
+ - 选项2:用户特征 → 选项:年轻用户(18-25岁)/职场用户(25-35岁) → 自定义特征:__________
12
+ - 选项3:用户需求 → 选项:便捷操作/功能全面/性能稳定 → 自定义需求:__________
13
+
14
+ ## 三、用户旅程梳理(skill可选项,支持多选/自定义补充)
15
+ - 选项1:用户场景 → 选项:首次使用/日常使用/异常场景 → 自定义场景:__________
16
+ - 选项2:旅程步骤 → 选项:进入页面→操作功能→完成目标→退出页面 → 自定义步骤:__________
17
+ - 选项3:痛点梳理 → 选项:操作繁琐/等待时间长/功能不清晰 → 自定义痛点:__________
18
+
19
+ ## 四、功能范围界定(skill可选项,支持多选/自定义补充)
20
+ - 选项1:必做功能 → 选项:核心功能1/核心功能2 → 自定义必做功能:__________
21
+ - 选项2:可选功能 → 选项:拓展功能1/拓展功能2 → 自定义可选功能:__________
22
+ - 选项3:不做功能 → 选项:非核心功能/场景需求低的功能 → 自定义不做功能:__________
23
+
24
+ ## 五、需求补全清单(skill可选项,支持多选/自定义补充)
25
+ - 选项1:补全类型 → 选项:场景补全/逻辑补全/异常处理补全 → 自定义补全类型:__________
26
+ - 选项2:补全内容 → 选项:补充XX场景的操作流程/完善XX逻辑的异常处理 → 自定义补全内容:__________
27
+
28
+ ## 六、主干流程(skill可选项,支持多选/自定义补充)
29
+ - 选项1:流程类型 → 选项:正常流程/异常流程/分支流程 → 自定义流程类型:__________
30
+ - 选项2:流程步骤 → 选项:步骤1→步骤2→步骤3→完成 → 自定义步骤:__________
31
+
32
+ ## 七、架构&模块拆分(附录)(skill可选项,支持多选/自定义补充)
33
+ - 选项1:架构类型 → 选项:前后端分离架构/单体架构 → 自定义架构:__________
34
+ - 选项2:模块拆分 → 选项:用户模块/功能模块/数据模块 → 自定义模块:__________
35
+
36
+ ## 八、验收标准(skill可选项,支持多选/自定义补充)
37
+ - 选项1:功能验收 → 选项:功能正常运行/符合需求描述 → 自定义验收:__________
38
+ - 选项2:体验验收 → 选项:交互流畅/操作便捷 → 自定义验收:__________
39
+ - 选项3:性能验收 → 选项:响应时间≤1s/无卡顿 → 自定义验收:__________
40
+
41
+ ## trae调用参数说明(仅trae触发时使用)
42
+ - 调用路径:skills/templates/PRD-SDD.md
43
+ - 必传参数:项目名称、需求优先级、核心用户
44
+ - 可选参数:功能范围、验收标准补充内容
@@ -0,0 +1,33 @@
1
+ # Test-SDD:[测试模块名称](skill选项式设计)
2
+ 【claude code调用标识:Test-SDD】【trae调用标识:Test-SDD+sdd-test】
3
+
4
+ ## 一、测试策略(skill可选项,支持多选/自定义补充)
5
+ - 选项1:测试类型 → 选项:单元测试/集成测试/E2E测试/性能测试/安全测试 → 自定义类型:__________
6
+ - 选项2:测试范围 → 选项:全部模块/核心模块/新增功能 → 自定义范围:__________
7
+ - 选项3:测试环境 → 选项:测试环境/预发环境/生产环境(灰度) → 自定义环境:__________
8
+
9
+ ## 二、测试用例(skill可选项,支持多选/自定义补充)
10
+ - 选项1:用例类型 → 选项:正常流程用例/异常流程用例/边界条件用例 → 自定义类型:__________
11
+ - 选项2:用例内容 → 选项:测试场景:__________ / 预期结果:__________ → 自定义内容:__________
12
+
13
+ ## 三、测试数据(skill可选项,支持多选/自定义补充)
14
+ - 选项1:数据类型 → 选项:正常数据/边界数据/异常数据 → 自定义类型:__________
15
+ - 选项2:数据来源 → 选项:Mock数据/真实数据/测试数据生成器 → 自定义来源:__________
16
+
17
+ ## 四、测试覆盖率目标(skill可选项,支持多选/自定义补充)
18
+ - 选项1:单元测试覆盖率 → 选项:≥80%/≥90%/≥95% → 自定义覆盖率:__________
19
+ - 选项2:集成测试覆盖率 → 选项:≥70%/≥80%/≥85% → 自定义覆盖率:__________
20
+
21
+ ## 五、性能测试指标(skill可选项,支持多选/自定义补充)
22
+ - 选项1:响应时间 → 选项:≤100ms/≤500ms/≤1s → 自定义时间:__________
23
+ - 选项2:并发数 → 选项:100/1000/10000 → 自定义并发:__________
24
+ - 选项3:成功率 → 选项:≥99%/≥99.9%/≥99.99% → 自定义成功率:__________
25
+
26
+ ## 六、安全测试要点(skill可选项,支持多选/自定义补充)
27
+ - 选项1:测试项 → 选项:SQL注入/XSS攻击/CSRF攻击/接口越权 → 自定义测试项:__________
28
+ - 选项2:测试工具 → 选项:OWASP ZAP/Nessus/Burp Suite → 自定义工具:__________
29
+
30
+ ## trae调用参数说明(仅trae触发时使用)
31
+ - 调用路径:skills/templates/Test-SDD.md
32
+ - 必传参数:测试模块名称、测试类型、测试范围
33
+ - 可选参数:测试用例、测试数据补充内容
@@ -0,0 +1,37 @@
1
+ # UI-SDD:[页面/组件名称](skill选项式设计)
2
+ 【claude code调用标识:UI-SDD】【trae调用标识:UI-SDD+ui-sdd】
3
+
4
+ ## 一、页面/组件概述(skill可选项,支持多选/自定义补充)
5
+ - 选项1:页面/组件类型 → 选项:首页/详情页/按钮组件/弹窗组件 → 自定义类型:__________
6
+ - 选项2:核心用途 → 选项:展示内容/接收操作/提示信息 → 自定义用途:__________
7
+ - 选项3:所属模块 → 选项:用户模块/功能模块/公共模块 → 自定义模块:__________
8
+
9
+ ## 二、Figma链接(skill可选项,支持多选/自定义补充)
10
+ - 选项1:完整设计稿链接 → 选项:填写Figma链接/填写备用导出文件链接 → 自定义链接:__________
11
+ - 选项2:关键截图 → 选项:上传截图/填写截图路径 → 自定义截图:__________
12
+ - 选项3:备用方案(链接失效时) → 选项:上传PDF标注文件/上传PNG标注文件 → 自定义备用方案:__________
13
+
14
+ ## 三、页面结构(skill可选项,支持多选/自定义补充)
15
+ - 选项1:结构类型 → 选项:上下布局/左右布局/混合布局 → 自定义结构:__________
16
+ - 选项2:核心模块 → 选项:头部导航/内容区域/底部信息 → 自定义模块:__________
17
+
18
+ ## 四、组件清单(skill可选项,支持多选/自定义补充)
19
+ - 选项1:组件类型 → 选项:基础组件(按钮/输入框)/业务组件(表单/列表) → 自定义组件:__________
20
+ - 选项2:组件数量 → 选项:≤5个/5-10个/>10个 → 自定义数量:__________
21
+
22
+ ## 五、交互流程(skill可选项,支持多选/自定义补充)
23
+ - 选项1:交互类型 → 选项:点击交互/滑动交互/hover交互 → 自定义交互:__________
24
+ - 选项2:交互反馈 → 选项:弹窗提示/状态变化/跳转页面 → 自定义反馈:__________
25
+
26
+ ## 六、状态设计(skill可选项,支持多选/自定义补充)
27
+ - 选项1:组件状态 → 选项:正常状态/ hover状态/禁用状态/选中状态 → 自定义状态:__________
28
+ - 选项2:页面状态 → 选项:正常状态/加载状态/空状态/异常状态 → 自定义状态:__________
29
+
30
+ ## 七、设计规范(对齐Base-SDD)(skill可选项,支持多选/自定义补充)
31
+ - 选项1:对齐规范 → 选项:对齐Base-SDD颜色规范/对齐Base-SDD字体规范 → 自定义对齐:__________
32
+ - 选项2:偏差说明 → 选项:无偏差/有偏差(说明:__________) → 自定义说明:__________
33
+
34
+ ## trae调用参数说明(仅trae触发时使用)
35
+ - 调用路径:skills/templates/UI-SDD.md
36
+ - 必传参数:页面/组件名称、所属模块、Figma链接(或备用文件路径)
37
+ - 可选参数:组件清单、交互流程补充内容
@@ -344,7 +344,63 @@ systematic-debugging → sdd-add → verification-before-completion → quality-
344
344
 
345
345
  ---
346
346
 
347
+ ---
348
+
349
+ ## SDD融合框架(新增)
350
+
351
+ ### 9份标准化SDD模板
352
+
353
+ | 模板名称 | 核心内容 | 适用技能 |
354
+ |---------|---------|---------|
355
+ | **Base-SDD** | 全局通用基线规范 | sdd, sdd-full |
356
+ | **Brain-SDD** | 头脑风暴文档 | brainstorming |
357
+ | **Competitor-SDD** | 竞品分析文档 | competitive-brief, market-research |
358
+ | **PRD-SDD** | 产品需求文档 | prd-write, requirement-completion-officer |
359
+ | **UI-SDD** | UI设计文档 | ui-sdd |
360
+ | **Code-SDD** | 代码实现文档 | sdd-code, test-driven-development |
361
+ | **API-SDD** | 接口设计文档 | sdd(接口拆分) |
362
+ | **Env-SDD** | 环境配置文档 | sdd-deploy, sdd-ops |
363
+ | **Test-SDD** | 测试设计文档 | sdd-test, test-driven-development |
364
+
365
+ ### 强制顺序流水线
366
+
367
+ ```
368
+ 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
369
+ ```
370
+
371
+ ### Bug修复流程(SDD融合版)
372
+
373
+ ```
374
+ 1. systematic-debugging → 更新Code-SDD技术债务记录
375
+
376
+ 2. Test-SDD补充回归用例 → 关联bug编号
377
+
378
+ 3. sdd-add修复 → 更新Code-SDD/API-SDD/Env-SDD
379
+
380
+ 4. verification-before-completion → 更新Test-SDD测试结果
381
+
382
+ 5. quality-gate → 校验所有SDD规范一致性
383
+
384
+ 6. claudeception → 更新技术债务/经验沉淀章节
385
+ ```
386
+
387
+ ### 精简流程判定标准
388
+
389
+ 满足任意2条即可使用精简流程:
390
+ - 开发周期≤1天,代码量≤500行
391
+ - 不涉及新接口、新UI组件,仅修改现有逻辑/文案
392
+ - 无复杂交互,不影响全局流程
393
+
394
+ ### 模板版本锁定规则
395
+
396
+ - 所有SDD模板版本化管理
397
+ - 每个项目绑定固定模板版本,不随意自动升级
398
+ - 通过`template-version.lock`文件记录版本信息
399
+
400
+ ---
401
+
347
402
  ## 更新日志
403
+ - v4.0(2026-05-06):新增SDD融合框架,9份标准化模板,强制顺序流水线,Bug修复流程融合
348
404
  - v3.0(2026-05-05):发布到npm包,新增npx安装方式,支持Trae/Trae-cn/Claude Code多环境安装
349
405
  - v2.0(2026-05-04):更新技能列表,匹配当前实际存在的技能
350
406
  - v1.0(2024-05-04):初始版本,完整流程定义
@@ -238,7 +238,65 @@
238
238
 
239
239
  ---
240
240
 
241
+ ---
242
+
243
+ ## SDD融合框架(新增)
244
+
245
+ ### 一、9份标准化SDD模板
246
+
247
+ | 模板名称 | 核心内容 | 适用技能 |
248
+ |---------|---------|---------|
249
+ | **Base-SDD** | 全局通用基线规范 | sdd, sdd-full |
250
+ | **Brain-SDD** | 头脑风暴文档 | brainstorming |
251
+ | **Competitor-SDD** | 竞品分析文档 | competitive-brief, market-research |
252
+ | **PRD-SDD** | 产品需求文档 | prd-write, requirement-completion-officer |
253
+ | **UI-SDD** | UI设计文档 | ui-sdd |
254
+ | **Code-SDD** | 代码实现文档 | sdd-code, test-driven-development |
255
+ | **API-SDD** | 接口设计文档 | sdd(接口拆分) |
256
+ | **Env-SDD** | 环境配置文档 | sdd-deploy, sdd-ops |
257
+ | **Test-SDD** | 测试设计文档 | sdd-test, test-driven-development |
258
+
259
+ ### 二、更新后的技能体系架构
260
+
261
+ ```
262
+ ┌─────────────────────────────────────────────────────────────────┐
263
+ │ 需求层 | brainstorming, market-research, competitive-brief, prd-write, requirement-completion-officer, sdd, sdd-full │
264
+ ├─────────────────────────────────────────────────────────────────┤
265
+ │ 设计层 | ui-sdd, sdd-code, sdd-test, sdd-deploy, sdd-ops, writing-plans, Base-SDD │
266
+ ├─────────────────────────────────────────────────────────────────┤
267
+ │ 交付层 | sdd-add, test-driven-development, systematic-debugging, verification-before-completion, quality-gate, security-audit, finishing-a-development-branch, release-flow, API-SDD, Env-SDD, Test-SDD │
268
+ ├─────────────────────────────────────────────────────────────────┤
269
+ │ 沉淀层 | claudeception, mempalace-auto-saver, using-superpowers, requesting-code-review, receiving-code-review │
270
+ └─────────────────────────────────────────────────────────────────┘
271
+ ```
272
+
273
+ ### 三、全流程SDD融合
274
+
275
+ | 流程 | 对应技能 | 对应SDD模板 |
276
+ |------|---------|------------|
277
+ | SDD模板适配 | sdd, sdd-full | 所有9份模板 |
278
+ | Figma设计接入 | ui-sdd | UI-SDD |
279
+ | AI协作 | brainstorming, competitive-brief, prd-write等 | 所有模板 |
280
+ | 开发测试 | sdd-code, sdd-test, test-driven-development | Code-SDD, API-SDD, Test-SDD |
281
+ | bug修复 | systematic-debugging, sdd-add | Code-SDD, Test-SDD |
282
+ | 版本锁定 | sdd-full | template-version.lock |
283
+ | 归档管理 | release-flow, mempalace-auto-saver | sdd-archive |
284
+
285
+ ### 四、风险评估补充
286
+
287
+ | 风险点 | 描述 | 应对措施 |
288
+ |-------|------|---------|
289
+ | AI适配风险 | AI生成内容不符合规范 | 人工校验核心规范、固定提示词模板、关键环节二次确认 |
290
+ | bug修复流程风险 | 修复后未同步更新SDD | 嵌入SDD体系、强制补充回归用例、AI协助校验 |
291
+ | Figma接入风险 | 链接解析失败无备用方案 | 强制同步上传PDF/PNG、AI自动校验可访问性 |
292
+ | 版本管理风险 | 版本混乱追溯困难 | 强制绑定版本、AI记录更新日志、归档版本文件 |
293
+ | 归档管理风险 | 文档丢失查询困难 | 明确归档时机、统一命名规范、定期校验完整性 |
294
+ | 流程过重风险 | 9份SDD模板繁琐 | 提供精简版迷你流程,小需求可合并部分SDD |
295
+
296
+ ---
297
+
241
298
  ## 更新日志
299
+ - v5.0(2026-05-06):新增SDD融合框架,9份标准化模板,全流程SDD融合体系,扩展风险评估
242
300
  - v4.0(2026-05-05):发布到npm包,新增npx安装方式,支持Trae/Trae-cn/Claude Code多环境安装
243
301
  - v3.0(2026-05-04):更新技能列表,标记为已完整
244
302
  - v2.0(2024-05-04):重构为个人开发版
@@ -219,7 +219,44 @@ A:看「技能决策树.md」文档,按场景快速选择。
219
219
 
220
220
  ---
221
221
 
222
+ ---
223
+
224
+ ## SDD融合框架(新增)
225
+
226
+ ### 9份标准化SDD模板
227
+
228
+ | 模板名称 | 核心内容 | 适用技能 |
229
+ |---------|---------|---------|
230
+ | **Base-SDD** | 全局通用基线规范 | sdd, sdd-full |
231
+ | **Brain-SDD** | 头脑风暴文档 | brainstorming |
232
+ | **Competitor-SDD** | 竞品分析文档 | competitive-brief, market-research |
233
+ | **PRD-SDD** | 产品需求文档 | prd-write, requirement-completion-officer |
234
+ | **UI-SDD** | UI设计文档 | ui-sdd |
235
+ | **Code-SDD** | 代码实现文档 | sdd-code, test-driven-development |
236
+ | **API-SDD** | 接口设计文档 | sdd(接口拆分) |
237
+ | **Env-SDD** | 环境配置文档 | sdd-deploy, sdd-ops |
238
+ | **Test-SDD** | 测试设计文档 | sdd-test, test-driven-development |
239
+
240
+ ### AI协作规范
241
+
242
+ | 阶段 | AI职责 | 人工校验要求 |
243
+ |------|--------|-------------|
244
+ | Brain-SDD | 发散想法、评估风险 | 确认想法合理性 |
245
+ | Competitor-SDD | 收集竞品信息、对比差异 | 确认分析准确性 |
246
+ | PRD-SDD | 补全需求、梳理用户旅程 | 必须人工二次确认 |
247
+ | Code-SDD | 编写测试用例、排查Bug | 确认代码规范 |
248
+ | 所有阶段 | 协助整理归档 | 校验完整性 |
249
+
250
+ ### Figma接入规范
251
+
252
+ - Figma链接失效时启用PDF/PNG备用文件
253
+ - 关键截图需标注核心尺寸(按钮大小、间距)
254
+ - UI-SDD中必须同时包含链接和备用文件
255
+
256
+ ---
257
+
222
258
  ## 更新日志
259
+ - v5.0(2026-05-06):新增SDD融合框架,9份标准化模板,AI协作规范,Figma接入规范
223
260
  - v4.0(2026-05-05):发布到npm包,新增npx安装方式,支持Trae/Trae-cn/Claude Code多环境安装
224
261
  - v3.0(2026-05-04):更新技能列表,匹配当前实际存在的技能
225
262
  - v2.0(2024-05-04):重构为个人开发版,去掉团队协作内容,完善sdd-code说明
@@ -229,7 +229,47 @@ claudeception → mempalace-auto-saver
229
229
 
230
230
  ---
231
231
 
232
+ ---
233
+
234
+ ## SDD融合框架(新增)
235
+
236
+ ### 9份标准化SDD模板
237
+
238
+ | 模板名称 | 核心内容 | 适用技能 |
239
+ |---------|---------|---------|
240
+ | **Base-SDD** | 全局通用基线规范 | sdd, sdd-full |
241
+ | **Brain-SDD** | 头脑风暴文档 | brainstorming |
242
+ | **Competitor-SDD** | 竞品分析文档 | competitive-brief, market-research |
243
+ | **PRD-SDD** | 产品需求文档 | prd-write, requirement-completion-officer |
244
+ | **UI-SDD** | UI设计文档 | ui-sdd |
245
+ | **Code-SDD** | 代码实现文档 | sdd-code, test-driven-development |
246
+ | **API-SDD** | 接口设计文档 | sdd(接口拆分) |
247
+ | **Env-SDD** | 环境配置文档 | sdd-deploy, sdd-ops |
248
+ | **Test-SDD** | 测试设计文档 | sdd-test, test-driven-development |
249
+
250
+ ### 强制顺序流水线
251
+
252
+ ```
253
+ 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
254
+ ```
255
+
256
+ ### Bug修复流程(SDD融合版)
257
+
258
+ ```
259
+ systematic-debugging → Test-SDD补充回归用例 → sdd-add修复 → verification-before-completion → quality-gate → claudeception
260
+ ```
261
+
262
+ ### 精简流程判定标准
263
+
264
+ 满足任意2条即可使用精简流程:
265
+ - 开发周期≤1天,代码量≤500行
266
+ - 不涉及新接口、新UI组件,仅修改现有逻辑/文案
267
+ - 无复杂交互,不影响全局流程
268
+
269
+ ---
270
+
232
271
  ## 更新日志
272
+ - v5.0(2026-05-06):新增SDD融合框架,9份标准化模板,全流程SDD融合体系
233
273
  - v4.0(2026-05-05):发布到npm包,新增npx安装方式,支持Trae/Trae-cn/Claude Code多环境安装
234
274
  - v3.0(2026-05-04):更新技能列表,匹配当前实际存在的技能
235
275
  - v2.0(2024-05-04):重构为个人开发版,去掉团队协作内容,新增更多技能选项