sdd-full 5.0.1 → 5.0.3

package/.claude/skills/sdd-common/SKILL.md

@@ -0,0 +1,378 @@
+---
+name: "sdd-common"
+description: "SDD全流程通用可复用技能集合"
+---
+
+# SDD Common - SDD全流程通用可复用技能集合
+
+## 技能索引
+
+### 需求分析类
+- [brainstorming](#brainstorming) - 创意头脑风暴
+- [market-research](#market-research) - 市场调研
+- [competitive-brief](#competitive-brief) - 竞品简报
+- [prd-write](#prd-write) - PRD文档编写
+- [requirement-completion-officer](#requirement-completion-officer) - 需求补全
+- [sdd](#sdd) - 基础SDD拆分
+
+### 设计规划类
+- [ui-sdd](#ui-sdd) - UI交互SDD
+- [sdd-code](#sdd-code) - 功能实现SDD
+- [sdd-test](#sdd-test) - 测试SDD
+- [sdd-deploy](#sdd-deploy) - 部署SDD
+- [writing-plans](#writing-plans) - 制定计划
+- [ui-motion-interaction-standard](#ui-motion-interaction-standard) - UI动效交互标准
+
+### 开发执行类
+- [sdd-add](#sdd-add) - 快速迭代
+- [test-driven-development](#test-driven-development) - TDD开发
+- [systematic-debugging](#systematic-debugging) - 系统化调试
+- [verification-before-completion](#verification-before-completion) - 完成前验证
+- [design-to-code](#design-to-code) - 设计转代码
+- [performance-optimize](#performance-optimize) - 性能优化
+
+### Flutter专项类
+- [flutter-apply-architecture-best-practices](#flutter-apply-architecture-best-practices) - Flutter架构适配
+- [flutter-build-responsive-layout](#flutter-build-responsive-layout) - 响应式布局适配
+- [flutter-setup-declarative-routing](#flutter-setup-declarative-routing) - 页面导航配置
+- [flutter-setup-localization](#flutter-setup-localization) - 本地化配置
+- [flutter-implement-json-serialization](#flutter-implement-json-serialization) - 数据模型转换
+- [flutter-use-http-package](#flutter-use-http-package) - 前端网络请求
+- [flutter-fix-layout-issues](#flutter-fix-layout-issues) - 修复UI布局问题
+- [flutter-errors](#flutter-errors) - Flutter专项错误处理
+- [flutter-test](#flutter-test) - Flutter测试
+- [flutter-add-widget-test](#flutter-add-widget-test) - 添加Widget测试
+- [flutter-add-integration-test](#flutter-add-integration-test) - 添加集成测试
+- [flutter-add-widget-preview](#flutter-add-widget-preview) - 添加Widget预览
+- [ios-full-auto-debug](#ios-full-auto-debug) - iOS全自动调试
+
+### 质量保障类
+- [quality-gate](#quality-gate) - 质量门禁
+- [security-audit](#security-audit) - 安全审计
+- [bdd-acceptance](#bdd-acceptance) - BDD验收
+- [bug-reproduction-confirm](#bug-reproduction-confirm) - Bug复现确认
+- [requesting-code-review](#requesting-code-review) - 请求代码审查
+- [receiving-code-review](#receiving-code-review) - 接收代码审查
+
+### 发布运维类
+- [finishing-a-development-branch](#finishing-a-development-branch) - 完成开发分支
+- [release-flow](#release-flow) - 发布流程管理
+
+### 知识沉淀类
+- [claudeception](#claudeception) - 持续学习
+- [mempalace-auto-saver](#mempalace-auto-saver) - 记忆宫殿自动保存
+
+### 工具类
+- [writing-skills](#writing-skills) - 编写技能
+- [env-check](#env-check) - 环境检查
+- [design-contract-expert](#design-contract-expert) - 设计契约专家
+
+---
+
+## 技能详情
+
+### brainstorming
+**描述**: 创意头脑风暴
+**适用场景**: 新项目创意阶段、功能创新、用户体验设计
+**关键输出**: 创意清单、需求分析、技术方案评估
+
+---
+
+### market-research
+**描述**: 市场调研
+**适用场景**: 新项目立项、产品定位、市场机会分析
+**关键输出**: 市场调研报告、目标用户分析、市场规模评估、趋势分析
+
+---
+
+### competitive-brief
+**描述**: 竞品简报
+**适用场景**: 竞品分析、差异化定位、功能规划
+**关键输出**: 竞品分析简报、功能对比矩阵、优劣势分析
+
+---
+
+### prd-write
+**描述**: PRD文档编写
+**适用场景**: 产品需求定义、功能规划、验收标准制定
+**关键输出**: 完整PRD文档
+
+---
+
+### requirement-completion-officer
+**描述**: 需求补全
+**适用场景**: 需求澄清、细节补充、边界条件定义
+**关键输出**: 需求补全文档
+
+---
+
+### sdd
+**描述**: 基础SDD拆分
+**适用场景**: 需求转设计、用户故事拆分、架构设计
+**关键输出**: 基础SDD文档、用户故事、前后端架构、数据库设计、API契约
+
+---
+
+### ui-sdd
+**描述**: UI交互SDD
+**适用场景**: UI设计、交互设计、页面规范
+**关键输出**: UI交互SDD文档、页面组件清单、交互逻辑
+
+---
+
+### sdd-code
+**描述**: 功能实现SDD
+**适用场景**: 技术实现设计、代码规范定义、技术债务管理
+**关键输出**: 功能实现SDD文档
+
+---
+
+### sdd-test
+**描述**: 测试SDD
+**适用场景**: 测试规划、测试用例设计、质量保证
+**关键输出**: 测试SDD文档、单元/集成/E2E测试设计
+
+---
+
+### sdd-deploy
+**描述**: 部署SDD
+**适用场景**: 部署规划、环境配置、发布流程设计
+**关键输出**: 部署SDD文档
+
+---
+
+### writing-plans
+**描述**: 制定计划
+**适用场景**: 项目计划、实施计划、测试计划
+**关键输出**: 计划文档、Todo清单
+
+---
+
+### ui-motion-interaction-standard
+**描述**: UI动效交互标准
+**适用场景**: UI动效设计、交互体验优化
+**关键输出**: 动效规范文档
+
+---
+
+### sdd-add
+**描述**: 快速迭代
+**适用场景**: 临时需求、快速功能添加、Bug修复
+**关键输出**: 快速实现文档、技术债务记录
+
+---
+
+### test-driven-development
+**描述**: TDD开发
+**适用场景**: 测试先行、质量保证、代码质量
+**关键输出**: 测试用例、实现代码
+
+---
+
+### systematic-debugging
+**描述**: 系统化调试
+**适用场景**: 复杂Bug定位、问题分析
+**关键输出**: 调试记录、修复方案
+
+---
+
+### verification-before-completion
+**描述**: 完成前验证
+**适用场景**: 发布前验证、质量确认
+**关键输出**: 验证报告
+
+---
+
+### design-to-code
+**描述**: 设计转代码
+**适用场景**: UI实现、设计还原
+**关键输出**: 实现代码
+
+---
+
+### performance-optimize
+**描述**: 性能优化
+**适用场景**: 性能问题修复、性能提升
+**关键输出**: 优化方案、性能报告
+
+---
+
+### flutter-apply-architecture-best-practices
+**描述**: Flutter架构适配
+**适用场景**: Flutter项目架构设计
+**关键输出**: 架构文档
+
+---
+
+### flutter-build-responsive-layout
+**描述**: 响应式布局适配
+**适用场景**: 多端适配、响应式设计
+**关键输出**: 布局代码
+
+---
+
+### flutter-setup-declarative-routing
+**描述**: 页面导航配置
+**适用场景**: 路由设计、页面导航
+**关键输出**: 路由配置
+
+---
+
+### flutter-setup-localization
+**描述**: 本地化配置
+**适用场景**: 多语言支持
+**关键输出**: 本地化配置
+
+---
+
+### flutter-implement-json-serialization
+**描述**: 数据模型转换
+**适用场景**: 数据处理、API对接
+**关键输出**: 数据模型代码
+
+---
+
+### flutter-use-http-package
+**描述**: 前端网络请求
+**适用场景**: API调用、网络请求
+**关键输出**: 网络请求代码
+
+---
+
+### flutter-fix-layout-issues
+**描述**: 修复UI布局问题
+**适用场景**: UI问题修复、布局调整
+**关键输出**: 修复代码
+
+---
+
+### flutter-errors
+**描述**: Flutter专项错误处理
+**适用场景**: Flutter错误处理、问题定位
+**关键输出**: 错误处理代码
+
+---
+
+### flutter-test
+**描述**: Flutter测试
+**适用场景**: Flutter项目测试
+**关键输出**: 测试代码
+
+---
+
+### flutter-add-widget-test
+**描述**: 添加Widget测试
+**适用场景**: Widget单元测试
+**关键输出**: Widget测试代码
+
+---
+
+### flutter-add-integration-test
+**描述**: 添加集成测试
+**适用场景**: 集成测试
+**关键输出**: 集成测试代码
+
+---
+
+### flutter-add-widget-preview
+**描述**: 添加Widget预览
+**适用场景**: UI预览、开发调试
+**关键输出**: 预览代码
+
+---
+
+### ios-full-auto-debug
+**描述**: iOS全自动调试
+**适用场景**: iOS真机调试、问题定位
+**关键输出**: 调试记录、修复方案
+
+---
+
+### quality-gate
+**描述**: 质量门禁
+**适用场景**: 发布前质量检查、质量保证
+**关键输出**: 质量报告、通过/不通过决策
+
+---
+
+### security-audit
+**描述**: 安全审计
+**适用场景**: 安全检查、漏洞修复
+**关键输出**: 安全审计报告、修复方案
+
+---
+
+### bdd-acceptance
+**描述**: BDD验收
+**适用场景**: 验收测试、用户故事验证
+**关键输出**: 验收测试报告
+
+---
+
+### bug-reproduction-confirm
+**描述**: Bug复现确认
+**适用场景**: Bug确认、问题定位
+**关键输出**: Bug复现报告
+
+---
+
+### requesting-code-review
+**描述**: 请求代码审查
+**适用场景**: 代码审查发起
+**关键输出**: 审查请求
+
+---
+
+### receiving-code-review
+**描述**: 接收代码审查
+**适用场景**: 代码审查反馈处理
+**关键输出**: 审查反馈处理
+
+---
+
+### finishing-a-development-branch
+**描述**: 完成开发分支
+**适用场景**: 分支合并、代码清理、文档归档
+**关键输出**: 合并后的代码、归档文档
+
+---
+
+### release-flow
+**描述**: 发布流程管理
+**适用场景**: 版本发布、部署管理
+**关键输出**: 发布记录、发布报告
+
+---
+
+### claudeception
+**描述**: 持续学习
+**适用场景**: 经验记录、技能沉淀、知识管理
+**关键输出**: 经验文档、可复用技能
+
+---
+
+### mempalace-auto-saver
+**描述**: 记忆宫殿自动保存
+**适用场景**: 知识存储、经验管理
+**关键输出**: 记忆宫殿记录
+
+---
+
+### writing-skills
+**描述**: 编写技能
+**适用场景**: 技能创建、文档编写
+**关键输出**: 技能文档
+
+---
+
+### env-check
+**描述**: 环境检查
+**适用场景**: 环境诊断、问题排查
+**关键输出**: 环境检查报告
+
+---
+
+### design-contract-expert
+**描述**: 设计契约专家
+**适用场景**: API设计、接口契约
+**关键输出**: 契约文档

package/{skills → .claude/skills}/sdd-full/SKILL.md

@@ -2,7 +2,7 @@
 
 ---
 name: sdd-full-flow
-description: "SDD全流程开发 - 提供5个流程选项：完整3阶段流程、从零开始新项目、小型功能迭代、Bug处理、代码发布"
+description: "Use when starting a new project from scratch, performing small feature iterations, handling bugs, or releasing code"
 ---
 
 <TRIGGER-WORDS>

package/.claude/standards/api-standard.md

@@ -0,0 +1,93 @@
+# API 规范模板
+
+## 1. RESTful 设计原则
+
+### 1.1 资源命名
+- 使用名词复数形式：`/users`, `/orders`
+- 使用小写字母和连字符：`/user-profiles`
+- 层级关系清晰：`/users/{id}/orders`
+
+### 1.2 HTTP 方法
+- `GET` - 获取资源
+- `POST` - 创建资源
+- `PUT` - 完整更新资源
+- `PATCH` - 部分更新资源
+- `DELETE` - 删除资源
+
+## 2. URL 结构
+
+```
+{protocol}://{domain}/api/{version}/{resource}/{id}/{sub-resource}
+```
+
+示例：
+- `https://api.example.com/v1/users`
+- `https://api.example.com/v1/users/123/orders`
+
+## 3. 请求规范
+
+### 3.1 请求头
+```
+Content-Type: application/json
+Authorization: Bearer {token}
+Accept: application/json
+```
+
+### 3.2 查询参数
+- 分页：`page`, `limit`
+- 排序：`sort_by`, `sort_order`
+- 过滤：`filter_{field}`
+- 搜索：`q`
+
+## 4. 响应规范
+
+### 4.1 成功响应
+```json
+{
+  "success": true,
+  "data": {},
+  "message": "操作成功"
+}
+```
+
+### 4.2 错误响应
+```json
+{
+  "success": false,
+  "error": {
+    "code": "ERROR_CODE",
+    "message": "错误描述",
+    "details": {}
+  }
+}
+```
+
+### 4.3 HTTP 状态码
+- `200 OK` - 成功
+- `201 Created` - 创建成功
+- `400 Bad Request` - 请求参数错误
+- `401 Unauthorized` - 未授权
+- `403 Forbidden` - 无权限
+- `404 Not Found` - 资源不存在
+- `500 Internal Server Error` - 服务器错误
+
+## 5. 版本控制
+
+- URL 中包含版本号：`/api/v1/`
+- 版本变更需向后兼容至少一个版本
+
+## 6. 安全规范
+
+- 使用 HTTPS
+- 认证使用 JWT 或 OAuth 2.0
+- 敏感数据加密传输
+- 请求频率限制
+- SQL 注入防护
+- XSS 防护
+
+## 7. 文档规范
+
+- 使用 OpenAPI/Swagger 规范
+- 提供在线 API 文档
+- 包含请求/响应示例
+- 说明错误码含义

package/.claude/standards/code-standard.md

@@ -0,0 +1,72 @@
+# 代码规范模板
+
+## 1. 命名规范
+
+### 1.1 文件命名
+- 文件名使用小写字母和下划线分隔（snake_case）
+- 组件文件使用帕斯卡命名（PascalCase）
+- 常量文件使用全大写下划线分隔（UPPER_SNAKE_CASE）
+
+### 1.2 变量与函数
+- 变量：小驼峰命名（camelCase）
+- 常量：全大写下划线分隔（UPPER_SNAKE_CASE）
+- 函数：小驼峰命名（camelCase）
+- 类和构造函数：帕斯卡命名（PascalCase）
+
+### 1.3 私有成员
+- 私有变量和方法使用下划线前缀 `_privateVariable`
+
+## 2. 代码风格
+
+### 2.1 缩进
+- 使用 2 或 4 个空格缩进（项目统一）
+- 不要使用 Tab
+
+### 2.2 引号
+- 字符串优先使用单引号或双引号（项目统一）
+- 模板字符串使用反引号
+
+### 2.3 分号
+- 始终使用分号结束语句
+
+### 2.4 行长度
+- 每行不超过 100-120 字符
+
+## 3. 注释规范
+
+### 3.1 文件头部
+```
+/**
+ * 文件名: xxx.js
+ * 描述: 文件功能描述
+ * 作者: 作者名
+ * 创建日期: YYYY-MM-DD
+ */
+```
+
+### 3.2 函数注释
+```javascript
+/**
+ * 函数功能描述
+ * @param {Type} paramName - 参数说明
+ * @returns {Type} 返回值说明
+ */
+```
+
+## 4. 错误处理
+
+- 必须处理 Promise 的 reject
+- 使用 try-catch 捕获同步错误
+- 错误信息要有意义，便于调试
+
+## 5. 性能规范
+
+- 避免不必要的 DOM 操作
+- 使用防抖和节流处理频繁触发的事件
+- 合理使用缓存
+
+## 6. 测试规范
+
+- 核心功能必须编写单元测试
+- 测试覆盖率目标 > 80%
+- 测试用例描述要清晰

package/.claude/standards/database-standard.md

@@ -0,0 +1,87 @@
+# 数据库规范模板
+
+## 1. 命名规范
+
+### 1.1 表名
+- 使用小写字母和下划线分隔
+- 使用复数形式：`users`, `orders`
+- 避免使用数据库保留字
+
+### 1.2 字段名
+- 使用小写字母和下划线分隔
+- 布尔值以 `is_`, `has_`, `can_` 开头：`is_active`, `has_permission`
+- 时间戳：`created_at`, `updated_at`, `deleted_at`
+
+### 1.3 索引名
+- 普通索引：`idx_{table}_{column}`
+- 唯一索引：`uk_{table}_{column}`
+- 复合索引：`idx_{table}_{col1}_{col2}`
+
+## 2. 表设计规范
+
+### 2.1 必备字段
+每个表必须包含：
+```sql
+id INT PRIMARY KEY AUTO_INCREMENT,
+created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+deleted_at TIMESTAMP NULL DEFAULT NULL
+```
+
+### 2.2 字段类型
+- ID：`BIGINT UNSIGNED AUTO_INCREMENT` 或 UUID
+- 金额：`DECIMAL(10, 2)`
+- 状态：`TINYINT` 或 `ENUM`
+- 文本：`VARCHAR(255)` 或 `TEXT`
+- JSON：`JSON` 类型（MySQL 5.7+）
+
+## 3. 索引规范
+
+### 3.1 索引原则
+- 主键自动创建索引
+- 外键必须创建索引
+- 频繁查询的字段创建索引
+- 避免在小表或更新频繁的字段创建索引
+
+### 3.2 复合索引
+- 遵循最左前缀原则
+- 区分度高的字段放前面
+
+## 4. SQL 编写规范
+
+### 4.1 查询规范
+- 使用 `SELECT *` 仅在必要时
+- 使用 `LIMIT` 限制返回行数
+- 避免使用 `OR`，改用 `IN` 或 `UNION`
+- 合理使用 `JOIN`，避免过度连接
+
+### 4.2 写入规范
+- 使用批量插入代替单条插入
+- 事务处理确保数据一致性
+- 避免大事务
+
+## 5. 数据安全
+
+### 5.1 数据加密
+- 密码使用 bcrypt/argon2 哈希
+- 敏感字段加密存储
+- 传输使用 SSL/TLS
+
+### 5.2 访问控制
+- 最小权限原则
+- 不同环境使用不同账号
+- 记录数据库操作日志
+
+## 6. 备份与恢复
+
+- 定期全量备份
+- 增量备份
+- 备份恢复测试
+- 异地备份
+
+## 7. 性能优化
+
+- 定期分析慢查询
+- 优化查询语句
+- 合理使用缓存
+- 定期维护表