sdd-full 4.2.0 → 4.3.1

package/skills/requirement-analysis/unified-flow/SKILL.md

@@ -1,45 +1,147 @@
-# unified-flow - 统一流程入口
+【claude code调用标识：unified-flow】【trae调用标识：unified-flow+综合开发流程】【流程场景：2.从零开始新项目、3.小型功能迭代、4.Bug处理、5.代码发布】
+
+---
+name: unified-flow
+description: "综合开发流程 - 提供4个流程选项：从零开始新项目、小型功能迭代、Bug处理、代码发布"
+---
+
+# 综合开发流程
+
+<TRIGGER-WORDS>
+- 从零开始新项目
+- 我现在要做新项目
+- 新项目启动
+- 从零开始
+- 创建新项目
+- 我现在要做小型功能迭代
+- 功能迭代
+- 小型迭代
+- 快速迭代
+- 新增小功能
+- 我现在要处理Bug
+- 处理Bug
+- 修复Bug
+- Bug修复
+- 调试Bug
+- 我现在要发布代码
+- 发布代码
+- 代码发布
+- 部署上线
+- 发布上线
+- 启动开发流程
+- 开始开发
+</TRIGGER-WORDS>
+
+## 🎯 流程选项
+
+请选择您要使用的流程：
 
-## 功能说明
+```
+1. 从零开始新项目
+2. 小型功能迭代
+3. Bug处理
+4. 代码发布
+```
 
-提供完整的软件开发流程管理，支持新项目启动、功能迭代、Bug修复和代码发布四种核心场景。
+---
 
-## 触发词
+## 1. 从零开始新项目
 
-`/flow`、`流程`、`开发流程`、`项目流程`、`迭代流程`
+```
+1. 市场调研/头脑风暴（可选，如需要创意/调研）
+   ↓
+2. PRD编写（可选，写PRD）
+   ↓
+3. 需求补全（可选，requirement-completion-officer）
+   ↓
+4. SDD拆分（sdd/sdd-full）
+   ↓
+5. UI设计（可选，ui-sdd）
+   ↓
+6. 实现拆分（sdd-code，含代码规范、技术债务、重构计划）
+   ↓
+7. 测试设计（sdd-test）
+   ↓
+8. 部署设计（可选，sdd-deploy）
+   ↓
+9. 制定计划（可选，writing-plans）
+   ↓
+10. 开始开发（可选，test-driven-development）
+```
 
-## 参数说明
+---
 
-| 参数名 | 类型 | 必填 | 说明 |
-|--------|------|------|------|
-| project_name | string | 是 | 项目名称 |
-| flow_type | string | 是 | 流程类型：new_project / feature / bug_fix / release |
+## 2. 小型功能迭代
 
-## 流程选项
+```
+1. 需求补全（可选，requirement-completion-officer）
+   ↓
+2. 制定计划（可选，writing-plans）
+   ↓
+3. sdd-add快速处理
+   ↓
+4. 如果涉及UI/复杂逻辑，补充调用 ui-sdd/sdd-code
+   ↓
+5. verification-before-completion验证
+   ↓
+6. quality-gate质量检查
+   ↓
+7. finishing-a-development-branch完成分支（可选）
+   ↓
+8. 简单发布
+```
 
-### 1. 新项目启动 (new_project)
-- 需求分析 → 架构设计 → 开发计划 → 资源评估
+---
 
-### 2. 功能迭代 (feature)
-- 需求澄清 → 设计评审 → 开发实现 → 测试验收 → 上线发布
+## 3. Bug处理
 
-### 3. Bug修复 (bug_fix)
-- 问题定位 → 根因分析 → 修复方案 → 测试验证 → 回归测试
+```
+1. systematic-debugging调试
+   ↓
+2. sdd-add修复
+   ↓
+3. verification-before-completion验证
+   ↓
+4. quality-gate质量检查
+   ↓
+5. claudeception经验沉淀
+```
+
+---
+
+## 4. 代码发布
 
-### 4. 代码发布 (release)
-- 代码审查 → 版本更新 → 构建验证 → 灰度发布 → 全量上线
+```
+1. verification-before-completion验证
+   ↓
+2. quality-gate质量检查
+   ↓
+3. finishing-a-development-branch完成分支（可选）
+   ↓
+4. sdd-deploy部署设计（可选）
+   ↓
+5. release-flow发布管理
+```
 
-## 输出
+---
 
-根据选择的流程类型，输出对应的完整流程文档和执行步骤。
+## ✅ 开始流程
 
-## 使用示例
+### 第一步：询问用户选择
 
+首先询问用户：
 ```
-trae调用 unified-flow 项目名称=电商平台 流程场景=功能迭代
-trae调用 unified-flow 项目名称=移动App 流程场景=Bug修复
+综合开发流程已启动！
+请选择您要使用的流程：
+1. 从零开始新项目
+2. 小型功能迭代
+3. Bug处理
+4. 代码发布
+
+请输入选项编号（1-4）：
 ```
 
-## 版本
+### 第二步：按选择的流程执行
+
+根据用户选择，执行对应的流程步骤。
 
-v4.1.0

package/skills/rules/project_rules.md

@@ -0,0 +1,167 @@
+# 项目规则 - SDD全流程开发技能体系（团队共享）
+
+## 一、项目概述
+
+本项目是一个完整的SDD（Software Design Document）全流程开发技能包，包含从需求分析到发布运维的全流程技能，支持Trae和Claude Code双调用机制。
+
+## 二、核心流程规范
+
+### 2.1 新项目开发流程
+```
+需求收集 → 头脑风暴 → 市场调研 → PRD编写 → SDD拆分 → UI设计 → 代码设计 → 测试设计 → 开发 → 测试 → 质量检查 → 发布 → 复盘
+```
+
+### 2.2 Bug修复流程
+```
+问题定位 → Test-SDD补充回归用例 → 代码修复 → 验证 → 质量检查 → 经验沉淀
+```
+
+### 2.3 小型功能迭代流程
+```
+需求澄清 → SDD快速拆分 → 开发 → 验证 → 质量检查 → 发布
+```
+
+## 三、技能使用规范
+
+### 3.1 技能分类与职责
+| 分类 | 技能 | 职责描述 |
+|------|------|---------|
+| 需求分析 | brainstorming, market-research, competitive-brief, prd-write, requirement-completion-officer, sdd, sdd-full | 需求收集、分析、拆分 |
+| 设计规划 | ui-sdd, sdd-code, sdd-test, sdd-deploy, sdd-ops, writing-plans | 设计方案制定 |
+| 开发执行 | sdd-add, test-driven-development, systematic-debugging, verification-before-completion | 代码实现 |
+| 质量保障 | quality-gate, security-audit | 质量把关 |
+| 发布运维 | finishing-a-development-branch, release-flow | 发布管理 |
+| 知识沉淀 | claudeception, mempalace-auto-saver | 经验积累 |
+
+### 3.2 强制使用技能
+- ✅ **所有发布前必须通过 quality-gate**
+- ✅ **所有需求必须经过 sdd/sdd-full 拆分**
+- ✅ **所有Bug修复必须经过 systematic-debugging**
+- ✅ **发布后必须进行 claudeception 经验沉淀**
+
+## 四、文档规范
+
+### 4.1 SDD模板规范
+项目使用9种标准化SDD模板：
+1. **Base-SDD** - 全局通用基线规范
+2. **Brain-SDD** - 头脑风暴文档
+3. **Competitor-SDD** - 竞品分析文档
+4. **PRD-SDD** - 产品需求文档
+5. **UI-SDD** - UI设计文档
+6. **Code-SDD** - 代码实现文档
+7. **API-SDD** - 接口设计文档
+8. **Env-SDD** - 环境配置文档
+9. **Test-SDD** - 测试设计文档
+
+### 4.2 文档命名规范
+```
+{项目名称}-{模板名称}-{版本}.md
+示例：个人备忘录APP-Base-SDD-v1.0.md
+```
+
+### 4.3 文档归档规范
+```
+docs/
+├── specs/                    # SDD规范文档
+│   ├── ui/                   # UI-SDD
+│   ├── function-implementation-sdd/ # Code-SDD
+│   └── test/                 # Test-SDD
+├── stories/                  # 用户故事
+├── architecture/             # 架构文档
+├── database/                 # 数据库设计
+├── api/                      # API契约
+└── deploy/                   # 部署文档
+```
+
+## 五、质量标准
+
+### 5.1 代码质量标准
+- 单元测试覆盖率 ≥ 80%
+- 代码审查必须通过
+- 无 P0/P1 级别 Bug
+
+### 5.2 文档质量标准
+- 所有SDD模板必须完整填写
+- 文档版本管理规范
+- 文档与代码同步更新
+
+### 5.3 发布标准
+- 所有测试用例通过
+- quality-gate 检查通过
+- security-audit 无高危漏洞
+
+## 六、协作规范
+
+### 6.1 分支管理
+- `main` - 主分支，稳定版本
+- `develop` - 开发分支
+- `feature/*` - 功能分支
+- `bugfix/*` - Bug修复分支
+- `release/*` - 发布分支
+
+### 6.2 代码审查流程
+1. 功能开发完成后提交 PR
+2. 触发 requesting-code-review
+3. 审查通过后触发 receiving-code-review
+4. 合并到 develop 分支
+
+### 6.3 沟通规范
+- 使用明确的技能触发关键词
+- 及时更新状态
+- 遇到问题及时反馈
+
+## 七、调用机制规范
+
+### 7.1 Trae调用格式
+```
+trae调用 模板名称 项目名称=XXX 阶段=XXX 流程场景=XXX
+```
+
+### 7.2 Claude Code调用格式
+```
+调用 技能名称 参数
+```
+
+### 7.3 流程场景参数
+| 参数值 | 说明 |
+|--------|------|
+| 完整3阶段SDD流程 | 大型项目完整流程 |
+| 从零开始新项目 | 新项目立项 |
+| 小型功能迭代 | 快速迭代 |
+| Bug处理 | Bug修复 |
+| 代码发布 | 版本发布 |
+
+## 八、工具与环境
+
+### 8.1 推荐工具
+- **Figma** - UI设计
+- **GitHub** - 代码托管
+- **Trae** - 技能调用
+- **Claude Code** - AI协作
+
+### 8.2 环境要求
+- Node.js ≥ 18.x
+- npm ≥ 9.x
+- sdd-full ≥ 2.2.0
+
+## 九、版本管理
+
+### 9.1 版本命名规范
+```
+v{主版本}.{次版本}.{修订版本}
+示例：v2.2.0
+```
+
+### 9.2 版本发布流程
+1. 完成功能开发与测试
+2. 更新版本号
+3. 通过 quality-gate
+4. 执行 release-flow
+5. 发布到 npm
+
+---
+
+**版本**: v1.0  
+**更新时间**: 2026-05-06  
+**适用项目**: sdd-full-npm  
+**团队**: SDD开发团队

package/skills/rules/user_rules.md

@@ -1,69 +1,254 @@
-# SDD 个人规则
-
-## 技能地图触发词
-
-### 流程类
-- `/flow` - 完整开发流程
-- `/plan` - 规划任务
-- `/sdd` - 启动SDD流程
-
-### 需求分析
-- `需求分析` - 需求澄清与补全
-- `PRD` - 产品需求文档
-- `竞品分析` - 竞争情报分析
-- `头脑风暴` - 创意构思
-
-### 设计规划
-- `UI设计` - UI设计稿转SDD
-- `功能设计` - 功能SDD
-- `架构设计` - 系统架构
-- `代码设计` - Code-SDD
-
-### 开发执行
-- `TDD` - 测试驱动开发
-- `调试` - 系统调试
-- `功能新增` - 添加新功能
-
-### 质量保证
-- `BDD` - 行为驱动验收
-- `质量门禁` - 质量检查
-- `安全审计` - 安全审查
-
-### 发布运维
-- `发布流程` - 代码发布
-- `部署方案` - 部署SDD
-
-## 技能决策树
-
-### 第一步：确定任务类型
-1. **新项目启动** → sdd-full 完整流程
-2. **功能迭代** → unified-flow 功能迭代流程
-3. **Bug修复** → unified-flow Bug修复流程
-4. **代码发布** → unified-flow 代码发布流程
-
-### 第二步：选择输出类型
-1. **需求文档** → PRD-SDD / Brain-SDD
-2. **设计文档** → UI-SDD / Code-SDD / API-SDD
-3. **测试文档** → Test-SDD / BDD验收标准
-4. **部署文档** → Env-SDD / Deploy-SDD
-
-### 第三步：专项技能
-- **UI设计转代码** → ui-sdd-specialized / design-to-code
-- **Flutter专项** → flutter-map / flutter-av / flutter-test / flutter-errors
-- **企业级规范** → enterprise-spec
-- **AI编码规则** → ai-coding-rules
-
-## 快捷键触发
-
-| 触发词 | 技能 | 适用场景 |
-|--------|------|----------|
-| `/flow` | unified-flow | 完整开发流程 |
-| `/plan` | writing-plans | 编写执行计划 |
-| `/sdd` | sdd-full | SDD全流程 |
-| `bug` | systematic-debugging | 系统调试 |
-| `test` | test-driven-development | TDD开发 |
-| `deploy` | release-flow | 发布流程 |
-| `security` | security-audit | 安全审计 |
-| `ui` | ui-sdd-specialized | UI专用SDD |
-| `bdd` | bdd-acceptance | BDD验收 |
-| `env` | env-check | 环境预检 |
+# 个人规则 - SDD全流程开发技能体系
+
+## 一、技能地图
+
+### 需求分析类
+| 技能名称 | 触发关键词 | 适用场景 |
+|---------|-----------|---------|
+| brainstorming | 头脑风暴、创意、想法、需求发散 | 项目初期、需求不确定时 |
+| market-research | 市场调研、竞品分析、用户需求 | 了解竞品、市场情况 |
+| competitive-brief | 竞品简报、竞品对比 | 分析竞品差异 |
+| prd-write | 写PRD、产品需求文档 | 新项目立项、需求定义 |
+| requirement-completion-officer | 需求补全、需求澄清 | 需求不明确时 |
+| sdd | SDD拆分、需求拆分 | 大型需求结构化拆分 |
+| sdd-full | 完整SDD流程、全流程 | 需要完整SDD流程 |
+
+### 设计规划类
+| 技能名称 | 触发关键词 | 适用场景 |
+|---------|-----------|---------|
+| ui-sdd | UI设计、界面设计、交互设计 | UI设计阶段 |
+| sdd-code | 代码设计、实现方案、技术方案 | 功能实现设计 |
+| sdd-test | 测试设计、测试方案 | 测试设计阶段 |
+| sdd-deploy | 部署设计、发布方案 | 部署设计阶段 |
+| sdd-ops | 运维设计、监控方案 | 运维设计阶段 |
+| writing-plans | 制定计划、开发计划 | 需要制定详细计划 |
+
+### 开发执行类
+| 技能名称 | 触发关键词 | 适用场景 |
+|---------|-----------|---------|
+| sdd-add | 快速开发、小功能、临时需求 | 快速迭代、小型功能 |
+| test-driven-development | TDD、测试驱动、先写测试 | TDD开发模式 |
+| systematic-debugging | 调试、Bug排查、问题定位 | 调试Bug时 |
+| verification-before-completion | 验证、代码检查、提交前检查 | 提交/发布前验证 |
+
+### 质量保障类
+| 技能名称 | 触发关键词 | 适用场景 |
+|---------|-----------|---------|
+| quality-gate | 质量检查、门禁、发布检查 | 发布前质量把关 |
+| security-audit | 安全检查、安全审计 | 安全漏洞检查 |
+
+### 发布运维类
+| 技能名称 | 触发关键词 | 适用场景 |
+|---------|-----------|---------|
+| finishing-a-development-branch | 完成分支、合并分支 | 合并开发分支前 |
+| release-flow | 发布流程、版本发布 | 完整发布生命周期 |
+
+### 知识沉淀类
+| 技能名称 | 触发关键词 | 适用场景 |
+|---------|-----------|---------|
+| claudeception | 提取技能、保存经验、持续学习 | 沉淀可复用知识 |
+| mempalace-auto-saver | 保存记忆、自动存档 | 自动保存会话记忆 |
+
+### 专项工具类
+| 技能名称 | 触发关键词 | 适用场景 |
+|---------|-----------|---------|
+| using-superpowers | 全流程、自动化流程 | 使用Superpowers全流程 |
+| requesting-code-review | 请求审查、代码审查 | 需要代码审查 |
+| receiving-code-review | 接收审查、处理审查意见 | 处理代码审查反馈 |
+
+---
+
+## 二、调用决策树
+
+### 问题1：我现在要做什么？
+
+#### 选项A：我有一个新项目，从零开始
+→ 子问题：需要先创意/调研吗？
+→ → 是：**brainstorming** / **market-research** / **competitive-brief**
+→ → 否：跳过
+→ 然后：**prd-write**（写PRD，可选）→ **sdd**（拆需求）或 **sdd-full**（完整SDD流程）
+→ 然后到「选项E：我要设计/开发了」
+
+#### 选项B：我要做新功能/大需求
+→ **sdd**（基础SDD拆分）或 **sdd-full**（完整SDD流程）→ 到「选项E：我要设计/开发了」
+
+#### 选项C：我要做小功能迭代/Bug修复
+→ 子问题：需求是否明确？
+→ → 否：**requirement-completion-officer**（需求补全）
+→ → 是：跳过
+→ **sdd-add**（快速落地）
+→ 如果需要UI：补充调用 **ui-sdd**
+→ 如果需要调试：**systematic-debugging**
+→ 如果需要制定计划：**writing-plans**
+
+#### 选项D：我要发布代码
+→ 子问题：质量检查做了吗？
+→ → 否：**quality-gate**（先做质量检查）
+→ → 是：继续
+→ 子问题：是否完成开发分支？
+→ → 是：**finishing-a-development-branch**
+→ → 否：跳过
+→ **sdd-deploy**（部署设计，可选）→ **release-flow**（发布管理）
+
+#### 选项E：我要设计/开发了
+→ 子问题1：需要UI设计吗？
+→ → 是：**ui-sdd**
+→ → 否：跳过
+→ 子问题2：需要拆实现SDD吗？
+→ → 是：**sdd-code**（含代码规范、技术债务、重构计划）
+→ → 否：跳过
+→ 子问题3：需要设计测试吗？
+→ → 是：**sdd-test**
+→ → 否：跳过
+→ 子问题4：需要设计部署吗？
+→ → 是：**sdd-deploy**
+→ → 否：跳过
+→ 子问题5：需要设计运维吗？
+→ → 是：**sdd-ops**
+→ → 否：跳过
+→ 然后开始开发（sdd-add/test-driven-development/等）
+
+#### 选项F：我要调试问题
+→ **systematic-debugging**
+
+#### 选项G：我要做测试
+→ **sdd-test**（设计测试）→ **test-driven-development**（TDD开发）
+
+#### 选项H：我要做竞品分析
+→ **competitive-brief** / **market-research**
+
+#### 选项I：我要安全检查
+→ **security-audit**
+
+#### 选项J：我要保存/提取经验
+→ **claudeception** / **mempalace-auto-saver**
+
+---
+
+## 三、快捷触发关键词
+
+### 全流程场景触发
+
+#### 新项目完整流程
+- `/new` 或 `新项目` → brainstorming → prd-write → sdd/sdd-full
+- `/brain` 或 `头脑风暴` → 触发 brainstorming
+- `/prd` 或 `写PRD` → 触发 prd-write
+
+#### Bug修复流程
+- `/bug` 或 `修复Bug` → systematic-debugging → sdd-add → verification-before-completion → quality-gate → claudeception
+- `/debug` 或 `调试` → 触发 systematic-debugging
+- `/fix` 或 `修复` → 触发 sdd-add
+
+#### 小型功能迭代流程
+- `/iter` 或 `迭代` → requirement-completion-officer → sdd-add → verification-before-completion → quality-gate
+- `/dev` 或 `开发` → 触发 sdd-add
+- `/req` 或 `需求补全` → 触发 requirement-completion-officer
+
+#### 完整SDD流程
+- `/full` 或 `完整流程` → sdd-full（完整SDD流程）
+- `/sdd` 或 `SDD拆分` → 触发 sdd
+- `/flow` 或 `流程` → 显示技能决策树
+
+#### 代码发布流程
+- `/release` 或 `发布` → verification-before-completion → quality-gate → finishing-a-development-branch → sdd-deploy → release-flow
+- `/quality` 或 `质量检查` → 触发 quality-gate
+- `/deploy` 或 `部署` → 触发 sdd-deploy
+
+### 专项技能触发
+
+#### 设计相关
+- `/ui` 或 `UI设计` → 触发 ui-sdd
+- `/code` 或 `代码设计` → 触发 sdd-code
+- `/test` 或 `测试设计` → 触发 sdd-test
+
+#### 测试驱动开发
+- `/tdd` 或 `测试驱动` → 触发 test-driven-development
+
+#### Flutter专项
+- `/flutter` 或 `Flutter开发` → 显示Flutter专项技能列表
+- `/flutter-map` → 触发 flutter-map（地图导航）
+- `/flutter-av` → 触发 flutter-av（音视频）
+- `/flutter-test` → 触发 flutter-test（测试策略）
+- `/flutter-errors` → 触发 flutter-errors（异常排查）
+
+#### 质量保障
+- `/security` 或 `安全审计` → 触发 security-audit
+- `/bdd` 或 `BDD验收` → 触发 bdd-acceptance
+
+#### 代码审查
+- `/review` 或 `代码审查` → requesting-code-review → receiving-code-review
+- `/request-review` → 触发 requesting-code-review
+
+#### 环境检查
+- `/env` 或 `环境检查` → 触发 env-check
+
+### 知识沉淀
+- `/save` 或 `保存经验` → 触发 claudeception
+- `/mem` 或 `记忆保存` → 触发 mempalace-auto-saver
+
+---
+
+## 四、Trae快捷调用格式
+
+### 方式1：模板快捷调用
+```
+trae调用 模板名称 项目名称=XXX 阶段=XXX 流程场景=XXX
+```
+示例：
+- `trae调用 Brain-SDD 项目名称=个人备忘录APP 阶段=初期想法收集 流程场景=从零开始新项目`
+- `trae调用 PRD-SDD 项目名称=电商平台 需求优先级=P0 流程场景=完整3阶段SDD流程`
+
+### 方式2：简称快捷调用
+```
+trae快捷 模板简称 项目名称=XXX 阶段=XXX 流程场景=XXX
+```
+示例：
+- `trae快捷 Brain 项目名称=个人备忘录APP 阶段=初期想法收集 流程场景=从零开始新项目`
+- `trae快捷 Code 项目名称=电商平台 功能模块=用户登录 流程场景=小型功能迭代`
+
+### 模板简称映射
+| 简称 | 模板名称 |
+|------|---------|
+| Base | Base-SDD.md |
+| Brain | Brain-SDD.md |
+| Competitor | Competitor-SDD.md |
+| PRD | PRD-SDD.md |
+| UI | UI-SDD.md |
+| Code | Code-SDD.md |
+| API | API-SDD.md |
+| Env | Env-SDD.md |
+| Test | Test-SDD.md |
+| UI提示词 | UI资源提示词生成SDD.md |
+
+---
+
+## 五、流程场景参数说明
+
+| 场景编号 | 流程场景 | 说明 |
+|---------|---------|------|
+| 1 | 完整3阶段SDD流程 | 大型项目，需要完整的SDD全流程 |
+| 2 | 从零开始新项目 | 新项目立项，需要创意、调研、PRD |
+| 3 | 小型功能迭代 | 快速迭代，小功能开发 |
+| 4 | Bug处理 | Bug修复，调试问题 |
+| 5 | 代码发布 | 版本发布，质量检查 |
+
+---
+
+## 六、个人偏好设置
+
+### 默认项目名称
+- 默认项目：个人备忘录APP
+
+### 自动保存设置
+- [x] 自动保存记忆（mempalace-auto-saver）
+- [x] 定期提取经验（claudeception）
+
+### 质量检查设置
+- [x] 发布前自动触发 quality-gate
+- [x] 提交前自动触发 verification-before-completion
+
+---
+
+**版本**: v1.0  
+**更新时间**: 2026-05-06  
+**适用项目**: sdd-full-npm