sdd-full 4.0.0 → 4.2.0

package/skills/requesting-code-review/code-reviewer.md

@@ -0,0 +1,146 @@
+# 代码审查代理
+
+你正在审查代码变更的生产就绪程度。
+
+**你的任务：**
+1. 审查 {WHAT_WAS_IMPLEMENTED}
+2. 对照 {PLAN_OR_REQUIREMENTS} 进行比较
+3. 检查代码质量、架构、测试
+4. 按严重程度分类问题
+5. 评估生产就绪程度
+
+## 实现内容
+
+{DESCRIPTION}
+
+## 需求/计划
+
+{PLAN_REFERENCE}
+
+## 待审查的 Git 范围
+
+**Base:** {BASE_SHA}
+**Head:** {HEAD_SHA}
+
+```bash
+git diff --stat {BASE_SHA}..{HEAD_SHA}
+git diff {BASE_SHA}..{HEAD_SHA}
+```
+
+## 审查清单
+
+**代码质量：**
+- 关注点分离是否清晰？
+- 错误处理是否恰当？
+- 类型安全（如适用）？
+- 是否遵循 DRY 原则？
+- 边界情况是否已处理？
+
+**架构：**
+- 设计决策是否合理？
+- 是否考虑了可扩展性？
+- 性能影响如何？
+- 安全方面有无隐患？
+
+**测试：**
+- 测试是否真正测试了逻辑（而不只是 mock）？
+- 边界情况是否覆盖？
+- 需要的地方是否有集成测试？
+- 所有测试是否通过？
+
+**需求：**
+- 是否满足了计划中的所有需求？
+- 实现是否与规格一致？
+- 有无范围蔓延？
+- 破坏性变更是否已记录？
+
+**生产就绪：**
+- 迁移策略（如有 schema 变更）？
+- 是否考虑了向后兼容性？
+- 文档是否完备？
+- 有无明显 bug？
+
+## 输出格式
+
+### 优点
+[做得好的地方？要具体。]
+
+### 问题
+
+#### Critical（必须修复）
+[Bug、安全问题、数据丢失风险、功能异常]
+
+#### Important（应该修复）
+[架构问题、缺失功能、错误处理不足、测试缺口]
+
+#### Minor（可以改进）
+[代码风格、优化机会、文档改进]
+
+**每个问题需包含：**
+- 文件:行号引用
+- 什么有问题
+- 为什么重要
+- 如何修复（如果不明显的话）
+
+### 建议
+[对代码质量、架构或流程的改进建议]
+
+### 评估
+
+**可以合并吗？** [是/否/修复后可以]
+
+**理由：** [1-2 句话的技术评估]
+
+## 关键规则
+
+**应该做的：**
+- 按实际严重程度分类（不是所有问题都是 Critical）
+- 要具体（文件:行号，不要含糊）
+- 解释问题为什么重要
+- 肯定做得好的地方
+- 给出明确结论
+
+**不该做的：**
+- 没仔细看就说"看起来不错"
+- 把小问题标为 Critical
+- 对没有审查的代码给反馈
+- 含糊其辞（"改善错误处理"）
+- 回避给出明确结论
+
+## 输出示例
+
+```
+### 优点
+- 数据库 schema 清晰，迁移规范（db.ts:15-42）
+- 测试覆盖全面（18 个测试，覆盖所有边界情况）
+- 错误处理良好，有降级方案（summarizer.ts:85-92）
+
+### 问题
+
+#### Important
+1. **CLI 包装器缺少帮助文本**
+   - 文件：index-conversations:1-31
+   - 问题：没有 --help 选项，用户无法发现 --concurrency
+   - 修复：添加 --help 分支，附带使用示例
+
+2. **日期校验缺失**
+   - 文件：search.ts:25-27
+   - 问题：无效日期静默返回空结果
+   - 修复：校验 ISO 格式，抛出带示例的错误
+
+#### Minor
+1. **进度指示器**
+   - 文件：indexer.ts:130
+   - 问题：长时间操作没有"X / Y"计数器
+   - 影响：用户不知道还要等多久
+
+### 建议
+- 添加进度报告以改善用户体验
+- 考虑用配置文件管理排除的项目（提高可移植性）
+
+### 评估
+
+**可以合并：修复后可以**
+
+**理由：** 核心实现扎实，架构合理，测试充分。Important 问题（帮助文本、日期校验）容易修复，不影响核心功能。
+```

package/skills/requirement-analysis/sdd-full/SKILL.md

@@ -0,0 +1,54 @@
+# sdd-full - 完整SDD流程
+
+## 功能说明
+
+完整的软件设计文档(SDD)生成流程，覆盖从需求分析到部署运维的全生命周期。
+
+## 触发词
+
+`/sdd`、`SDD`、`软件设计文档`、`完整流程`、`三阶段`
+
+## 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| project_name | string | 是 | 项目名称 |
+| process_type | string | 否 | 流程类型：full（完整三阶段）/ requirement（仅需求）/ design（仅设计）/ test（仅测试） |
+
+## 三阶段流程
+
+### 第一阶段：需求分析
+- 收集业务需求
+- 编写PRD文档
+- 定义验收标准
+
+### 第二阶段：设计规划
+- 系统架构设计
+- UI/UX设计
+- API接口设计
+- 数据库设计
+
+### 第三阶段：开发测试
+- 开发计划制定
+- 测试用例编写
+- 部署方案设计
+
+## 输出
+
+- PRD-SDD：产品需求文档
+- UI-SDD：界面设计文档
+- Code-SDD：代码设计文档
+- API-SDD：接口设计文档
+- Test-SDD：测试设计文档
+- Env-SDD：环境部署文档
+
+## 使用示例
+
+```
+trae调用 sdd-full 项目名称=智能客服系统
+trae调用 sdd-full 项目名称=数据中台 流程类型=design
+```
+
+## 版本
+
+v4.1.0

package/skills/requirement-analysis/unified-flow/SKILL.md

@@ -0,0 +1,45 @@
+# unified-flow - 统一流程入口
+
+## 功能说明
+
+提供完整的软件开发流程管理，支持新项目启动、功能迭代、Bug修复和代码发布四种核心场景。
+
+## 触发词
+
+`/flow`、`流程`、`开发流程`、`项目流程`、`迭代流程`
+
+## 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| project_name | string | 是 | 项目名称 |
+| flow_type | string | 是 | 流程类型：new_project / feature / bug_fix / release |
+
+## 流程选项
+
+### 1. 新项目启动 (new_project)
+- 需求分析 → 架构设计 → 开发计划 → 资源评估
+
+### 2. 功能迭代 (feature)
+- 需求澄清 → 设计评审 → 开发实现 → 测试验收 → 上线发布
+
+### 3. Bug修复 (bug_fix)
+- 问题定位 → 根因分析 → 修复方案 → 测试验证 → 回归测试
+
+### 4. 代码发布 (release)
+- 代码审查 → 版本更新 → 构建验证 → 灰度发布 → 全量上线
+
+## 输出
+
+根据选择的流程类型，输出对应的完整流程文档和执行步骤。
+
+## 使用示例
+
+```
+trae调用 unified-flow 项目名称=电商平台 流程场景=功能迭代
+trae调用 unified-flow 项目名称=移动App 流程场景=Bug修复
+```
+
+## 版本
+
+v4.1.0

package/skills/rules/skill-map.md

@@ -0,0 +1,97 @@
+# SDD 技能地图
+
+## 技能分类体系
+
+### 一、需求分析层 (Requirement Analysis)
+| 技能 | 目录 | 核心功能 |
+|------|------|----------|
+| brainstorming | requirement-analysis/brainstorming | 创意构思与方案探索 |
+| competitive-brief | requirement-analysis/competitive-brief | 竞品分析简报 |
+| market-research | requirement-analysis/market-research | 市场调研 |
+| prd-write | requirement-analysis/prd-write | PRD文档编写 |
+| requirement-completion-officer | requirement-analysis/requirement-completion-officer | 需求补全 |
+| sdd | requirement-analysis/sdd | 标准SDD框架 |
+| sdd-full | requirement-analysis/sdd-full | 完整SDD流程 |
+| unified-flow | requirement-analysis/unified-flow | 统一流程入口 |
+
+### 二、设计规划层 (Design Planning)
+| 技能 | 目录 | 核心功能 |
+|------|------|----------|
+| ui-sdd | design-planning/ui-sdd | UI设计规范 |
+| ui-sdd-specialized | design-planning/ui-sdd-specialized | UI专用模板 |
+| function-sdd | design-planning/function-sdd | 功能SDD专用 |
+| sdd-code | design-planning/sdd-code | 代码设计SDD |
+| sdd-deploy | design-planning/sdd-deploy | 部署SDD |
+| sdd-ops | design-planning/sdd-ops | 运维SDD |
+| sdd-test | design-planning/sdd-test | 测试SDD |
+| writing-plans | design-planning/writing-plans | 编写计划 |
+| flutter-map | design-planning/flutter-map | 地图导航SDD |
+| flutter-av | design-planning/flutter-av | 音视频SDD |
+| enterprise-spec | design-planning/enterprise-spec | 企业规范 |
+| ai-coding-rules | design-planning/ai-coding-rules | AI编码规则 |
+| design-to-code | design-planning/design-to-code | 设计转代码 |
+
+### 三、开发执行层 (Development Execution)
+| 技能 | 目录 | 核心功能 |
+|------|------|----------|
+| sdd-add | development-execution/sdd-add | 新增功能SDD |
+| systematic-debugging | development-execution/systematic-debugging | 系统调试 |
+| test-driven-development | development-execution/test-driven-development | TDD开发 |
+| verification-before-completion | development-execution/verification-before-completion | 完成前验证 |
+| flutter-errors | development-execution/flutter-errors | Flutter异常处理 |
+
+### 四、质量保证层 (Quality Assurance)
+| 技能 | 目录 | 核心功能 |
+|------|------|----------|
+| bdd-acceptance | quality-assurance/bdd-acceptance | BDD验收标准 |
+| flutter-test | quality-assurance/flutter-test | Flutter测试策略 |
+| quality-gate | quality-assurance/quality-gate | 质量门禁 |
+| security-audit | quality-assurance/security-audit | 安全审计 |
+
+### 五、发布运维层 (Release & Ops)
+| 技能 | 目录 | 核心功能 |
+|------|------|----------|
+| finishing-a-development-branch | release-ops/finishing-a-development-branch | 分支完成 |
+| release-flow | release-ops/release-flow | 发布流程 |
+
+### 六、知识沉淀层 (Knowledge Precipitation)
+| 技能 | 目录 | 核心功能 |
+|------|------|----------|
+| claudeception | knowledge-precipitation/claudeception | 技能提取 |
+| mempalace-auto-saver | knowledge-precipitation/mempalace-auto-saver | 记忆自动保存 |
+
+### 七、专项工具层 (Special Tools)
+| 技能 | 目录 | 核心功能 |
+|------|------|----------|
+| env-check | special-tools/env-check | 环境预检 |
+| receiving-code-review | special-tools/receiving-code-review | 代码审查接收 |
+| requesting-code-review | special-tools/requesting-code-review | 代码审查申请 |
+| using-superpowers | special-tools/using-superpowers | 超级能力使用 |
+
+## 流程衔接图
+
+```
+需求分析 → 设计规划 → 开发执行 → 质量保证 → 发布运维
+    ↓            ↓           ↓          ↓          ↓
+  PRD-SDD    UI-SDD      TDD       BDD      部署发布
+  Brain-SDD  Code-SDD    调试       安全审计   运维监控
+  Competitor API-SDD     功能新增   质量门禁   知识沉淀
+```
+
+## 快速检索表
+
+| 场景 | 推荐技能 | 触发词 |
+|------|----------|--------|
+| 新项目启动 | sdd-full | /sdd |
+| 功能迭代 | unified-flow | /flow |
+| Bug修复 | systematic-debugging | bug |
+| 需求澄清 | requirement-completion-officer | 需求 |
+| 编写PRD | prd-write | PRD |
+| UI设计 | ui-sdd-specialized | UI |
+| 功能设计 | function-sdd | 功能 |
+| API设计 | sdd-code | API |
+| 测试设计 | sdd-test / bdd-acceptance | test / BDD |
+| 环境配置 | env-check | env |
+| 代码审查 | requesting-code-review | review |
+| 发布上线 | release-flow | deploy |
+| Flutter开发 | flutter-map / flutter-av / flutter-test / flutter-errors | flutter |

package/skills/rules/user_rules.md

@@ -0,0 +1,69 @@
+# SDD 个人规则
+
+## 技能地图触发词
+
+### 流程类
+- `/flow` - 完整开发流程
+- `/plan` - 规划任务
+- `/sdd` - 启动SDD流程
+
+### 需求分析
+- `需求分析` - 需求澄清与补全
+- `PRD` - 产品需求文档
+- `竞品分析` - 竞争情报分析
+- `头脑风暴` - 创意构思
+
+### 设计规划
+- `UI设计` - UI设计稿转SDD
+- `功能设计` - 功能SDD
+- `架构设计` - 系统架构
+- `代码设计` - Code-SDD
+
+### 开发执行
+- `TDD` - 测试驱动开发
+- `调试` - 系统调试
+- `功能新增` - 添加新功能
+
+### 质量保证
+- `BDD` - 行为驱动验收
+- `质量门禁` - 质量检查
+- `安全审计` - 安全审查
+
+### 发布运维
+- `发布流程` - 代码发布
+- `部署方案` - 部署SDD
+
+## 技能决策树
+
+### 第一步：确定任务类型
+1. **新项目启动** → sdd-full 完整流程
+2. **功能迭代** → unified-flow 功能迭代流程
+3. **Bug修复** → unified-flow Bug修复流程
+4. **代码发布** → unified-flow 代码发布流程
+
+### 第二步：选择输出类型
+1. **需求文档** → PRD-SDD / Brain-SDD
+2. **设计文档** → UI-SDD / Code-SDD / API-SDD
+3. **测试文档** → Test-SDD / BDD验收标准
+4. **部署文档** → Env-SDD / Deploy-SDD
+
+### 第三步：专项技能
+- **UI设计转代码** → ui-sdd-specialized / design-to-code
+- **Flutter专项** → flutter-map / flutter-av / flutter-test / flutter-errors
+- **企业级规范** → enterprise-spec
+- **AI编码规则** → ai-coding-rules
+
+## 快捷键触发
+
+| 触发词 | 技能 | 适用场景 |
+|--------|------|----------|
+| `/flow` | unified-flow | 完整开发流程 |
+| `/plan` | writing-plans | 编写执行计划 |
+| `/sdd` | sdd-full | SDD全流程 |
+| `bug` | systematic-debugging | 系统调试 |
+| `test` | test-driven-development | TDD开发 |
+| `deploy` | release-flow | 发布流程 |
+| `security` | security-audit | 安全审计 |
+| `ui` | ui-sdd-specialized | UI专用SDD |
+| `bdd` | bdd-acceptance | BDD验收 |
+| `env` | env-check | 环境预检 |

package/skills/special-tools/env-check/SKILL.md

@@ -0,0 +1,47 @@
+# env-check - 环境预检标准化
+
+## 功能说明
+
+本机配置、依赖版本、网络连接预检固定话术与流程规范。
+
+## 触发词
+
+`环境预检`、`环境检查`、`系统检查`、`配置检查`
+
+## 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| project_name | string | 是 | 项目名称 |
+| environment | string | 否 | 目标环境：development/test/production |
+
+## 预检内容
+
+### 1. 本机配置检查
+- 操作系统版本
+- CPU/内存/磁盘使用
+- Node.js版本
+- 开发工具版本
+
+### 2. 依赖版本检查
+- package.json 依赖
+- 第三方SDK版本
+- 数据库连接
+- API服务状态
+
+### 3. 网络连接检查
+- 本地服务端口
+- 外部API连通性
+- 代理配置
+- SSL证书
+
+## 使用示例
+
+```
+trae调用 环境预检标准化SDD 项目名称=个人备忘录APP
+trae调用 环境预检标准化SDD 项目名称=电商平台 环境=production
+```
+
+## 版本
+
+v4.1.0