sdd-full 3.2.0 → 4.0.0

package/skills/templates/BDD/351/243/216/346/240/274/351/252/214/346/224/266/346/240/207/345/207/206SDD.md

@@ -1,147 +0,0 @@
-【claude code调用标识：BDD风格验收标准SDD】【trae调用标识：BDD风格验收标准SDD+验收规范】【流程场景：1.完整3阶段SDD流程、3.小型功能迭代、4.Bug处理】
-
-# BDD风格验收标准SDD：[需求名称]
-
-## 一、需求概述
-
-### 1.1 需求描述
-【必填】简明描述需求的核心内容
-
-### 1.2 需求来源
-- Jira/工单编号：【如：PROJ-001】
-- 提出人：【姓名/角色】
-- 优先级：【P0/P1/P2】
-
----
-
-## 二、场景定义
-
-### 2.1 正常场景
-| 场景编号 | 场景描述 | 前置条件 |
-|---------|---------|---------|
-| SC001 | 【用户正常使用功能A】 | 【用户已登录】 |
-| SC002 | 【用户完成操作B】 | 【数据已加载】 |
-
-### 2.2 异常场景
-| 场景编号 | 场景描述 | 前置条件 |
-|---------|---------|---------|
-| EC001 | 【网络异常时操作】 | 【无网络连接】 |
-| EC002 | 【数据为空时操作】 | 【数据库无数据】 |
-
-### 2.3 边界场景
-| 场景编号 | 场景描述 | 前置条件 |
-|---------|---------|---------|
-| BC001 | 【参数达到最大限制】 | 【输入达到上限】 |
-| BC002 | 【并发操作场景】 | 【多个用户同时操作】 |
-
----
-
-## 三、验收句式
-
-### 3.1 Given-When-Then格式
-
-#### 正常场景示例
-```gherkin
-Scenario: 用户登录成功
-  Given 用户在登录页面
-  And 用户输入正确的用户名和密码
-  When 用户点击登录按钮
-  Then 系统跳转到首页
-  And 显示用户信息
-```
-
-#### 异常场景示例
-```gherkin
-Scenario: 用户登录失败（密码错误）
-  Given 用户在登录页面
-  And 用户输入正确的用户名和错误的密码
-  When 用户点击登录按钮
-  Then 显示错误提示"密码错误"
-  And 用户停留在登录页面
-```
-
-### 3.2 前置条件模板
-| 类型 | 格式 | 示例 |
-|------|------|------|
-| 用户状态 | Given 用户【状态】 | Given 用户已登录 |
-| 系统状态 | Given 系统【状态】 | Given 系统正常运行 |
-| 数据状态 | Given 数据【状态】 | Given 数据库中有10条记录 |
-
-### 3.3 预期结果模板
-| 类型 | 格式 | 示例 |
-|------|------|------|
-| 页面跳转 | Then 跳转到【页面】 | Then 跳转到首页 |
-| 信息展示 | Then 显示【信息】 | Then 显示欢迎消息 |
-| 数据变化 | Then 【数据】【变化】 | Then 用户积分增加100 |
-| 错误提示 | Then 显示错误【提示】 | Then 显示错误"网络异常" |
-
----
-
-## 四、准入标准
-
-### 4.1 需求澄清完成
-- [ ] 需求描述清晰明确
-- [ ] 需求范围已确认
-- [ ] 需求优先级已确定
-- [ ] 利益相关方已确认
-
-### 4.2 设计稿就绪
-- [ ] UI设计稿已完成
-- [ ] 交互设计已确认
-- [ ] 技术方案已评审
-- [ ] API接口已定义
-
-### 4.3 依赖确认
-- [ ] 外部依赖已确认
-- [ ] 内部依赖已协调
-- [ ] 测试环境已准备
-- [ ] 数据准备已完成
-
----
-
-## 五、准出标准
-
-### 5.1 功能验证通过
-- [ ] 所有正常场景测试通过
-- [ ] 所有异常场景测试通过
-- [ ] 所有边界场景测试通过
-- [ ] 性能测试通过
-
-### 5.2 测试覆盖率
-- [ ] 单元测试覆盖率 ≥ 80%
-- [ ] 集成测试覆盖率 ≥ 70%
-- [ ] E2E测试覆盖核心流程
-- [ ] 安全测试通过
-
-### 5.3 文档完整
-- [ ] 需求文档已更新
-- [ ] API文档已更新
-- [ ] 测试文档已更新
-- [ ] 用户手册已更新
-
----
-
-## 六、测试用例
-
-### 6.1 单元测试
-| 测试编号 | 测试方法 | 测试内容 | 预期结果 |
-|---------|---------|---------|---------|
-| UT001 | 【方法名】 | 【测试场景】 | 【预期结果】 |
-
-### 6.2 集成测试
-| 测试编号 | 测试场景 | 接口调用 | 预期结果 |
-|---------|---------|---------|---------|
-| IT001 | 【集成场景】 | 【接口列表】 | 【预期结果】 |
-
-### 6.3 E2E测试
-| 测试编号 | 测试场景 | 操作步骤 | 预期结果 |
-|---------|---------|---------|---------|
-| E2E001 | 【端到端场景】 | 【步骤列表】 | 【预期结果】 |
-
----
-
-## 七、trae调用参数说明
-- **调用路径**: skills/templates/BDD风格验收标准SDD.md
-- **必传参数**: 需求名称
-- **可选参数**: Jira编号、优先级、提出人
-- **流程场景**: 1.完整3阶段SDD流程、3.小型功能迭代、4.Bug处理

package/skills/templates/Base-SDD.md

@@ -1,38 +0,0 @@
-【claude code调用标识：Base-SDD】【trae调用标识：Base-SDD+sdd】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目】
-
-# Base-SDD：[项目名称]全局通用基线规范（skill选项式设计）
-
-## 一、全局UI交互基线（skill可选项，支持多选/自定义补充）
-- 选项1：设计系统版本 → 选项：Figma组件库v1.0/自研设计系统v2.0 → 自定义版本：__________
-- 选项2：颜色规范 → 选项：品牌色+中性色组合/行业通用配色 → 自定义配色：__________
-- 选项3：字体规范 → 选项：思源黑体（常规/粗体）/微软雅黑 → 自定义字体：__________
-- 选项4：间距规范 → 选项：8px基准间距/16px基准间距 → 自定义间距：__________
-
-## 二、弹窗/浮层生命周期规范（skill可选项，支持多选/自定义补充）
-- 选项1：弹窗打开规则 → 选项：点击触发/hover触发/自动弹出 → 自定义规则：__________
-- 选项2：弹窗关闭规则 → 选项：点击关闭按钮/点击遮罩/ESC键关闭 → 自定义规则：__________
-- 选项3：遮罩层行为 → 选项：遮罩可点击关闭/遮罩不可点击 → 自定义规则：__________
-- 选项4：层级规范 → 选项：弹窗层级＞遮罩层＞页面内容 → 自定义层级：__________
-
-## 三、手势冲突通用规则（skill可选项，支持多选/自定义补充）
-- 选项1：滑动冲突处理 → 选项：优先纵向滑动/优先横向滑动 → 自定义处理：__________
-- 选项2：点击穿透处理 → 选项：添加遮罩防穿透/延迟点击判定 → 自定义处理：__________
-- 选项3：双指缩放规则 → 选项：仅图片支持缩放/全页面支持缩放 → 自定义规则：__________
-
-## 四、通用编码规范（skill可选项，支持多选/自定义补充）
-- 选项1：命名规范 → 选项：驼峰命名法/下划线命名法 → 自定义规范：__________
-- 选项2：注释规范 → 选项：单行注释// /多行注释/* */ → 自定义规范：__________
-- 选项3：代码风格 → 选项：ESLint标准/自定义代码风格 → 自定义风格：__________
-
-## 五、错误码规范（skill可选项，支持多选/自定义补充）
-- 选项1：通用错误码 → 选项：000（成功）/100（参数错误）/200（系统错误） → 自定义错误码：__________
-- 选项2：业务错误码 → 选项：300（用户相关）/400（功能相关） → 自定义错误码：__________
-
-## 六、安全规范（skill可选项，支持多选/自定义补充）
-- 选项1：隐私数据处理 → 选项：加密存储/脱敏展示 → 自定义处理：__________
-- 选项2：敏感信息脱敏 → 选项：手机号隐藏中间4位/身份证隐藏中间8位 → 自定义脱敏：__________
-
-## trae调用参数说明（仅trae触发时使用）
-- 调用路径：skills/templates/Base-SDD.md
-- 必传参数：项目名称、基线规范类型（如：UI交互/编码规范）
-- 可选参数：自定义规范补充内容

package/skills/templates/Brain-SDD.md

@@ -1,36 +0,0 @@
-【claude code调用标识：Brain-SDD】【trae调用标识：Brain-SDD+brainstorming】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代】
-
-# Brain-SDD：[项目名称]头脑风暴文档（skill选项式设计）
-
-## 一、想法收集（skill可选项，支持多选/自定义补充）
-- 选项1：基础功能类（如：语音记录、标签分类、定时提醒）
-- 选项2：便捷交互类（如：快捷搜索、一键导出、云同步）
-- 选项3：个性化类（如：主题切换、自定义布局）
-- 选项4：自定义想法：__________
-
-## 二、初步脑洞（skill可选项，支持多选/自定义补充）
-- 选项1：技术拓展类（如：手写识别、语音转文字）
-- 选项2：场景延伸类（如：多设备互通、第三方工具联动）
-- 选项3：创新功能类（如：智能分类、内容推荐）
-- 选项4：自定义脑洞：__________
-
-## 三、废弃方案（skill可选项+原因填写，支持自定义）
-- 选项1：方案：视频笔记 → 原因选项：使用场景少/开发复杂度高/偏离核心需求 → 自定义补充：__________
-- 选项2：方案：多语言支持 → 原因选项：用户需求低/开发成本高 → 自定义补充：__________
-- 选项3：自定义方案：__________ → 原因：__________
-
-## 四、灵感来源（skill可选项，支持多选/自定义补充）
-- 选项1：竞品参考（如：某备忘录APP功能拆解，链接：__________）
-- 选项2：用户需求反馈（描述：__________）
-- 选项3：行业趋势（描述：__________）
-- 选项4：自定义来源：__________
-
-## 五、风险初步评估（skill可选项+应对措施，支持自定义）
-- 选项1：风险点：语音转文字准确率低 → 应对措施选项：选用成熟SDK/提前测试适配 → 自定义补充：__________
-- 选项2：风险点：云同步稳定性差 → 应对措施选项：选择可靠云服务/增加异常处理 → 自定义补充：__________
-- 选项3：自定义风险点：__________ → 应对措施：__________
-
-## trae调用参数说明（仅trae触发时使用）
-- 调用路径：skills/templates/Brain-SDD.md
-- 必传参数：项目名称、头脑风暴阶段（如：初期想法收集/脑洞筛选）
-- 可选参数：自定义想法、自定义方案补充内容

package/skills/templates/Code-SDD.md

@@ -1,41 +0,0 @@
-【claude code调用标识：Code-SDD】【trae调用标识：Code-SDD+sdd-code】【流程场景：1.完整3阶段SDD流程、3.小型功能迭代、4.Bug处理】
-
-# Code-SDD：[功能模块名称]（skill选项式设计）
-
-## 一、模块概述（skill可选项，支持多选/自定义补充）
-- 选项1：模块类型 → 选项：核心业务模块/公共组件模块/工具模块 → 自定义类型：__________
-- 选项2：核心功能 → 选项：数据处理/接口调用/业务逻辑实现 → 自定义功能：__________
-- 选项3：关联模块 → 选项：用户模块/数据模块/UI模块 → 自定义关联模块：__________
-
-## 二、技术选型（skill可选项，支持多选/自定义补充）
-- 选项1：开发语言 → 选项：JavaScript/TypeScript/Python → 自定义语言：__________
-- 选项2：框架选型 → 选项：Vue/React/Node.js → 自定义框架：__________
-- 选项3：工具依赖 → 选项：axios（接口请求）/lodash（工具函数）/jest（测试） → 自定义依赖：__________
-
-## 三、接口设计（skill可选项，支持多选/自定义补充）
-- 选项1：接口类型 → 选项：GET（查询）/POST（提交）/PUT（修改）/DELETE（删除） → 自定义类型：__________
-- 选项2：接口地址 → 选项：/api/xxx（示例） → 自定义地址：__________
-- 选项3：请求参数 → 选项：参数1（类型：String，必填）/参数2（类型：Number，可选） → 自定义参数：__________
-- 选项4：返回数据 → 选项：code（状态码）/data（数据）/message（提示信息） → 自定义返回：__________
-
-## 四、代码结构（skill可选项，支持多选/自定义补充）
-- 选项1：目录结构 → 选项：src/xxx（模块目录）/index.js（入口文件）/utils.js（工具函数） → 自定义结构：__________
-- 选项2：核心代码片段 → 选项：示例代码（可粘贴） → 自定义代码：__________
-
-## 五、异常处理（skill可选项，支持多选/自定义补充）
-- 选项1：异常类型 → 选项：接口请求异常/数据处理异常/参数校验异常 → 自定义类型：__________
-- 选项2：处理方案 → 选项：弹窗提示/日志记录/降级处理 → 自定义方案：__________
-
-## 六、技术债务记录（skill可选项，支持多选/自定义补充）
-- 选项1：债务类型 → 选项：代码冗余/注释缺失/逻辑不清晰 → 自定义类型：__________
-- 选项2：处理计划 → 选项：迭代优化/后续重构/暂时保留 → 自定义计划：__________
-
-## 七、关联技能调用（skill可选项，支持多选/自定义补充）
-- 选项1：开发阶段调用 → 选项：test-driven-development（TDD开发）/sdd-add（快速迭代） → 自定义调用：__________
-- 选项2：质量校验调用 → 选项：quality-gate（质量门禁）/security-audit（安全审计） → 自定义调用：__________
-- 选项3：代码审查调用 → 选项：requesting-code-review（请求代码审查）/receiving-code-review（接收代码审查） → 自定义调用：__________
-
-## trae调用参数说明（仅trae触发时使用）
-- 调用路径：skills/templates/Code-SDD.md
-- 必传参数：功能模块名称、开发语言、核心功能
-- 可选参数：接口设计、代码结构补充内容

package/skills/templates/Competitor-SDD.md

@@ -1,34 +0,0 @@
-【claude code调用标识：Competitor-SDD】【trae调用标识：Competitor-SDD+market-research/competitive-brief】【流程场景：2.从零开始新项目】
-
-# Competitor-SDD：[项目名称]竞品分析文档（skill选项式设计）
-
-## 一、竞品列表（skill可选项，支持多选/自定义补充）
-- 选项1：竞品类型 → 选项：直接竞品/间接竞品/潜在竞品 → 自定义类型：__________
-- 选项2：竞品名称及核心功能 → 选项1：竞品A（核心功能：__________） → 选项2：竞品B（核心功能：__________） → 自定义竞品：__________（核心功能：__________）
-
-## 二、功能对比（skill可选项，支持多选/自定义补充）
-- 选项1：核心功能点 → 选项：基础功能/便捷功能/创新功能 → 自定义功能点：__________
-- 选项2：对比维度 → 选项：功能完整性/交互体验/性能表现 → 自定义维度：__________
-- 选项3：对比结果填写 → 选项：竞品A优于我方/我方优于竞品A/两者持平 → 自定义结果：__________
-
-## 三、优缺点分析（skill可选项，支持多选/自定义补充）
-### 竞品A（可替换为具体竞品）
-- 优点选项：选项1：功能全面/选项2：交互流畅/选项3：性能稳定 → 自定义优点：__________
-- 缺点选项：选项1：操作复杂/选项2：功能冗余/选项3：兼容性差 → 自定义缺点：__________
-
-## 四、可借鉴点（skill可选项，支持多选/自定义补充）
-- 选项1：功能借鉴 → 选项：竞品的XX功能/竞品的交互逻辑 → 自定义借鉴点：__________
-- 选项2：技术借鉴 → 选项：竞品的实现方式/竞品的优化思路 → 自定义借鉴点：__________
-
-## 五、避坑点（skill可选项，支持多选/自定义补充）
-- 选项1：功能避坑 → 选项：竞品未做好的XX功能/用户反馈差的功能 → 自定义避坑点：__________
-- 选项2：技术避坑 → 选项：竞品存在的性能问题/兼容性问题 → 自定义避坑点：__________
-
-## 六、差异化机会（skill可选项，支持多选/自定义补充）
-- 选项1：功能差异化 → 选项：补充竞品缺失的功能/优化竞品不足的功能 → 自定义机会：__________
-- 选项2：体验差异化 → 选项：优化交互流程/提升操作便捷性 → 自定义机会：__________
-
-## trae调用参数说明（仅trae触发时使用）
-- 调用路径：skills/templates/Competitor-SDD.md
-- 必传参数：项目名称、竞品类型、竞品名称
-- 可选参数：对比维度、可借鉴点补充内容

package/skills/templates/Env-SDD.md

@@ -1,37 +0,0 @@
-【claude code调用标识：Env-SDD】【trae调用标识：Env-SDD+sdd-deploy/sdd-ops】【流程场景：1.完整3阶段SDD流程、5.代码发布】
-
-# Env-SDD：[项目名称]环境配置文档（skill选项式设计）
-
-## 一、环境列表（skill可选项，支持多选/自定义补充）
-- 选项1：环境类型 → 选项：开发环境/测试环境/预发环境/生产环境 → 自定义类型：__________
-- 选项2：环境URL → 选项：http://localhost:3000（开发）/https://test.example.com（测试） → 自定义URL：__________
-- 选项3：环境用途 → 选项：开发调试/功能测试/回归测试/正式上线 → 自定义用途：__________
-
-## 二、权限配置（skill可选项，支持多选/自定义补充）
-- 选项1：权限类型 → 选项：管理员权限/开发权限/测试权限/只读权限 → 自定义类型：__________
-- 选项2：权限范围 → 选项：全部权限/部分权限/特定模块权限 → 自定义范围：__________
-
-## 三、SDK配置（skill可选项，支持多选/自定义补充）
-- 选项1：SDK类型 → 选项：前端SDK/后端SDK/移动端SDK → 自定义类型：__________
-- 选项2：SDK版本 → 选项：v1.0/v2.0/v3.0 → 自定义版本：__________
-
-## 四、APIKey管理（skill可选项，支持多选/自定义补充）
-- 选项1：Key类型 → 选项：测试Key/生产Key/临时Key → 自定义类型：__________
-- 选项2：Key用途 → 选项：内部调用/第三方调用/测试调用 → 自定义用途：__________
-
-## 五、原生工程配置（skill可选项，支持多选/自定义补充）
-- 选项1：工程类型 → 选项：iOS工程/Android工程/Flutter工程 → 自定义类型：__________
-- 选项2：配置内容 → 选项：签名配置/权限配置/依赖配置 → 自定义内容：__________
-
-## 六、隐私配置（skill可选项，支持多选/自定义补充）
-- 选项1：隐私类型 → 选项：用户隐私/数据隐私/日志隐私 → 自定义类型：__________
-- 选项2：处理方式 → 选项：加密存储/脱敏展示/定期清理 → 自定义处理：__________
-
-## 七、敏感信息管理（不提交代码库）（skill可选项，支持多选/自定义补充）
-- 选项1：敏感类型 → 选项：密码/密钥/证书 → 自定义类型：__________
-- 选项2：管理方式 → 选项：环境变量/密钥管理服务/配置中心 → 自定义管理：__________
-
-## trae调用参数说明（仅trae触发时使用）
-- 调用路径：skills/templates/Env-SDD.md
-- 必传参数：项目名称、环境类型、环境URL
-- 可选参数：权限配置、敏感信息管理补充内容

package/skills/templates/Flutter/345/205/250/347/261/273/345/236/213/346/265/213/350/257/225/347/255/226/347/225/245SDD.md

@@ -1,162 +0,0 @@
-【claude code调用标识：Flutter全类型测试策略SDD】【trae调用标识：Flutter全类型测试策略SDD+测试方案】【流程场景：1.完整3阶段SDD流程、3.小型功能迭代、4.Bug处理】
-
-# Flutter全类型测试策略SDD：[项目名称]
-
-## 一、Golden截图测试
-
-### 1.1 配置说明
-| 工具 | 版本 | 用途 |
-|------|------|------|
-| flutter_test | 内置 | 基础测试框架 |
-| golden_toolkit | ^0.15.0 | Golden测试增强 |
-
-### 1.2 核心配置
-```dart
-void main() {
-  testGoldens('test widget golden', (tester) async {
-    await tester.pumpWidget(MyWidget());
-    await screenMatchesGolden(tester, 'my_widget_golden');
-  });
-}
-```
-
-### 1.3 边界与优缺点
-| 维度 | 说明 |
-|------|------|
-| 优点 | 自动化视觉回归测试、快速发现UI变化 |
-| 缺点 | 对像素差异敏感、环境差异影响大 |
-| 边界 | 仅测试静态UI、不测试交互逻辑 |
-
----
-
-## 二、E2E端到端测试
-
-### 2.1 配置说明
-| 工具 | 版本 | 用途 |
-|------|------|------|
-| integration_test | 内置 | 集成测试框架 |
-| flutter_driver | 内置 | 驱动测试 |
-
-### 2.2 核心配置
-```dart
-void main() {
-  integrationDriver();
-}
-```
-
-### 2.3 边界与优缺点
-| 维度 | 说明 |
-|------|------|
-| 优点 | 模拟真实用户操作、覆盖完整流程 |
-| 缺点 | 执行速度慢、环境要求高 |
-| 边界 | 依赖真实设备/模拟器、网络环境 |
-
----
-
-## 三、TDD单元测试
-
-### 3.1 配置说明
-| 工具 | 版本 | 用途 |
-|------|------|------|
-| flutter_test | 内置 | 单元测试框架 |
-| mockito | ^5.0.0 | Mock对象 |
-
-### 3.2 核心配置
-```dart
-void main() {
-  test('test calculation', () {
-    final calculator = Calculator();
-    expect(calculator.add(2, 3), equals(5));
-  });
-}
-```
-
-### 3.3 边界与优缺点
-| 维度 | 说明 |
-|------|------|
-| 优点 | 执行速度快、隔离性好、可重复 |
-| 缺点 | 无法测试UI、需要Mock依赖 |
-| 边界 | 仅测试逻辑单元、不测试集成 |
-
----
-
-## 四、冒烟测试
-
-### 4.1 配置说明
-| 工具 | 版本 | 用途 |
-|------|------|------|
-| flutter_test | 内置 | 基础测试框架 |
-| custom_test_runner | 自定义 | 冒烟测试套件 |
-
-### 4.2 核心配置
-```dart
-void main() {
-  group('smoke tests', () {
-    test('app starts', () {
-      expect(true, isTrue);
-    });
-    test('main widget builds', () {
-      // 基础构建测试
-    });
-  });
-}
-```
-
-### 4.3 边界与优缺点
-| 维度 | 说明 |
-|------|------|
-| 优点 | 快速验证、早期发现问题 |
-| 缺点 | 覆盖范围有限、不够深入 |
-| 边界 | 仅验证基本功能、不测试细节 |
-
----
-
-## 五、自动化实现规范
-
-### 5.1 测试目录结构
-```
-test/
-├── unit/              # 单元测试
-├── integration/       # 集成测试  
-├── golden/            # Golden测试
-└── smoke/             # 冒烟测试
-```
-
-### 5.2 测试执行命令
-| 命令 | 用途 |
-|------|------|
-| `flutter test` | 运行所有测试 |
-| `flutter test test/unit/` | 运行单元测试 |
-| `flutter test --update-goldens` | 更新Golden快照 |
-| `flutter drive` | 运行E2E测试 |
-
-### 5.3 CI/CD集成
-| 阶段 | 测试类型 |
-|------|---------|
-| PR检查 | 单元测试、冒烟测试 |
-| 构建前 | Golden测试 |
-| 发布前 | E2E测试 |
-
----
-
-## 六、验收标准
-
-### 6.1 测试覆盖率
-- [ ] 单元测试覆盖率 ≥ 80%
-- [ ] 集成测试覆盖率 ≥ 70%
-- [ ] Golden测试覆盖核心页面
-- [ ] 冒烟测试覆盖启动流程
-
-### 6.2 测试执行
-- [ ] 所有单元测试通过
-- [ ] 所有Golden测试通过
-- [ ] E2E测试覆盖核心流程
-- [ ] 冒烟测试快速通过
-
----
-
-## 七、trae调用参数说明
-- **调用路径**: skills/templates/Flutter全类型测试策略SDD.md
-- **必传参数**: 项目名称
-- **可选参数**: 测试类型（单元/集成/Golden/E2E/冒烟）
-- **流程场景**: 1.完整3阶段SDD流程、3.小型功能迭代、4.Bug处理

package/skills/templates/Flutter/345/234/260/345/233/276/345/257/274/350/210/252/344/270/232/345/212/241SDD.md

@@ -1,136 +0,0 @@
-【claude code调用标识：Flutter地图导航业务SDD】【trae调用标识：Flutter地图导航业务SDD+地图集成】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代】
-
-# Flutter地图导航业务SDD：[项目名称]
-
-## 一、SDK集成
-
-### 1.1 版本锁定
-| SDK | 版本号 | 锁定状态 |
-|------|------|---------|
-| 高德地图Flutter SDK | 【10.0.0】 | 【已锁定】 |
-| amap_flutter_map | 【3.0.0】 | 【已锁定】 |
-| amap_flutter_location | 【3.0.0】 | 【已锁定】 |
-
-### 1.2 依赖配置
-```yaml
-dependencies:
-  amap_flutter_map: ^3.0.0
-  amap_flutter_location: ^3.0.0
-  amap_flutter_base: ^3.0.0
-```
-
-### 1.3 初始化时机
-- [ ] 应用启动时全局初始化一次
-- [ ] 禁止在页面中重复初始化
-- [ ] 初始化完成后缓存实例
-
----
-
-## 二、核心功能
-
-### 2.1 地图显示
-| 功能 | 实现方式 | 验收标准 |
-|------|---------|---------|
-| 地图加载 | MapWidget | 地图正常显示 |
-| 地图类型切换 | mapType | 支持普通/卫星/夜间模式 |
-| 缩放控制 | zoomControls | 支持手势缩放 |
-| 拖动控制 | gestureRecognizers | 支持手势拖动 |
-
-### 2.2 定位服务
-| 功能 | 实现方式 | 验收标准 |
-|------|---------|---------|
-| 首次定位 | LocationPlugin | 进入页面自动定位并居中 |
-| 持续定位 | startLocation | 实时更新位置 |
-| 定位权限 | PermissionHandler | 权限申请流程完整 |
-
-### 2.3 导航功能
-| 功能 | 实现方式 | 验收标准 |
-|------|---------|---------|
-| 路径规划 | AMapNavi | 支持驾车/步行/骑行 |
-| 导航指引 | NaviWidget | 语音+视觉指引 |
-| 实时路况 | TrafficInfo | 显示实时交通状况 |
-
----
-
-## 三、Marker处理
-
-### 3.1 Marker创建
-| 属性 | 说明 | 示例值 |
-|------|------|------|
-| position | 经纬度 | LatLng(39.908860, 116.397390) |
-| icon | 自定义图标 | BitmapDescriptor.fromAsset() |
-| anchor | 锚点位置 | Offset(0.5, 1.0) |
-| infoWindow | 信息窗口 | InfoWindow(title, snippet) |
-
-### 3.2 警告处理
-| 警告类型 | 处理方式 | 代码示例 |
-|----------|---------|---------|
-| 重复添加 | 先remove再add | marker.remove() |
-| 内存泄漏 | dispose时清理 | dispose()中调用clearMarkers() |
-| 图标加载失败 | 备用图标 | fallback icon |
-
-### 3.3 自定义样式
-| 样式类型 | 实现方式 | 适用场景 |
-|---------|---------|---------|
-| 自定义图标 | BitmapDescriptor | 不同类型Marker |
-| 动画效果 | AnimationController | 选中/高亮效果 |
-| 聚合显示 | ClusterManager | 大量Marker |
-
----
-
-## 四、常见问题
-
-### 4.1 地图不显示
-| 排查步骤 | 检查内容 | 解决方案 |
-|---------|---------|---------|
-| 1 | API Key是否正确 | 检查key配置 |
-| 2 | 权限是否开启 | 检查Info.plist/AndroidManifest |
-| 3 | 网络是否正常 | 检查网络连接 |
-| 4 | 依赖是否正确 | 检查pubspec配置 |
-
-### 4.2 定位失败
-| 排查步骤 | 检查内容 | 解决方案 |
-|---------|---------|---------|
-| 1 | 定位权限是否获取 | 请求定位权限 |
-| 2 | 定位服务是否开启 | 提示用户开启 |
-| 3 | 网络定位是否可用 | 切换网络 |
-| 4 | GPS是否开启 | 提示用户开启 |
-
-### 4.3 导航异常
-| 排查步骤 | 检查内容 | 解决方案 |
-|---------|---------|---------|
-| 1 | 起点终点是否有效 | 校验坐标 |
-| 2 | 路径规划是否成功 | 检查API返回 |
-| 3 | 导航组件是否初始化 | 检查初始化流程 |
-| 4 | 语音播报是否正常 | 检查权限和配置 |
-
----
-
-## 五、验收标准
-
-### 5.1 功能验证
-- [ ] 地图正常加载显示
-- [ ] 首次定位自动居中
-- [ ] 手动拖动不自动回弹
-- [ ] Marker点击显示信息窗口
-- [ ] 导航路径规划正确
-
-### 5.2 性能指标
-- [ ] 地图加载时间 ≤ 2秒
-- [ ] 定位响应时间 ≤ 1秒
-- [ ] 内存占用正常（无泄漏）
-- [ ] 动画流畅（60fps）
-
-### 5.3 稳定性测试
-- [ ] 连续运行24小时无崩溃
-- [ ] 切换后台/前台正常
-- [ ] 网络切换后自动恢复
-- [ ] 低内存环境正常运行
-
----
-
-## 六、trae调用参数说明
-- **调用路径**: skills/templates/Flutter地图导航业务SDD.md
-- **必传参数**: 项目名称
-- **可选参数**: SDK版本、功能范围
-- **流程场景**: 1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代