sdd-full 4.0.0 → 4.3.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

@@ -0,0 +1,153 @@
+【claude code调用标识：环境预检标准化SDD】【trae调用标识：环境预检标准化SDD+环境检查】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代、4.Bug处理、5.代码发布】
+
+# 环境预检标准化SDD：[项目名称]
+
+## 一、本机配置检查
+
+### 1.1 操作系统
+| 项目 | 要求版本 | 当前版本 | 状态 |
+|------|---------|---------|------|
+| macOS | ≥ 12.0 | 【检测】 | 【通过/失败】 |
+| Windows | ≥ 10 | 【检测】 | 【通过/失败】 |
+| Linux | Ubuntu ≥ 20.04 | 【检测】 | 【通过/失败】 |
+
+### 1.2 IDE版本
+| IDE | 要求版本 | 当前版本 | 状态 |
+|------|---------|---------|------|
+| VS Code | ≥ 1.80 | 【检测】 | 【通过/失败】 |
+| Android Studio | ≥ Hedgehog | 【检测】 | 【通过/失败】 |
+| Xcode | ≥ 15.0 | 【检测】 | 【通过/失败】 |
+
+### 1.3 依赖工具版本
+| 工具 | 要求版本 | 当前版本 | 状态 |
+|------|---------|---------|------|
+| Node.js | ≥ 18.0 | 【检测】 | 【通过/失败】 |
+| npm | ≥ 9.0 | 【检测】 | 【通过/失败】 |
+| Git | ≥ 2.30 | 【检测】 | 【通过/失败】 |
+
+---
+
+## 二、依赖版本检查
+
+### 2.1 语言环境
+| 语言 | 要求版本 | 当前版本 | 状态 |
+|------|---------|---------|------|
+| Dart | ≥ 3.0 | 【检测】 | 【通过/失败】 |
+| Flutter | ≥ 3.10 | 【检测】 | 【通过/失败】 |
+| Java | ≥ 11 | 【检测】 | 【通过/失败】 |
+
+### 2.2 第三方SDK版本
+| SDK | 要求版本 | 当前版本 | 状态 |
+|------|---------|---------|------|
+| 高德地图 | ≥ 10.0 | 【检测】 | 【通过/失败】 |
+| 推送SDK | ≥ 5.0 | 【检测】 | 【通过/失败】 |
+| 支付SDK | ≥ 3.0 | 【检测】 | 【通过/失败】 |
+
+---
+
+## 三、网络连接检查
+
+### 3.1 网络可用性
+| 检查项 | 检测方法 | 状态 |
+|------|---------|------|
+| 网络连接 | ping baidu.com | 【通过/失败】 |
+| 代理配置 | 检查系统代理 | 【通过/失败】 |
+| VPN连接 | 检查VPN状态 | 【通过/失败】 |
+
+### 3.2 API连通性
+| API地址 | 检测方法 | 状态 |
+|---------|---------|------|
+| 开发环境API | curl/Postman | 【通过/失败】 |
+| 测试环境API | curl/Postman | 【通过/失败】 |
+| 生产环境API | curl/Postman | 【通过/失败】 |
+
+---
+
+## 四、工程配置检查
+
+### 4.1 pubspec配置
+| 检查项 | 状态 | 备注 |
+|--------|------|------|
+| 依赖版本锁定 | 【通过/失败】 | 【说明】 |
+| 环境变量配置 | 【通过/失败】 | 【说明】 |
+| 脚本配置 | 【通过/失败】 | 【说明】 |
+
+### 4.2 密钥配置
+| 密钥名称 | 环境 | 状态 |
+|---------|------|------|
+| API Key | 测试 | 【已配置/缺失】 |
+| API Key | 生产 | 【已配置/缺失】 |
+| 安全校验码 | 测试 | 【已配置/缺失】 |
+| 安全校验码 | 生产 | 【已配置/缺失】 |
+
+### 4.3 环境变量
+| 变量名称 | 值 | 状态 |
+|---------|-----|------|
+| ENV | 【development/test/production】 | 【正确/错误】 |
+| BASE_URL | 【URL】 | 【正确/错误】 |
+| TIMEOUT | 【数值】 | 【正确/错误】 |
+
+---
+
+## 五、预检流程
+
+### 5.1 自动检测脚本
+```bash
+#!/bin/bash
+echo "=== 环境预检开始 ==="
+
+# 检查Node.js版本
+node --version
+
+# 检查Flutter版本
+flutter --version
+
+# 检查网络连接
+ping -c 1 baidu.com
+
+echo "=== 环境预检结束 ==="
+```
+
+### 5.2 手动检查清单
+| 检查步骤 | 检查内容 | 负责人 | 状态 |
+|---------|---------|--------|------|
+| 1 | 确认IDE已安装必要插件 | 【姓名】 | 【完成/待完成】 |
+| 2 | 确认设备已连接（iOS/Android） | 【姓名】 | 【完成/待完成】 |
+| 3 | 确认证书已配置 | 【姓名】 | 【完成/待完成】 |
+
+### 5.3 问题修复指南
+| 问题类型 | 解决方案 | 参考链接 |
+|---------|---------|---------|
+| Node.js版本过低 | 升级Node.js | 【链接】 |
+| Flutter依赖冲突 | 执行flutter clean后重新pub get | 【链接】 |
+| 网络连接失败 | 检查网络设置，尝试切换网络 | 【链接】 |
+
+---
+
+## 六、预检报告
+
+### 6.1 检查结果汇总
+| 检查类别 | 通过项 | 失败项 | 通过率 |
+|---------|-------|-------|-------|
+| 本机配置 | 【X】 | 【Y】 | 【Z%】 |
+| 依赖版本 | 【X】 | 【Y】 | 【Z%】 |
+| 网络连接 | 【X】 | 【Y】 | 【Z%】 |
+| 工程配置 | 【X】 | 【Y】 | 【Z%】 |
+
+### 6.2 问题清单
+| 问题编号 | 问题描述 | 严重程度 | 负责人 | 修复状态 |
+|---------|---------|---------|--------|---------|
+| P001 | 【问题描述】 | 【高/中/低】 | 【姓名】 | 【待修复/修复中/已修复】 |
+
+### 6.3 修复建议
+| 问题编号 | 建议方案 | 预计时间 |
+|---------|---------|---------|
+| P001 | 【修复方案】 | 【X小时】 |
+
+---
+
+## 七、trae调用参数说明
+- **调用路径**: skills/templates/环境预检标准化SDD.md
+- **必传参数**: 项目名称
+- **可选参数**: 环境类型（development/test/production）
+- **流程场景**: 1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代、4.Bug处理、5.代码发布

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

@@ -0,0 +1,119 @@
+【claude code调用标识：高保真设计转代码SDD】【trae调用标识：高保真设计转代码SDD+设计转代码】【流程场景：1.完整3阶段SDD流程、3.小型功能迭代】
+
+# 高保真设计转代码SDD：[项目名称]
+
+## 一、Rive动画集成
+
+### 1.1 配置说明
+| 工具 | 版本 | 用途 |
+|------|------|------|
+| rive_flutter | ^0.11.0 | Rive动画渲染 |
+| rive | 在线编辑器 | 动画制作 |
+
+### 1.2 依赖配置
+```yaml
+dependencies:
+  rive_flutter: ^0.11.0
+```
+
+### 1.3 集成流程
+```dart
+// 加载Rive文件
+final bytes = await rootBundle.load('assets/animation.riv');
+final file = RiveFile.import(bytes);
+final artboard = file.mainArtboard;
+
+// 播放动画
+artboard.addController(SimpleAnimation('Animation'));
+```
+
+### 1.4 注意事项
+- [ ] 动画文件大小控制（< 1MB）
+- [ ] 帧率适配（60fps）
+- [ ] 内存管理（及时dispose）
+- [ ] 平台兼容性
+
+---
+
+## 二、Figma设计稿转Flutter
+
+### 2.1 工具配置
+| 工具 | 用途 |
+|------|------|
+| Figma | 设计工具 |
+| Flutter Figma Converter | 转换工具 |
+| Pixel Perfect | 像素对齐 |
+
+### 2.2 1:1还原规范
+| 维度 | 规范 |
+|------|------|
+| 尺寸单位 | dp/px转换 |
+| 颜色值 | Hex/RGB转换 |
+| 字体 | 字体名称匹配 |
+| 间距 | 严格对齐 |
+
+### 2.3 转换流程
+```
+Figma设计稿 → 标注导出 → 组件拆分 → 代码实现 → 像素验证
+```
+
+### 2.4 组件拆分原则
+| 类型 | 拆分方式 |
+|------|---------|
+| 原子组件 | 按钮、输入框、图标 |
+| 分子组件 | 卡片、列表项 |
+| 组织组件 | 页面布局、容器 |
+
+---
+
+## 三、交付标准
+
+### 3.1 视觉还原度
+| 指标 | 要求 | 验证方法 |
+|------|------|---------|
+| 颜色偏差 | ≤ 5% | 取色器对比 |
+| 尺寸偏差 | ≤ 1px | 像素测量 |
+| 间距偏差 | ≤ 2px | 像素测量 |
+| 字体匹配 | 100% | 字体对比 |
+
+### 3.2 交互还原度
+| 指标 | 要求 | 验证方法 |
+|------|------|---------|
+| 动效时长 | ±10% | 计时对比 |
+| 动画曲线 | 一致 | 视觉对比 |
+| 状态切换 | 完整 | 交互测试 |
+
+### 3.3 代码质量
+| 指标 | 要求 | 验证方法 |
+|------|------|---------|
+| 组件化 | 合理拆分 | 代码审查 |
+| 可复用性 | 高 | 代码审查 |
+| 性能 | 流畅 | 性能测试 |
+
+---
+
+## 四、验收标准
+
+### 4.1 视觉验证
+- [ ] 颜色还原正确
+- [ ] 尺寸还原正确
+- [ ] 间距还原正确
+- [ ] 字体还原正确
+
+### 4.2 交互验证
+- [ ] 动画效果一致
+- [ ] 状态切换正确
+- [ ] 交互反馈完整
+
+### 4.3 代码验证
+- [ ] 组件化拆分合理
+- [ ] 代码结构清晰
+- [ ] 无冗余代码
+
+---
+
+## 五、trae调用参数说明
+- **调用路径**: skills/templates/高保真设计转代码SDD.md
+- **必传参数**: 项目名称
+- **可选参数**: 设计稿链接、目标平台
+- **流程场景**: 1.完整3阶段SDD流程、3.小型功能迭代

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

@@ -0,0 +1,408 @@
+【claude code调用标识：完整开发流程手册】【trae调用标识：完整开发流程手册+流程指南】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代、4.Bug处理、5.代码发布】
+
+# 完整开发流程手册
+
+## 概述
+
+本文档定义从需求想法到上线发布的完整端到端开发流程，包含每个阶段的目标、使用技能、产出物、检查清单。
+
+---
+
+## 流程图（核心路径）
+
+```
+需求想法 → 1.需求分析 → 2.需求拆分 → 3.设计阶段 → 4.开发阶段 → 5.测试阶段 → 6.质量检查 → 7.发布准备 → 8.发布执行 → 9.发布验证 → 10.复盘总结
+```
+
+---
+
+## 阶段1：需求分析
+
+### 目标
+明确需求价值，确定做还是不做，怎么做。
+
+### 使用技能
+- brainstorming（头脑风暴，创意阶段）
+- market-research（市场调研，竞品分析）
+- competitive-brief（竞品简报）
+- requirement-completion-officer（需求补全）
+
+### 产出物
+- 创意/调研记录
+- 技术初步评估
+- 需求优先级（可选）
+
+### 检查清单
+- [ ] 需求价值明确
+- [ ] 技术可行性初步评估
+- [ ] 已知风险识别
+- [ ] 大致范围确定
+
+---
+
+## 阶段2：需求拆分（sdd）
+
+### 目标
+将模糊需求拆分为结构化、可执行的用户故事，确定UI、架构、数据库、接口。
+
+### 使用技能
+- prd-write（写PRD，可选，大项目用）
+- sdd（基础SDD拆分，核心技能）或 sdd-full（完整SDD流程）
+
+### 产出物
+```
+docs/
+  ├── stories/
+  │   └── user_stories.md      # 用户故事清单
+  ├── ui/
+  │   └── pages.md            # UI页面清单
+  ├── architecture/
+  │   └── frontend-backend.md # 前后端架构
+  ├── database/
+  │   └── schema.md          # 数据库设计
+  └── api/
+      └── contract.md        # API契约
+```
+
+### 检查清单
+- [ ] Epic→Feature→User Story 拆分完成
+- [ ] 每个Story有验收标准
+- [ ] UI页面清单完整
+- [ ] 前后端职责清晰
+- [ ] 数据库/API契约明确
+
+---
+
+## 阶段3：设计阶段
+
+### 目标
+设计UI交互、功能实现、测试策略、部署方案。
+
+### 使用技能
+- ui-sdd（UI交互SDD）
+- sdd-code（功能实现SDD）
+- sdd-test（测试SDD）
+- sdd-deploy（部署SDD）
+- sdd-ops（运维SDD）
+- writing-plans（编写计划）
+
+### 产出物
+```
+specs/
+  ├── ui/                 # UI SDD（ui-sdd产出）
+  ├── function-implementation-sdd/ # 功能实现SDD（sdd-code产出）
+  └── test/               # 测试SDD（sdd-test产出）
+docs/
+  └── deploy/             # 部署SDD（sdd-deploy产出）
+  └── ops/                # 运维SDD（sdd-ops产出）
+```
+
+### 检查清单
+- [ ] UI SDD覆盖所有页面/组件
+- [ ] 功能实现SDD独立可交付
+- [ ] 测试SDD覆盖单元/集成/E2E/性能/安全
+- [ ] 部署SDD包含回滚方案
+- [ ] 运维SDD包含监控/备份方案
+
+---
+
+## 阶段4：开发阶段
+
+### 目标
+按SDD实现功能，保证代码质量。
+
+### 使用技能
+- sdd-add（快速迭代，小型需求）
+- test-driven-development（TDD，推荐）
+- systematic-debugging（调试）
+- verification-before-completion（完成前验证）
+
+### 产出物
+- 可运行代码
+- 单元测试代码
+
+### 检查清单
+- [ ] 代码按规范编写
+- [ ] 单元测试覆盖核心逻辑
+- [ ] 代码提交前验证通过
+
+---
+
+## 阶段5：测试阶段
+
+### 目标
+全面测试，保证功能正常，性能达标，安全可靠。
+
+### 使用技能
+- sdd-test产出的测试SDD
+- verification-before-completion（验证）
+
+### 产出物
+- 测试用例执行记录
+- 测试报告
+- Bug清单（已修复）
+
+### 检查清单
+- [ ] 所有测试用例执行完成
+- [ ] 单元测试覆盖率达标
+- [ ] 集成测试通过
+- [ ] 性能测试通过
+- [ ] 安全测试通过
+- [ ] 所有P0/P1 Bug已修复
+
+---
+
+## 阶段6：质量检查
+
+### 目标
+发布前最后一道关卡，全面检查质量是否达标。
+
+### 使用技能
+- quality-gate（质量门禁，核心技能）
+- security-audit（安全审计）
+
+### 产出物
+- 质量检查报告
+- 风险评估记录
+- 发布决策
+
+### 检查清单
+- [ ] 代码质量检查通过
+- [ ] 测试覆盖率检查通过
+- [ ] 性能基准检查通过
+- [ ] 安全漏洞扫描通过
+- [ ] 文档完整性检查通过
+
+---
+
+## 阶段7：发布准备
+
+### 目标
+准备发布计划、回滚方案、通知相关人员。
+
+### 使用技能
+- sdd-deploy（部署SDD，复用阶段3产出）
+- finishing-a-development-branch（完成开发分支，可选）
+- release-flow（发布流程管理，计划阶段）
+
+### 产出物
+```
+docs/
+  ├── deploy/
+  │   └── ...（复用）
+  └── release/
+      └── release-plan.md # 发布计划
+```
+
+### 检查清单
+- [ ] 发布计划完整
+- [ ] 回滚方案准备好
+- [ ] 数据备份完成
+- [ ] 发布通知已发送
+- [ ] 相关人员已到位
+
+---
+
+## 阶段8：发布执行
+
+### 目标
+按计划执行发布，监控状态，处理问题。
+
+### 使用技能
+- release-flow（发布执行阶段）
+
+### 产出物
+- 发布执行记录
+- 实时监控数据
+
+### 检查清单
+- [ ] 按发布检查清单执行
+- [ ] 发布过程监控正常
+- [ ] 问题及时响应处理
+- [ ] 发布完成确认
+
+---
+
+## 阶段9：发布验证
+
+### 目标
+验证发布后功能正常，数据正确，用户反馈良好。
+
+### 使用技能
+- release-flow（发布验证阶段）
+
+### 产出物
+- 验证记录
+- 用户反馈收集
+- 发布记录文档
+
+### 检查清单
+- [ ] 冒烟测试通过
+- [ ] 功能验证完成
+- [ ] 性能验证通过
+- [ ] 监控数据正常
+- [ ] 用户反馈正常
+
+---
+
+## 阶段10：复盘总结
+
+### 目标
+总结经验教训，识别改进点，优化流程。
+
+### 使用技能
+- release-flow（发布复盘阶段）
+- claudeception（沉淀经验）
+- mempalace-auto-saver（自动保存记忆）
+
+### 产出物
+```
+docs/
+  └── release/
+      ├── release-record.md # 发布记录
+      └── release-retrospective.md # 发布复盘
+```
+
+### 检查清单
+- [ ] 发布记录完整
+- [ ] 问题根因分析完成
+- [ ] 经验教训总结
+- [ ] 改进计划制定
+- [ ] 经验已沉淀（claudeception + mempalace-auto-saver）
+
+---
+
+## 完整流程检查清单（大项目）
+
+| 阶段 | 检查项 |
+|-----|--------|
+| 1.需求分析 | 价值明确、技术可行、需求补全 |
+| 2.需求拆分 | sdd/sdd-full完成、所有文档产出 |
+| 3.设计阶段 | ui-sdd、sdd-code、sdd-test、sdd-deploy、sdd-ops、writing-plans |
+| 4.开发阶段 | 代码完成、单元测试、验证通过 |
+| 5.测试阶段 | 各类测试通过、P0/P1 Bug修复 |
+| 6.质量检查 | quality-gate、security-audit全通过 |
+| 7.发布准备 | 计划、回滚、通知都做好 |
+| 8.发布执行 | 发布过程顺利 |
+| 9.发布验证 | 功能正常、监控正常 |
+| 10.复盘总结 | 记录完整、有改进计划、经验沉淀 |
+
+---
+
+## 简化流程（小项目/快速迭代）
+
+对于小项目或快速迭代，可以简化流程：
+
+```
+需求想法 → requirement-completion-officer(可选) → writing-plans(可选) → sdd-add → 开发 → verification-before-completion → quality-gate → finishing-a-development-branch(可选) → 快速发布 → 简单复盘(claudeception)
+```
+
+### 简化检查清单
+- [ ] 需求补全完成（可选）
+- [ ] 计划制定完成（可选）
+- [ ] sdd-add完成
+- [ ] 开发完成
+- [ ] 验证通过
+- [ ] quality-gate基础通过
+- [ ] 发布完成
+
+---
+
+## Bug修复流程
+
+```
+systematic-debugging → sdd-add → verification-before-completion → quality-gate → claudeception
+```
+
+---
+
+## 时间估算参考
+
+| 阶段 | 小项目 | 中项目 | 大项目 |
+|-----|--------|--------|--------|
+| 1.需求分析 | 0.5-1天 | 1-2天 | 3-5天 |
+| 2.需求拆分 | 1-2天 | 2-3天 | 3-7天 |
+| 3.设计阶段 | 1-2天 | 2-4天 | 4-10天 |
+| 4.开发阶段 | 2-5天 | 5-10天 | 10-30天 |
+| 5.测试阶段 | 1-2天 | 2-4天 | 4-10天 |
+| 6.质量检查 | 0.5天 | 0.5-1天 | 1-2天 |
+| 7.发布准备 | 0.5天 | 0.5-1天 | 1-2天 |
+| 8.发布执行 | 0.5-1天 | 1-2天 | 2-4天 |
+| 9.发布验证 | 0.5-1天 | 1-2天 | 2-3天 |
+| 10.复盘总结 | 0.5天 | 0.5-1天 | 1-2天 |
+| **合计** | **7-16天** | **14-30天** | **31-76天** |
+
+---
+
+## 最佳实践
+
+1. **流程适配：** 大项目走完整流程，小项目简化流程
+2. **质量第一：** 任何发布前至少走quality-gate
+3. **可追溯：** 每个阶段的产出文档要保存好
+4. **持续改进：** 每次复盘后要优化流程
+5. **快速反馈：** 问题发现越早，修复成本越低
+6. **经验沉淀：** 定期用claudeception + mempalace-auto-saver沉淀经验
+7. **需求明确：** 不明确时先用requirement-completion-officer补全需求
+
+---
+
+---
+
+## SDD融合框架（新增）
+
+### 9份标准化SDD模板
+
+| 模板名称 | 核心内容 | 适用技能 |
+|---------|---------|---------|
+| **Base-SDD** | 全局通用基线规范 | sdd, sdd-full |
+| **Brain-SDD** | 头脑风暴文档 | brainstorming |
+| **Competitor-SDD** | 竞品分析文档 | competitive-brief, market-research |
+| **PRD-SDD** | 产品需求文档 | prd-write, requirement-completion-officer |
+| **UI-SDD** | UI设计文档 | ui-sdd |
+| **Code-SDD** | 代码实现文档 | sdd-code, test-driven-development |
+| **API-SDD** | 接口设计文档 | sdd（接口拆分） |
+| **Env-SDD** | 环境配置文档 | sdd-deploy, sdd-ops |
+| **Test-SDD** | 测试设计文档 | sdd-test, test-driven-development |
+
+### 强制顺序流水线
+
+```
+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
+```
+
+### Bug修复流程（SDD融合版）
+
+```
+1. systematic-debugging → 更新Code-SDD技术债务记录
+       ↓
+2. Test-SDD补充回归用例 → 关联bug编号
+       ↓
+3. sdd-add修复 → 更新Code-SDD/API-SDD/Env-SDD
+       ↓
+4. verification-before-completion → 更新Test-SDD测试结果
+       ↓
+5. quality-gate → 校验所有SDD规范一致性
+       ↓
+6. claudeception → 更新技术债务/经验沉淀章节
+```
+
+### 精简流程判定标准
+
+满足任意2条即可使用精简流程：
+- 开发周期≤1天，代码量≤500行
+- 不涉及新接口、新UI组件，仅修改现有逻辑/文案
+- 无复杂交互，不影响全局流程
+
+### 模板版本锁定规则
+
+- 所有SDD模板版本化管理
+- 每个项目绑定固定模板版本，不随意自动升级
+- 通过`template-version.lock`文件记录版本信息
+
+---
+
+## 更新日志
+- v4.0（2026-05-06）：新增SDD融合框架，9份标准化模板，强制顺序流水线，Bug修复流程融合
+- v3.0（2026-05-05）：发布到npm包，新增npx安装方式，支持Trae/Trae-cn/Claude Code多环境安装
+- v2.0（2026-05-04）：更新技能列表，匹配当前实际存在的技能
+- v1.0（2024-05-04）：初始版本，完整流程定义