sdd-full 2.2.0 → 3.0.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

@@ -0,0 +1,152 @@
+【claude code调用标识：企业级全栈工程规范SDD】【trae调用标识：企业级全栈工程规范SDD+工程规范】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目】
+
+# 企业级全栈工程规范SDD：[项目名称]
+
+## 一、环境预检前置
+
+### 1.1 本机配置检查
+| 检查项 | 要求 | 验证方法 |
+|--------|------|---------|
+| OS版本 | macOS ≥ 12 / Windows ≥ 10 | uname / winver |
+| Node.js | ≥ 18.0 | node --version |
+| npm | ≥ 9.0 | npm --version |
+| Git | ≥ 2.30 | git --version |
+
+### 1.2 依赖工具检查
+| 工具 | 要求 | 用途 |
+|------|------|------|
+| Flutter | ≥ 3.10 | 移动端开发 |
+| Docker | ≥ 20.0 | 容器化部署 |
+| Jenkins/GitLab CI | - | CI/CD |
+
+### 1.3 网络环境检查
+| 检查项 | 要求 | 验证方法 |
+|--------|------|---------|
+| 网络连接 | 稳定 | ping测试 |
+| API连通性 | 可访问 | curl测试 |
+| 代理配置 | 正确 | env检查 |
+
+---
+
+## 二、项目目录结构
+
+### 2.1 标准目录结构
+```
+project/
+├── .github/              # CI/CD配置
+├── .trae/                # Trae技能配置
+├── android/              # Android原生代码
+├── ios/                  # iOS原生代码
+├── lib/                  # Flutter代码
+│   ├── src/              # 业务代码
+│   ├── widgets/          # 组件
+│   ├── services/         # 服务层
+│   └── utils/            # 工具类
+├── test/                 # 测试代码
+├── docs/                 # 文档
+├── pubspec.yaml          # 依赖配置
+└── README.md             # 项目说明
+```
+
+### 2.2 目录命名规范
+| 类型 | 命名规则 | 示例 |
+|------|---------|------|
+| 目录 | 小写蛇形 | user_service |
+| 文件 | 小写蛇形 | user_api.dart |
+| 类 | 大驼峰 | UserService |
+| 方法 | 小驼峰 | getUserInfo |
+
+---
+
+## 三、版本管理
+
+### 3.1 分支管理策略
+| 分支 | 用途 | 保护策略 |
+|------|------|---------|
+| main | 主分支 | 强制审查 |
+| develop | 开发分支 | 强制审查 |
+| feature/* | 功能分支 | 普通 |
+| bugfix/* | Bug修复 | 普通 |
+| release/* | 发布分支 | 强制审查 |
+
+### 3.2 提交规范
+| 类型 | 格式 | 示例 |
+|------|------|------|
+| 功能 | feat(module): description | feat(user): add login |
+| 修复 | fix(module): description | fix(auth): fix token expire |
+| 文档 | docs(module): description | docs(readme): update install |
+| 重构 | refactor(module): description | refactor(api): simplify |
+
+### 3.3 版本命名
+```
+v{主版本}.{次版本}.{修订版本}
+示例：v2.1.0
+```
+
+---
+
+## 四、交付物统一标准
+
+### 4.1 代码交付
+| 交付项 | 要求 | 验收标准 |
+|--------|------|---------|
+| 代码格式 | 符合dartfmt | dartfmt检查通过 |
+| 测试覆盖 | ≥ 80% | 单元测试通过 |
+| 文档注释 | 完整 | 关键方法有注释 |
+
+### 4.2 文档交付
+| 交付项 | 要求 | 验收标准 |
+|--------|------|---------|
+| PRD文档 | 完整 | 需求清晰 |
+| SDD文档 | 完整 | 设计规范 |
+| API文档 | 完整 | 接口定义清晰 |
+| 测试文档 | 完整 | 测试用例覆盖 |
+
+### 4.3 部署交付
+| 交付项 | 要求 | 验收标准 |
+|--------|------|---------|
+| Docker镜像 | 可用 | 容器启动正常 |
+| 部署脚本 | 完整 | 一键部署 |
+| 监控配置 | 完整 | 告警正常 |
+
+---
+
+## 五、质量保障
+
+### 5.1 代码审查
+| 检查项 | 要求 |
+|--------|------|
+| 审查人数 | ≥ 2人 |
+| 审查内容 | 代码质量、安全性、可维护性 |
+| 自动化检查 | CI自动运行 |
+
+### 5.2 安全审计
+| 检查项 | 要求 |
+|--------|------|
+| 依赖漏洞 | 无高危漏洞 |
+| 敏感信息 | 无硬编码 |
+| 权限控制 | 完整 |
+
+---
+
+## 六、验收标准
+
+### 6.1 工程规范验证
+- [ ] 目录结构符合标准
+- [ ] 命名规范一致
+- [ ] 分支管理规范
+- [ ] 提交信息规范
+
+### 6.2 交付物验证
+- [ ] 代码交付完整
+- [ ] 文档交付完整
+- [ ] 部署交付完整
+- [ ] 测试覆盖达标
+
+---
+
+## 七、trae调用参数说明
+- **调用路径**: skills/templates/企业级全栈工程规范SDD.md
+- **必传参数**: 项目名称
+- **可选参数**: 项目类型、团队规模
+- **流程场景**: 1.完整3阶段SDD流程、2.从零开始新项目

package/skills/templates//345/212/237/350/203/275SDD/344/270/223/347/224/250/346/250/241/346/235/277.md

@@ -0,0 +1,132 @@
+【claude code调用标识：功能SDD专用模板】【trae调用标识：功能SDD专用模板+功能设计规范】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代、4.Bug处理】
+
+# 功能SDD专用模板：[功能模块名称]
+
+## 一、需求描述
+
+### 1.1 功能概述
+【必填】简明描述功能的核心目标和价值
+
+### 1.2 用户故事
+| 角色 | 需求描述 | 验收标准 |
+|------|---------|---------|
+| 【用户角色】 | 【作为XX，我希望XX，以便XX】 | 【可以验证的标准】 |
+
+### 1.3 功能范围
+- 包含：【功能A、功能B】
+- 不包含：【功能C、功能D】
+
+---
+
+## 二、业务流程
+
+### 2.1 流程图
+```mermaid
+flowchart TD
+    A[开始] --> B[条件判断]
+    B -->|是| C[执行操作A]
+    B -->|否| D[执行操作B]
+    C --> E[结束]
+    D --> E
+```
+
+### 2.2 状态转换
+| 当前状态 | 触发事件 | 下一状态 |
+|---------|---------|---------|
+| 【状态A】 | 【事件X】 | 【状态B】 |
+| 【状态B】 | 【事件Y】 | 【状态C】 |
+
+### 2.3 异常分支
+| 异常场景 | 处理方式 | 错误提示 |
+|---------|---------|---------|
+| 【网络异常】 | 【重试/降级】 | 【提示文案】 |
+| 【数据为空】 | 【展示空状态】 | 【提示文案】 |
+
+---
+
+## 三、数据结构
+
+### 3.1 实体定义
+| 实体名称 | 字段名 | 类型 | 约束 | 说明 |
+|---------|--------|------|------|------|
+| 【实体A】 | 【id】 | 【int】 | 【主键】 | 【唯一标识】 |
+| 【实体A】 | 【name】 | 【string】 | 【非空，最大100字符】 | 【名称】 |
+
+### 3.2 API接口
+| API路径 | 方法 | 功能描述 | 请求参数 | 响应结构 |
+|---------|------|---------|---------|---------|
+| 【/api/users】 | 【GET】 | 【获取用户列表】 | 【page, size】 | 【List<User>】 |
+
+### 3.3 数据库设计
+| 表名 | 字段 | 类型 | 约束 |
+|------|------|------|------|
+| 【users】 | 【id】 | 【BIGINT】 | 【PRIMARY KEY】 |
+| 【users】 | 【name】 | 【VARCHAR(100)】 | 【NOT NULL】 |
+
+---
+
+## 四、界面设计
+
+### 4.1 页面原型
+| 页面名称 | 功能入口 | 页面职责 |
+|---------|---------|---------|
+| 【页面A】 | 【主入口】 | 【展示列表】 |
+| 【页面B】 | 【页面A跳转】 | 【详情展示】 |
+
+### 4.2 交互逻辑
+| 操作 | 触发方式 | 执行逻辑 | 反馈方式 |
+|------|---------|---------|---------|
+| 【点击按钮】 | 【tap/click】 | 【调用API】 | 【loading/成功提示】 |
+
+### 4.3 权限控制
+| 角色 | 功能权限 | 数据权限 |
+|------|---------|---------|
+| 【管理员】 | 【全部功能】 | 【全部数据】 |
+| 【普通用户】 | 【部分功能】 | 【本人数据】 |
+
+---
+
+## 五、非功能需求
+
+### 5.1 性能要求
+- 响应时间：【≤ 200ms】
+- 吞吐量：【≥ 1000QPS】
+- 并发数：【≥ 1000】
+
+### 5.2 安全性
+- 数据加密：【传输加密、存储加密】
+- 权限校验：【接口鉴权、数据隔离】
+- 防攻击：【防SQL注入、防XSS】
+
+### 5.3 兼容性
+- 浏览器：【Chrome ≥ 90、Firefox ≥ 88、Safari ≥ 14】
+- 移动端：【iOS ≥ 13、Android ≥ 10】
+
+---
+
+## 六、交付物清单
+
+### 6.1 文档交付
+- [ ] 需求文档（PRD）
+- [ ] UI设计稿
+- [ ] API接口文档
+- [ ] 数据库设计文档
+
+### 6.2 代码交付
+- [ ] 前端代码
+- [ ] 后端代码
+- [ ] 单元测试
+- [ ] 集成测试
+
+### 6.3 测试交付
+- [ ] 测试用例文档
+- [ ] 测试报告
+- [ ] Bug清单（已修复）
+
+---
+
+## 七、trae调用参数说明
+- **调用路径**: skills/templates/功能SDD专用模板.md
+- **必传参数**: 功能模块名称
+- **可选参数**: 用户角色、功能范围
+- **流程场景**: 1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代、4.Bug处理

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//346/212/200/350/203/275/345/206/263/347/255/226/346/240/221.md

@@ -249,6 +249,22 @@ claudeception → mempalace-auto-saver
 | **Env-SDD** | 环境配置文档 | sdd-deploy, sdd-ops |
 | **Test-SDD** | 测试设计文档 | sdd-test, test-driven-development |
 
+### 专项SDD模板（新增）
+
+| 模板名称 | 核心内容 | 适用场景 |
+|---------|---------|---------|
+| **UI-SDD专用模板** | UI设计稿结构化、交付标准 | UI设计阶段 |
+| **功能SDD专用模板** | 业务功能专属模板、必填项规范 | 功能开发 |
+| **BDD风格验收标准SDD** | BDD验收句式、准入/准出标准 | 测试验收 |
+| **环境预检标准化SDD** | 本机配置、依赖版本、网络预检 | 项目启动 |
+| **Flutter地图导航业务SDD** | 高德SDK集成、Marker处理 | 地图开发 |
+| **Flutter音视频全栈SDD** | 离线ASR、TTS、OCR接入 | 音视频功能 |
+| **Flutter全类型测试策略SDD** | Golden测试、E2E、TDD、冒烟测试 | 测试策略 |
+| **Flutter常见异常专项SDD** | SocketException、渲染异常排查 | Bug修复 |
+| **企业级全栈工程规范SDD** | 项目目录、版本管理、交付标准 | 工程规范 |
+| **Andrej Karpathy AI编码规则SDD** | 编码约束、禁止自由发挥 | 编码规范 |
+| **高保真设计转代码SDD** | Rive动画、Figma转Flutter | 设计转代码 |
+
 ### 强制顺序流水线
 
 ```