sdd-full 4.2.0 → 4.3.0

package/skills/templates/Flutter/345/270/270/350/247/201/345/274/202/345/270/270/344/270/223/351/241/271SDD.md

@@ -0,0 +1,159 @@
+【claude code调用标识：Flutter常见异常专项SDD】【trae调用标识：Flutter常见异常专项SDD+异常处理】【流程场景：4.Bug处理】
+
+# Flutter常见异常专项SDD：[项目名称]
+
+## 一、SocketException异常
+
+### 1.1 异常描述
+| 属性 | 说明 |
+|------|------|
+| 异常类型 | SocketException |
+| 错误码 | 通常为OS错误码 |
+| 常见原因 | 网络不可用、连接被拒绝、超时 |
+
+### 1.2 排查流程
+| 步骤 | 检查内容 | 验证方法 |
+|------|---------|---------|
+| 1 | 网络连接 | ping baidu.com |
+| 2 | 服务器状态 | 检查API是否可访问 |
+| 3 | 端口开放 | telnet host port |
+| 4 | 代理配置 | 检查系统代理设置 |
+
+### 1.3 修复方案
+```dart
+try {
+  final response = await http.get(Uri.parse(url));
+} on SocketException catch (e) {
+  // 网络异常处理
+  showError('网络连接失败，请检查网络设置');
+}
+```
+
+### 1.4 预防措施
+- [ ] 添加网络状态监听
+- [ ] 实现重试机制
+- [ ] 添加超时配置
+- [ ] 提供离线模式
+
+---
+
+## 二、Framebuffer渲染异常
+
+### 2.1 异常描述
+| 属性 | 说明 |
+|------|------|
+| 异常类型 | FlutterError |
+| 错误码 | 渲染相关错误 |
+| 常见原因 | Widget树不一致、布局溢出、资源缺失 |
+
+### 2.2 排查流程
+| 步骤 | 检查内容 | 验证方法 |
+|------|---------|---------|
+| 1 | Widget树 | 检查build方法返回 |
+| 2 | 布局约束 | 检查Container/SizedBox约束 |
+| 3 | 资源文件 | 检查图片/字体是否存在 |
+| 4 | 日志分析 | 查看Flutter控制台 |
+
+### 2.3 修复方案
+```dart
+// 确保Widget树一致性
+@override
+Widget build(BuildContext context) {
+  if (data == null) {
+    return CircularProgressIndicator();
+  }
+  return Text(data!.text);
+}
+```
+
+### 2.4 预防措施
+- [ ] 使用const构造函数
+- [ ] 添加null安全检查
+- [ ] 使用LayoutBuilder处理约束
+- [ ] 启用debug模式检查
+
+---
+
+## 三、其他常见异常
+
+### 3.1 空指针异常（NullPointerException）
+| 排查 | 修复 |
+|------|------|
+| 检查变量是否为null | 使用?.或??运算符 |
+| 检查函数返回值 | 添加null检查 |
+
+### 3.2 类型转换异常（TypeError）
+| 排查 | 修复 |
+|------|------|
+| 检查类型转换位置 | 使用as进行安全转换 |
+| 检查泛型使用 | 指定正确的泛型类型 |
+
+### 3.3 内存泄漏（Memory Leak）
+| 排查 | 修复 |
+|------|------|
+| 使用DevTools分析 | 及时dispose资源 |
+| 检查Stream订阅 | 取消不必要的订阅 |
+
+---
+
+## 四、异常处理框架
+
+### 4.1 全局异常捕获
+```dart
+void main() {
+  FlutterError.onError = (details) {
+    FlutterError.presentError(details);
+    // 上报到日志系统
+    logError(details.exception, details.stack);
+  };
+  
+  runApp(MyApp());
+}
+```
+
+### 4.2 Zone异常捕获
+```dart
+runZonedGuarded(() {
+  runApp(MyApp());
+}, (error, stackTrace) {
+  // 处理异步异常
+  logError(error, stackTrace);
+});
+```
+
+### 4.3 Error Widget
+```dart
+ErrorWidget.builder = (FlutterErrorDetails details) {
+  return MaterialApp(
+    home: Scaffold(
+      body: Center(
+        child: Text('发生错误: ${details.exception}'),
+      ),
+    ),
+  );
+};
+```
+
+---
+
+## 五、验收标准
+
+### 5.1 异常处理验证
+- [ ] SocketException有捕获和提示
+- [ ] Framebuffer异常有防护
+- [ ] 全局异常处理已配置
+- [ ] 错误日志已上报
+
+### 5.2 稳定性测试
+- [ ] 网络断开后恢复正常
+- [ ] Widget树异常不导致崩溃
+- [ ] 内存泄漏检测通过
+- [ ] 长时间运行无异常
+
+---
+
+## 六、trae调用参数说明
+- **调用路径**: skills/templates/Flutter常见异常专项SDD.md
+- **必传参数**: 项目名称
+- **可选参数**: 异常类型（SocketException/Framebuffer/其他）
+- **流程场景**: 4.Bug处理

package/skills/templates/Flutter/351/237/263/350/247/206/351/242/221/345/205/250/346/240/210SDD.md

@@ -0,0 +1,121 @@
+【claude code调用标识：Flutter音视频全栈SDD】【trae调用标识：Flutter音视频全栈SDD+音视频集成】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代】
+
+# Flutter音视频全栈SDD：[项目名称]
+
+## 一、离线ASR语音转写
+
+### 1.1 SDK集成
+| SDK | 版本 | 配置方式 |
+|------|------|---------|
+| speech_to_text | ^6.0.0 | pubspec依赖 |
+| pocketsphinx | ^0.10.0 | 离线模型 |
+
+### 1.2 配置说明
+```yaml
+dependencies:
+  speech_to_text: ^6.0.0
+  pocketsphinx: ^0.10.0
+```
+
+### 1.3 核心功能
+| 功能 | 说明 | 验收标准 |
+|------|------|---------|
+| 语音录制 | 麦克风采集 | 支持多种采样率 |
+| 语音识别 | 离线识别引擎 | 准确率≥90% |
+| 实时转写 | 边录边识别 | 延迟≤500ms |
+| 语言选择 | 多语言支持 | 中文/英文 |
+
+### 1.4 权限配置
+| 平台 | 权限 | 配置位置 |
+|------|------|---------|
+| iOS | NSMicrophoneUsageDescription | Info.plist |
+| Android | RECORD_AUDIO | AndroidManifest.xml |
+
+---
+
+## 二、TTS语音合成
+
+### 2.1 SDK集成
+| SDK | 版本 | 配置方式 |
+|------|------|---------|
+| flutter_tts | ^3.0.0 | pubspec依赖 |
+
+### 2.2 配置说明
+```yaml
+dependencies:
+  flutter_tts: ^3.0.0
+```
+
+### 2.3 核心功能
+| 功能 | 说明 | 验收标准 |
+|------|------|---------|
+| 文本转语音 | TTS引擎 | 发音清晰 |
+| 语速调节 | 0.5-2.0倍 | 可调节 |
+| 音量调节 | 0-1.0 | 可调节 |
+| 音色选择 | 多种声音 | 支持切换 |
+
+### 2.4 平台差异
+| 平台 | 引擎 | 特性 |
+|------|------|------|
+| iOS | AVSpeechSynthesizer | 自然语音 |
+| Android | TextToSpeech | 多语言支持 |
+
+---
+
+## 三、OCR文字识别
+
+### 3.1 SDK集成
+| SDK | 版本 | 配置方式 |
+|------|------|---------|
+| google_mlkit_text_recognition | ^0.10.0 | pubspec依赖 |
+| tflite | ^1.1.2 | 离线模型 |
+
+### 3.2 配置说明
+```yaml
+dependencies:
+  google_mlkit_text_recognition: ^0.10.0
+```
+
+### 3.3 核心功能
+| 功能 | 说明 | 验收标准 |
+|------|------|---------|
+| 图片识别 | 从图片提取文字 | 准确率≥95% |
+| 实时识别 | 摄像头实时识别 | 帧率≥15fps |
+| 多行识别 | 支持多行文本 | 自动换行 |
+| 语言支持 | 多语言识别 | 中文/英文/数字 |
+
+### 3.4 权限配置
+| 平台 | 权限 | 配置位置 |
+|------|------|---------|
+| iOS | NSCameraUsageDescription | Info.plist |
+| Android | CAMERA | AndroidManifest.xml |
+
+---
+
+## 四、验收标准
+
+### 4.1 ASR验收
+- [ ] 语音录制正常
+- [ ] 离线识别准确率≥90%
+- [ ] 实时转写延迟≤500ms
+- [ ] 静音检测正常
+
+### 4.2 TTS验收
+- [ ] 语音合成清晰
+- [ ] 语速调节正常
+- [ ] 音量调节正常
+- [ ] 暂停/继续正常
+
+### 4.3 OCR验收
+- [ ] 图片识别准确率≥95%
+- [ ] 实时识别帧率≥15fps
+- [ ] 多行识别正确
+- [ ] 倾斜文本识别正常
+
+---
+
+## 五、trae调用参数说明
+- **调用路径**: skills/templates/Flutter音视频全栈SDD.md
+- **必传参数**: 项目名称
+- **可选参数**: 功能模块（ASR/TTS/OCR）
+- **流程场景**: 1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代

package/skills/templates/PRD-SDD.md

@@ -0,0 +1,45 @@
+【claude code调用标识：PRD-SDD】【trae调用标识：PRD-SDD+prd-write/requirement-completion-officer】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目】
+
+# PRD-SDD：[项目名称]产品需求文档（skill选项式设计）
+
+## 一、需求背景（skill可选项，支持多选/自定义补充）
+- 选项1：需求来源 → 选项：用户反馈/市场需求/业务规划 → 自定义来源：__________
+- 选项2：需求目的 → 选项：提升用户体验/完善功能闭环/解决核心痛点 → 自定义目的：__________
+- 选项3：需求优先级 → 选项：P0（核心）/P1（重要）/P2（一般） → 自定义优先级：__________
+
+## 二、用户角色定义（skill可选项，支持多选/自定义补充）
+- 选项1：核心用户 → 选项：普通用户/管理员/运营人员 → 自定义用户：__________
+- 选项2：用户特征 → 选项：年轻用户（18-25岁）/职场用户（25-35岁） → 自定义特征：__________
+- 选项3：用户需求 → 选项：便捷操作/功能全面/性能稳定 → 自定义需求：__________
+
+## 三、用户旅程梳理（skill可选项，支持多选/自定义补充）
+- 选项1：用户场景 → 选项：首次使用/日常使用/异常场景 → 自定义场景：__________
+- 选项2：旅程步骤 → 选项：进入页面→操作功能→完成目标→退出页面 → 自定义步骤：__________
+- 选项3：痛点梳理 → 选项：操作繁琐/等待时间长/功能不清晰 → 自定义痛点：__________
+
+## 四、功能范围界定（skill可选项，支持多选/自定义补充）
+- 选项1：必做功能 → 选项：核心功能1/核心功能2 → 自定义必做功能：__________
+- 选项2：可选功能 → 选项：拓展功能1/拓展功能2 → 自定义可选功能：__________
+- 选项3：不做功能 → 选项：非核心功能/场景需求低的功能 → 自定义不做功能：__________
+
+## 五、需求补全清单（skill可选项，支持多选/自定义补充）
+- 选项1：补全类型 → 选项：场景补全/逻辑补全/异常处理补全 → 自定义补全类型：__________
+- 选项2：补全内容 → 选项：补充XX场景的操作流程/完善XX逻辑的异常处理 → 自定义补全内容：__________
+
+## 六、主干流程（skill可选项，支持多选/自定义补充）
+- 选项1：流程类型 → 选项：正常流程/异常流程/分支流程 → 自定义流程类型：__________
+- 选项2：流程步骤 → 选项：步骤1→步骤2→步骤3→完成 → 自定义步骤：__________
+
+## 七、架构&模块拆分（附录）（skill可选项，支持多选/自定义补充）
+- 选项1：架构类型 → 选项：前后端分离架构/单体架构 → 自定义架构：__________
+- 选项2：模块拆分 → 选项：用户模块/功能模块/数据模块 → 自定义模块：__________
+
+## 八、验收标准（skill可选项，支持多选/自定义补充）
+- 选项1：功能验收 → 选项：功能正常运行/符合需求描述 → 自定义验收：__________
+- 选项2：体验验收 → 选项：交互流畅/操作便捷 → 自定义验收：__________
+- 选项3：性能验收 → 选项：响应时间≤1s/无卡顿 → 自定义验收：__________
+
+## trae调用参数说明（仅trae触发时使用）
+- 调用路径：skills/templates/PRD-SDD.md
+- 必传参数：项目名称、需求优先级、核心用户
+- 可选参数：功能范围、验收标准补充内容

package/skills/templates/SKILL.md

@@ -0,0 +1,91 @@
+【claude code调用标识：templates】【trae调用标识：templates+SDD模板库】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代、4.Bug处理、5.代码发布】
+
+---
+name: templates
+description: SDD模板库 - 包含9种标准化SDD模板+12种专项模板，支持双调用机制，覆盖完整开发流程
+---
+
+# SDD模板库
+
+## 功能说明
+本技能提供9种基础SDD模板+12种专项模板，支持Trae与Claude Code双调用机制，覆盖完整开发流程。
+
+## 基础SDD模板列表
+| 模板名称 | 简称 | 适配场景 |
+|---------|------|---------|
+| Base-SDD.md | Base | 全局通用基线 |
+| Brain-SDD.md | Brain | 头脑风暴 |
+| Competitor-SDD.md | Competitor | 竞品分析 |
+| PRD-SDD.md | PRD | 产品需求 |
+| UI-SDD.md | UI | UI设计 |
+| Code-SDD.md | Code | 代码实现 |
+| API-SDD.md | API | 接口设计 |
+| Env-SDD.md | Env | 环境配置 |
+| Test-SDD.md | Test | 测试设计 |
+
+## 专项SDD模板列表
+| 模板名称 | 核心内容 | 适用场景 |
+|---------|---------|---------|
+| UI-SDD专用模板.md | UI设计稿结构化、交付标准 | UI设计阶段 |
+| 功能SDD专用模板.md | 业务功能专属模板 | 功能开发 |
+| BDD风格验收标准SDD.md | BDD验收句式、准入/准出标准 | 测试验收 |
+| 环境预检标准化SDD.md | 本机配置、依赖版本、网络预检 | 项目启动 |
+| Flutter地图导航业务SDD.md | 高德SDK集成、Marker处理 | 地图开发 |
+| Flutter音视频全栈SDD.md | 离线ASR、TTS、OCR接入 | 音视频功能 |
+| Flutter全类型测试策略SDD.md | Golden测试、E2E、TDD、冒烟测试 | 测试策略 |
+| Flutter常见异常专项SDD.md | SocketException、渲染异常排查 | Bug修复 |
+| 企业级全栈工程规范SDD.md | 项目目录、版本管理、交付标准 | 工程规范 |
+| Andrej Karpathy AI编码规则落地SDD.md | 编码约束、禁止自由发挥 | 编码规范 |
+| 高保真设计转代码SDD.md | Rive动画、Figma转Flutter | 设计转代码 |
+| UI资源提示词生成SDD.md | UI资源提示词生成 | UI资源生成 |
+| 全流程SDD融合体系.md | 全流程联动、技能选项式设计 | 全流程管理 |
+
+## 强制顺序流水线
+
+```
+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
+```
+
+## 使用指南
+
+### 新项目完整流程
+1. 首先创建Base-SDD定义全局基线
+2. Brain-SDD进行头脑风暴
+3. Competitor-SDD进行竞品分析
+4. PRD-SDD编写产品需求
+5. Figma设计UI
+6. 依次创建UI-SDD、Code-SDD、API-SDD、Env-SDD、Test-SDD
+7. TDD开发、测试、发布
+
+### Bug修复流程
+1. systematic-debugging分析问题
+2. 更新Test-SDD添加回归用例
+3. sdd-add修复代码
+4. verification-before-completion验证
+5. quality-gate检查
+6. claudeception沉淀经验
+
+### 精简流程（小功能）
+满足任意2条可使用精简流程：
+- 开发周期≤1天，代码量≤500行
+- 不涉及新接口、新UI组件
+- 无复杂交互，不影响全局流程
+
+## AI协作规范
+
+| 阶段 | AI职责 | 人工校验要求 |
+|------|--------|-------------|
+| Brain-SDD | 发散想法、评估风险 | 确认想法合理性 |
+| Competitor-SDD | 收集竞品信息、对比差异 | 确认分析准确性 |
+| PRD-SDD | 补全需求、梳理用户旅程 | 必须人工二次确认 |
+| Code-SDD | 编写测试用例、排查Bug | 确认代码规范 |
+| 所有阶段 | 协助整理归档 | 校验完整性 |
+
+## 调用方式
+- **Claude Code**: 调用 模板名称（如：调用 Brain-SDD）
+- **Trae**: trae调用 模板名称 或 trae快捷 简称
+
+---
+
+**模板版本**: v5.0  
+**适用场景**: 个人+AI开发模式的完整文档化流程

package/skills/templates/Test-SDD.md

@@ -0,0 +1,34 @@
+【claude code调用标识：Test-SDD】【trae调用标识：Test-SDD+sdd-test】【流程场景：1.完整3阶段SDD流程、3.小型功能迭代、4.Bug处理】
+
+# Test-SDD：[测试模块名称]（skill选项式设计）
+
+## 一、测试策略（skill可选项，支持多选/自定义补充）
+- 选项1：测试类型 → 选项：单元测试/集成测试/E2E测试/性能测试/安全测试 → 自定义类型：__________
+- 选项2：测试范围 → 选项：全部模块/核心模块/新增功能 → 自定义范围：__________
+- 选项3：测试环境 → 选项：测试环境/预发环境/生产环境（灰度） → 自定义环境：__________
+
+## 二、测试用例（skill可选项，支持多选/自定义补充）
+- 选项1：用例类型 → 选项：正常流程用例/异常流程用例/边界条件用例 → 自定义类型：__________
+- 选项2：用例内容 → 选项：测试场景：__________ / 预期结果：__________ → 自定义内容：__________
+
+## 三、测试数据（skill可选项，支持多选/自定义补充）
+- 选项1：数据类型 → 选项：正常数据/边界数据/异常数据 → 自定义类型：__________
+- 选项2：数据来源 → 选项：Mock数据/真实数据/测试数据生成器 → 自定义来源：__________
+
+## 四、测试覆盖率目标（skill可选项，支持多选/自定义补充）
+- 选项1：单元测试覆盖率 → 选项：≥80%/≥90%/≥95% → 自定义覆盖率：__________
+- 选项2：集成测试覆盖率 → 选项：≥70%/≥80%/≥85% → 自定义覆盖率：__________
+
+## 五、性能测试指标（skill可选项，支持多选/自定义补充）
+- 选项1：响应时间 → 选项：≤100ms/≤500ms/≤1s → 自定义时间：__________
+- 选项2：并发数 → 选项：100/1000/10000 → 自定义并发：__________
+- 选项3：成功率 → 选项：≥99%/≥99.9%/≥99.99% → 自定义成功率：__________
+
+## 六、安全测试要点（skill可选项，支持多选/自定义补充）
+- 选项1：测试项 → 选项：SQL注入/XSS攻击/CSRF攻击/接口越权 → 自定义测试项：__________
+- 选项2：测试工具 → 选项：OWASP ZAP/Nessus/Burp Suite → 自定义工具：__________
+
+## trae调用参数说明（仅trae触发时使用）
+- 调用路径：skills/templates/Test-SDD.md
+- 必传参数：测试模块名称、测试类型、测试范围
+- 可选参数：测试用例、测试数据补充内容

package/skills/templates/UI-SDD.md

@@ -0,0 +1,38 @@
+【claude code调用标识：UI-SDD】【trae调用标识：UI-SDD+ui-sdd】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目】
+
+# UI-SDD：[页面/组件名称]（skill选项式设计）
+
+## 一、页面/组件概述（skill可选项，支持多选/自定义补充）
+- 选项1：页面/组件类型 → 选项：首页/详情页/按钮组件/弹窗组件 → 自定义类型：__________
+- 选项2：核心用途 → 选项：展示内容/接收操作/提示信息 → 自定义用途：__________
+- 选项3：所属模块 → 选项：用户模块/功能模块/公共模块 → 自定义模块：__________
+
+## 二、Figma链接（skill可选项，支持多选/自定义补充）
+- 选项1：完整设计稿链接 → 选项：填写Figma链接/填写备用导出文件链接 → 自定义链接：__________
+- 选项2：关键截图 → 选项：上传截图/填写截图路径 → 自定义截图：__________
+- 选项3：备用方案（链接失效时） → 选项：上传PDF标注文件/上传PNG标注文件 → 自定义备用方案：__________
+
+## 三、页面结构（skill可选项，支持多选/自定义补充）
+- 选项1：结构类型 → 选项：上下布局/左右布局/混合布局 → 自定义结构：__________
+- 选项2：核心模块 → 选项：头部导航/内容区域/底部信息 → 自定义模块：__________
+
+## 四、组件清单（skill可选项，支持多选/自定义补充）
+- 选项1：组件类型 → 选项：基础组件（按钮/输入框）/业务组件（表单/列表） → 自定义组件：__________
+- 选项2：组件数量 → 选项：≤5个/5-10个/＞10个 → 自定义数量：__________
+
+## 五、交互流程（skill可选项，支持多选/自定义补充）
+- 选项1：交互类型 → 选项：点击交互/滑动交互/hover交互 → 自定义交互：__________
+- 选项2：交互反馈 → 选项：弹窗提示/状态变化/跳转页面 → 自定义反馈：__________
+
+## 六、状态设计（skill可选项，支持多选/自定义补充）
+- 选项1：组件状态 → 选项：正常状态/ hover状态/禁用状态/选中状态 → 自定义状态：__________
+- 选项2：页面状态 → 选项：正常状态/加载状态/空状态/异常状态 → 自定义状态：__________
+
+## 七、设计规范（对齐Base-SDD）（skill可选项，支持多选/自定义补充）
+- 选项1：对齐规范 → 选项：对齐Base-SDD颜色规范/对齐Base-SDD字体规范 → 自定义对齐：__________
+- 选项2：偏差说明 → 选项：无偏差/有偏差（说明：__________） → 自定义说明：__________
+
+## trae调用参数说明（仅trae触发时使用）
+- 调用路径：skills/templates/UI-SDD.md
+- 必传参数：页面/组件名称、所属模块、Figma链接（或备用文件路径）
+- 可选参数：组件清单、交互流程补充内容

package/skills/templates/UI-SDD/344/270/223/347/224/250/346/250/241/346/235/277.md

@@ -0,0 +1,141 @@
+【claude code调用标识：UI-SDD专用模板】【trae调用标识：UI-SDD专用模板+UI设计规范】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代】
+
+# UI-SDD专用模板：[页面/组件名称]
+
+## 一、设计稿信息
+
+### 1.1 设计稿来源
+| 项目 | 内容 |
+|------|------|
+| Figma链接 | 【必填】 |
+| 备份文件 | 【必填】PNG/PDF格式 |
+| 设计稿版本 | 【必填】如：v1.0 |
+| 设计师 | 【必填】 |
+| 设计日期 | 【必填】 |
+
+### 1.2 设计稿状态
+- [ ] 初稿
+- [ ] 评审中
+- [x] 已确认
+- [ ] 需要修改
+
+---
+
+## 二、页面结构
+
+### 2.1 页面层级
+```
+页面名称
+├── 模块1
+│   ├── 组件1
+│   └── 组件2
+└── 模块2
+    └── 组件3
+```
+
+### 2.2 组件清单
+| 组件名称 | 类型 | 位置 | 状态 |
+|---------|------|------|------|
+| 【组件1】 | 【原子/分子/组织】 | 【页面位置】 | 【新增/复用/修改】 |
+| 【组件2】 | 【原子/分子/组织】 | 【页面位置】 | 【新增/复用/修改】 |
+
+### 2.3 布局规范
+- 页面宽度：【如：375px（移动端）/ 1200px（桌面端）】
+- 边距规范：【如：16px】
+- 栅格系统：【如：12列】
+
+---
+
+## 三、交互设计
+
+### 3.1 页面跳转
+| 触发操作 | 目标页面 | 跳转方式 |
+|---------|---------|---------|
+| 【点击按钮A】 | 【页面B】 | 【push/pop/modal】 |
+
+### 3.2 状态切换
+| 组件 | 状态 | 触发条件 | 视觉变化 |
+|------|------|---------|---------|
+| 【按钮】 | 默认/悬停/点击/禁用 | 【用户操作】 | 【颜色/大小变化】 |
+
+### 3.3 动效说明
+| 动效类型 | 触发场景 | 时长 | 缓动函数 |
+|---------|---------|------|---------|
+| 【页面切换】 | 【进入/退出】 | 【300ms】 | 【ease-out】 |
+
+---
+
+## 四、视觉规范
+
+### 4.1 颜色规范
+| 颜色用途 | Hex值 | RGB | 用途说明 |
+|---------|-------|-----|---------|
+| 主色 | 【#XXXXXX】 | 【R,G,B】 | 【按钮、链接】 |
+| 辅助色 | 【#XXXXXX】 | 【R,G,B】 | 【强调、提示】 |
+| 背景色 | 【#XXXXXX】 | 【R,G,B】 | 【页面背景】 |
+| 文字色 | 【#XXXXXX】 | 【R,G,B】 | 【正文】 |
+
+### 4.2 字体规范
+| 字体用途 | 字体名称 | 字号 | 字重 | 行高 |
+|---------|---------|------|------|------|
+| 标题 | 【PingFang SC】 | 【18px】 | 【600】 | 【24px】 |
+| 正文 | 【PingFang SC】 | 【14px】 | 【400】 | 【20px】 |
+| 小字 | 【PingFang SC】 | 【12px】 | 【400】 | 【16px】 |
+
+### 4.3 间距规范
+| 间距用途 | 值 | 适用场景 |
+|---------|-----|---------|
+| 页面边距 | 【16px】 | 【页面四周】 |
+| 组件间距 | 【8px】 | 【组件之间】 |
+| 内容间距 | 【12px】 | 【文字与元素】 |
+
+---
+
+## 五、交付标准
+
+### 5.1 设计稿完整性检查
+- [ ] 所有页面/组件设计完成
+- [ ] 交互状态完整（默认/悬停/点击/禁用）
+- [ ] 响应式适配（移动端/平板/桌面端）
+- [ ] 标注完整
+
+### 5.2 切图规范
+- [ ] 切图格式：【PNG/WebP/SVG】
+- [ ] 切图倍率：【1x/2x/3x】
+- [ ] 图标导出：【SVG格式，支持多色】
+- [ ] 命名规范：【模块_组件_状态_倍率.png】
+
+### 5.3 交付物清单
+- [ ] Figma源文件链接
+- [ ] 切图压缩包
+- [ ] 设计规范文档
+- [ ] 标注文件
+
+---
+
+## 六、验收标准
+
+### 6.1 视觉还原度
+- [ ] 颜色偏差 ≤ 5%
+- [ ] 尺寸偏差 ≤ 1px
+- [ ] 间距偏差 ≤ 2px
+- [ ] 字体一致
+
+### 6.2 交互正确性
+- [ ] 所有交互符合设计稿
+- [ ] 状态切换正确
+- [ ] 动效流畅
+- [ ] 无障碍访问
+
+### 6.3 响应式适配
+- [ ] 移动端显示正常
+- [ ] 平板端显示正常
+- [ ] 桌面端显示正常
+
+---
+
+## 七、trae调用参数说明
+- **调用路径**: skills/templates/UI-SDD专用模板.md
+- **必传参数**: 页面/组件名称
+- **可选参数**: 设计稿版本、设计师、设计日期
+- **流程场景**: 1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代