sdd-full 3.1.0 → 3.2.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 (14) hide show
  1. package/package.json +1 -1
  2. package/skills/sdd-framework/SKILL.md +22 -14
  3. package/skills/sdd-framework/API-SDD-template.md +0 -26
  4. package/skills/sdd-framework/Base-SDD-template.md +0 -36
  5. package/skills/sdd-framework/Brain-SDD-template.md +0 -29
  6. package/skills/sdd-framework/Code-SDD-template.md +0 -29
  7. package/skills/sdd-framework/Competitor-SDD-template.md +0 -38
  8. package/skills/sdd-framework/Env-SDD-template.md +0 -29
  9. package/skills/sdd-framework/PRD-SDD-template.md +0 -35
  10. package/skills/sdd-framework/Test-SDD-template.md +0 -26
  11. package/skills/sdd-framework/UI-SDD-template.md +0 -31
  12. package/skills/sdd-framework/figma-spec.md +0 -27
  13. package/skills/sdd-framework/flow-charts.md +0 -99
  14. package/skills/sdd-framework/template-version.lock +0 -14
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "sdd-full",
3
- "version": "3.1.0",
3
+ "version": "3.2.0",
4
4
  "description": "SDD Full - 完整的软件设计开发技能包",
5
5
  "main": "index.js",
6
6
  "bin": "./bin.js",
package/skills/sdd-framework/SKILL.md CHANGED
@@ -2,16 +2,18 @@
2
2
 
3
3
  ---
4
4
  name: sdd-framework
5
- description: SDD融合框架 - 9份标准化SDD模板，覆盖从全局基线到测试的全流程
5
+ description: SDD融合框架 - 标准化SDD模板管理，覆盖从全局基线到测试的全流程
6
6
  ---
7
7
 
8
8
  # SDD融合框架
9
9
 
10
10
  ## 概述
11
11
 
12
- 本框架提供9份标准化SDD模板，将头脑风暴、竞品分析、PRD、UI设计、代码实现、API设计、环境配置、测试设计等环节纳入文档化管理，形成纯文档闭环。
12
+ 本框架提供标准化SDD模板管理，将头脑风暴、竞品分析、PRD、UI设计、代码实现、API设计、环境配置、测试设计等环节纳入文档化管理，形成纯文档闭环。
13
13
 
14
- ## 9份SDD模板
14
+ ## SDD模板清单
15
+
16
+ 模板统一存放在 `skills/templates/` 目录：
15
17
 
16
18
  | 模板名称 | 核心内容 | 适用技能 |
17
19
  |---------|---------|---------|
@@ -25,6 +27,22 @@ description: SDD融合框架 - 9份标准化SDD模板，覆盖从全局基线到
25
27
  | **Env-SDD** | 环境配置文档 | sdd-deploy, sdd-ops |
26
28
  | **Test-SDD** | 测试设计文档 | sdd-test, test-driven-development |
27
29
 
30
+ ## 专项SDD模板
31
+
32
+ | 模板名称 | 核心内容 | 适用场景 |
33
+ |---------|---------|---------|
34
+ | **UI-SDD专用模板** | UI设计稿结构化、交付标准 | UI设计阶段 |
35
+ | **功能SDD专用模板** | 业务功能专属模板 | 功能开发 |
36
+ | **BDD风格验收标准SDD** | BDD验收句式、准入/准出标准 | 测试验收 |
37
+ | **环境预检标准化SDD** | 本机配置、依赖版本、网络预检 | 项目启动 |
38
+ | **Flutter地图导航业务SDD** | 高德SDK集成、Marker处理 | 地图开发 |
39
+ | **Flutter音视频全栈SDD** | 离线ASR、TTS、OCR接入 | 音视频功能 |
40
+ | **Flutter全类型测试策略SDD** | Golden测试、E2E、TDD、冒烟测试 | 测试策略 |
41
+ | **Flutter常见异常专项SDD** | SocketException、渲染异常排查 | Bug修复 |
42
+ | **企业级全栈工程规范SDD** | 项目目录、版本管理、交付标准 | 工程规范 |
43
+ | **Andrej Karpathy AI编码规则SDD** | 编码约束、禁止自由发挥 | 编码规范 |
44
+ | **高保真设计转代码SDD** | Rive动画、Figma转Flutter | 设计转代码 |
45
+
28
46
  ## 强制顺序流水线
29
47
 
30
48
  ```
@@ -56,16 +74,6 @@ Base-SDD → Brain-SDD → Competitor-SDD → PRD-SDD → Figma设计 → UI-SDD
56
74
  - 不涉及新接口、新UI组件
57
75
  - 无复杂交互，不影响全局流程
58
76
 
59
- ## 模板版本管理
60
-
61
- 所有模板采用版本化管理，通过`template-version.lock`文件记录版本信息，每个项目绑定固定版本，避免版本混乱。
62
-
63
- ## Figma接入规范
64
-
65
- - Figma链接失效时启用PDF/PNG备用文件
66
- - 关键截图需标注核心尺寸
67
- - UI-SDD中必须同时包含链接和备用文件
68
-
69
77
  ## AI协作规范
70
78
 
71
79
  | 阶段 | AI职责 | 人工校验要求 |
@@ -78,5 +86,5 @@ Base-SDD → Brain-SDD → Competitor-SDD → PRD-SDD → Figma设计 → UI-SDD
78
86
 
79
87
  ---
80
88
 
81
- **模板版本**: v4.1
89
+ **模板版本**: v5.0
82
90
  **适用场景**: 个人+AI开发模式的完整文档化流程
package/skills/sdd-framework/API-SDD-template.md DELETED
@@ -1,26 +0,0 @@
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（接口拆分）
package/skills/sdd-framework/Base-SDD-template.md DELETED
@@ -1,36 +0,0 @@
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
package/skills/sdd-framework/Brain-SDD-template.md DELETED
@@ -1,29 +0,0 @@
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
package/skills/sdd-framework/Code-SDD-template.md DELETED
@@ -1,29 +0,0 @@
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
package/skills/sdd-framework/Competitor-SDD-template.md DELETED
@@ -1,38 +0,0 @@
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
package/skills/sdd-framework/Env-SDD-template.md DELETED
@@ -1,29 +0,0 @@
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
package/skills/sdd-framework/PRD-SDD-template.md DELETED
@@ -1,35 +0,0 @@
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
package/skills/sdd-framework/Test-SDD-template.md DELETED
@@ -1,26 +0,0 @@
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
package/skills/sdd-framework/UI-SDD-template.md DELETED
@@ -1,31 +0,0 @@
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
package/skills/sdd-framework/figma-spec.md DELETED
@@ -1,27 +0,0 @@
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
package/skills/sdd-framework/flow-charts.md DELETED
@@ -1,99 +0,0 @@
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 |
package/skills/sdd-framework/template-version.lock DELETED
@@ -1,14 +0,0 @@
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
- }