sdd-full 5.0.1 → 5.0.3

package/.claude/agents/ux-requirement-agent.md

@@ -0,0 +1,86 @@
+---
+name: "UX Requirement Agent"
+role: "需求与用户体验Agent"
+description: "负责需求采集、用户研究、PRD编写，集成brainstorming、market-research、prd-write等技能"
+slots:
+  - name: "project_name"
+    description: "项目名称"
+    type: "string"
+  - name: "requirement_scope"
+    description: "需求范围"
+    type: "string"
+  - name: "mode"
+    description: "需求模式"
+    type: "enum"
+    enum_values: ["full", "lite"]
+  - name: "include_market_research"
+    description: "是否包含市场调研"
+    type: "boolean"
+---
+
+# UX Requirement Agent - 需求与用户体验Agent
+
+## 核心职责
+负责需求采集、用户研究、PRD编写，为产品提供完整的需求定义和用户体验规划
+
+## 核心技能分配
+
+### 头脑风暴
+- **技能**：brainstorming
+- **输出**：头脑风暴记录
+- **内容**：需求探索、功能创意、用户体验设计
+
+### 市场调研
+- **技能**：market-research
+- **输出**：市场调研报告
+- **内容**：目标用户分析、市场规模评估、趋势分析、痛点识别
+
+### 竞品分析
+- **技能**：competitive-brief
+- **输出**：竞品分析简报
+- **内容**：竞品功能对比、优劣势分析、差异化机会
+
+### PRD编写
+- **技能**：prd-write
+- **输出**：完整PRD文档
+- **内容**：产品目标、功能需求、非功能需求、用户故事、验收标准
+
+## 工作流程
+
+### 完整模式
+```
+1. 头脑风暴（可选）
+   ↓
+2. 市场调研（可选）
+   ↓
+3. 竞品分析（可选）
+   ↓
+4. PRD编写
+   ↓
+5. 用户确认
+```
+
+### 快速模式
+```
+1. 需求澄清
+   ↓
+2. PRD编写（精简版）
+   ↓
+3. 用户确认
+```
+
+## 输出文档结构
+```
+项目根/
+└── docs/
+    ├── brainstorming.md      # 头脑风暴记录
+    ├── market-research.md    # 市场调研报告
+    ├── competitive-brief.md  # 竞品分析简报
+    └── prd.md                # PRD文档
+```
+
+## 强制检查清单
+- [ ] 头脑风暴完成（如需要）
+- [ ] 市场调研完成（如需要）
+- [ ] 竞品分析完成（如需要）
+- [ ] PRD文档完成并用户确认

package/.claude/commands/bug.md

@@ -0,0 +1,36 @@
+---
+description: /bug command
+argument-hint:
+---
+
+当用户输入 /bug 命令时，执行以下流程：
+
+1. 显示Bug类型选项，让用户选择：
+   - **1 - 简单Bug（已知原因）**：直接修复
+   - **2 - 复杂Bug（原因不明）**：需要排查定位
+   - **3 - 性能问题**：需要性能优化
+   - **4 - 安全漏洞**：需要安全审计
+   - **5 - 回归Bug**：需要补充测试
+   - **6 - Flutter iOS真机调试**：需要环境检查
+
+2. 根据用户选择的类型，执行对应流程：
+
+   **简单Bug（已知原因）**：
+   直接修复 → 触发 verification-before-completion → 触发 quality-gate → 触发 claudeception
+
+   **复杂Bug（原因不明）**：
+   触发 bug-reproduction-confirm → 触发 systematic-debugging → 触发 verification-before-completion → 触发 quality-gate → 触发 claudeception
+
+   **性能问题**：
+   触发 performance-optimize → 触发 verification-before-completion → 触发 quality-gate → 触发 claudeception
+
+   **安全漏洞**：
+   触发 security-audit → 触发 bug-reproduction-confirm → 触发 systematic-debugging → 触发 verification-before-completion → 触发 quality-gate → 触发 security-audit → 触发 claudeception
+
+   **回归Bug**：
+   触发 bug-reproduction-confirm → 触发 systematic-debugging → 补充 Test-SDD → 修复 → 触发 verification-before-completion → 触发 quality-gate → 触发 claudeception
+
+   **Flutter iOS真机调试**：
+   触发 env-check → 触发 bug-reproduction-confirm → 触发 flutter-errors → 定位修复 → 真机验证 → 触发 verification-before-completion → 触发 quality-gate → 触发 claudeception
+
+3. 每个步骤完成后，等待用户确认再进入下一步

package/.claude/commands/debug.md

@@ -0,0 +1,21 @@
+---
+description: /debug command
+argument-hint:
+---
+
+当用户输入 /debug 命令时，执行以下流程：
+
+1. 触发 systematic-debugging（系统化调试）
+   - 分析错误信息或问题描述
+   - 定位根因
+   - 提出修复方案
+
+2. 确认修复方案后，执行修复
+
+3. 触发 verification-before-completion（提交前验证）
+
+4. 验证通过后，触发 quality-gate（质量门禁检查）
+
+5. 触发 claudeception 进行经验沉淀
+
+6. 每个步骤完成后，等待用户确认再进入下一步

package/.claude/commands/dev.md

@@ -0,0 +1,22 @@
+---
+description: /dev command
+argument-hint:
+---
+
+当用户输入 /dev 命令时，执行以下流程：
+
+1. 确认需求是否明确：
+   - 如果需求不明确，先触发 requirement-completion-officer（需求补全），补全后再继续
+   - 如果需求已明确，直接进入下一步
+
+2. 触发 sdd-add（快速开发落地）
+   - 如果需要UI设计，补充调用 ui-sdd
+   - 如果需要制定计划，补充调用 writing-plans
+
+3. 开发完成后，触发 verification-before-completion（提交前验证）
+
+4. 验证通过后，触发 quality-gate（质量门禁检查）
+
+5. 所有步骤完成后，确认是否需要触发 claudeception 进行知识沉淀
+
+6. 每个步骤完成后，等待用户确认再进入下一步

package/.claude/commands/env.md

@@ -0,0 +1,22 @@
+---
+description: /env command
+argument-hint:
+---
+
+当用户输入 /env 命令时，执行以下流程：
+
+1. 触发 env-check（环境预检）
+
+2. 执行环境检查：
+   - 开发工具版本检查（Node.js, npm, Flutter等）
+   - 依赖版本检查
+   - 网络连接检查
+   - 项目配置完整性检查
+
+3. 输出检查报告，列出：
+   - 通过项
+   - 未通过项及修复建议
+
+4. 如有未通过项，引导用户按修复建议处理
+
+5. 确认环境检查全部通过后结束流程

package/.claude/commands/flow.md

@@ -0,0 +1,63 @@
+---
+description: /flow command
+argument-hint:
+---
+
+当用户输入 /flow 命令时，执行以下流程：
+
+1. 显示完整的技能决策树，按分类列出所有技能：
+
+   **需求分析类**
+   - brainstorming — 头脑风暴、创意、想法、需求发散
+   - market-research — 市场调研、竞品分析、用户需求
+   - competitive-brief — 竞品简报、竞品对比
+   - prd-write — 写PRD、产品需求文档
+   - requirement-completion-officer — 需求补全、需求澄清
+   - sdd — SDD拆分、需求拆分
+   - sdd-full — 完整SDD流程、全流程
+
+   **设计规划类**
+   - ui-sdd — UI设计、界面设计、交互设计
+   - sdd-code — 代码设计、实现方案、技术方案
+   - sdd-test — 测试设计、测试方案
+   - sdd-deploy — 部署设计、发布方案
+   - sdd-ops — 运维设计、监控方案
+   - writing-plans — 制定计划、开发计划
+
+   **开发执行类**
+   - sdd-add — 快速开发、小功能、临时需求
+   - test-driven-development — TDD、测试驱动、先写测试
+   - systematic-debugging — 调试、Bug排查、问题定位
+   - verification-before-completion — 验证、代码检查、提交前检查
+
+   **质量保障类**
+   - quality-gate — 质量检查、门禁、发布检查
+   - security-audit — 安全检查、安全审计
+
+   **发布运维类**
+   - finishing-a-development-branch — 完成分支、合并分支
+   - release-flow — 发布流程、版本发布
+
+   **知识沉淀类**
+   - claudeception — 提取技能、保存经验、持续学习
+   - mempalace-auto-saver — 保存记忆、自动存档
+
+   **专项工具类**
+   - using-superpowers — 全流程、自动化流程
+   - requesting-code-review — 请求审查、代码审查
+   - receiving-code-review — 接收审查、处理审查意见
+
+2. 显示快捷命令列表：
+
+   | 命令 | 用途 |
+   |------|------|
+   | /bug | Bug修复流程（6种类型） |
+   | /dev | 小型功能迭代开发 |
+   | /full | 完整SDD流程（5个选项） |
+   | /release | 代码发布流程 |
+   | /flow | 显示本技能决策树 |
+   | /save | 知识沉淀 |
+   | /new | 新项目完整流程 |
+   | /review | 代码审查 |
+
+3. 询问用户需要执行哪个技能或命令，根据选择触发对应操作

package/.claude/commands/full.md

@@ -0,0 +1,32 @@
+---
+description: /full command
+argument-hint:
+---
+
+当用户输入 /full 命令时，执行以下流程：
+
+1. 展示 5 个流程选项，让用户选择：
+
+   **1 - 完整3阶段SDD流程**
+   适用于大型项目，需要完整的SDD全流程
+   执行路径：sdd-full（完整SDD流程）
+
+   **2 - 从零开始新项目**
+   适用于新项目立项，需要创意、调研、PRD
+   执行路径：brainstorming → prd-write → sdd/sdd-full
+
+   **3 - 小型功能迭代**
+   适用于快速迭代、小功能开发
+   执行路径：requirement-completion-officer → sdd-add → verification-before-completion → quality-gate
+
+   **4 - Bug处理**
+   适用于Bug修复、调试问题
+   执行路径：参照 /bug 命令的6种Bug类型选项
+
+   **5 - 代码发布**
+   适用于版本发布、质量检查
+   执行路径：verification-before-completion → quality-gate → finishing-a-development-branch → sdd-deploy → release-flow
+
+2. 根据用户选择的选项，触发对应的流程
+
+3. 每个步骤完成后，等待用户确认再进入下一步

package/.claude/commands/iter.md

@@ -0,0 +1,22 @@
+---
+description: /iter command
+argument-hint:
+---
+
+当用户输入 /iter 命令时，执行以下流程：
+
+1. 确认需求是否明确：
+   - 如果需求不明确，先触发 requirement-completion-officer（需求补全）
+   - 如果需求已明确，直接进入下一步
+
+2. 触发 sdd-add（快速开发落地）
+   - 如果涉及UI设计，补充调用 ui-sdd
+   - 如果需要制定计划，补充调用 writing-plans
+
+3. 开发完成后，触发 verification-before-completion（提交前验证）
+
+4. 验证通过后，触发 quality-gate（质量门禁检查）
+
+5. 可选：触发 claudeception 进行经验沉淀
+
+6. 每个步骤完成后，等待用户确认再进入下一步

package/.claude/commands/new.md

@@ -0,0 +1,25 @@
+---
+description: /new command
+argument-hint:
+---
+
+当用户输入 /new 命令时，执行以下流程：
+
+1. 显示新项目启动选项，让用户选择是否需要：
+   - **市场调研/头脑风暴**：如果需要，触发 brainstorming 或 market-research
+   - **竞品分析**：如果需要，触发 competitive-brief
+   - **PRD编写**：如果需要，触发 prd-write
+
+2. 触发需求补全（requirement-completion-officer），确保需求明确
+
+3. 触发 SDD拆分（sdd / sdd-full），按扩展需求和优先级拆分
+
+4. 后续流程依次触发：
+   - UI设计（ui-sdd）
+   - 功能实现拆分（sdd-code，含代码规范、技术债务、重构计划）
+   - 测试设计（sdd-test）
+   - 部署设计（sdd-deploy，可选）
+   - 制定计划（writing-plans，可选）
+   - 开始开发（sdd-add / test-driven-development）
+
+5. 每个步骤完成后，等待用户确认再进入下一步

package/.claude/commands/release.md

@@ -0,0 +1,28 @@
+---
+description: /release command
+argument-hint:
+---
+
+当用户输入 /release 命令时，执行以下流程：
+
+1. 触发 verification-before-completion（提交前验证）
+   - 检查代码完整性、测试覆盖率、潜在问题
+   - 验证通过后进入下一步
+
+2. 触发 quality-gate（质量门禁检查）
+   - 执行全面质量检查
+   - 检查通过后进入下一步
+
+3. 确认开发分支是否已完成：
+   - 如果是，触发 finishing-a-development-branch（完成并合并开发分支）
+   - 如果否，跳过此步骤
+
+4. 触发 sdd-deploy（部署设计，可选）
+   - 如果需要部署设计则执行，否则跳过
+
+5. 触发 release-flow（发布管理）
+   - 执行完整发布生命周期管理
+
+6. 发布完成后，确认是否需要触发 claudeception 进行知识沉淀
+
+7. 每个步骤完成后，等待用户确认再进入下一步

package/.claude/commands/review.md

@@ -0,0 +1,19 @@
+---
+description: /review command
+argument-hint:
+---
+
+当用户输入 /review 命令时，执行以下流程：
+
+1. 触发 requesting-code-review（发起代码审查请求）
+   - 分析当前代码变更
+   - 生成审查请求内容
+
+2. 触发 receiving-code-review（接收并处理审查反馈）
+   - 处理审查意见
+   - 根据反馈修改代码
+   - 确认审查通过
+
+3. 审查通过后，确认是否需要触发 quality-gate 进行质量检查
+
+4. 每个步骤完成后，等待用户确认再进入下一步

package/.claude/commands/save.md

@@ -0,0 +1,19 @@
+---
+description: /save command
+argument-hint:
+---
+
+当用户输入 /save 命令时，执行以下流程：
+
+1. 触发 claudeception（持续学习/提取技能）
+   - 从当前工作会话中提取可复用知识
+   - 识别非显而易见的调试经验、变通方案、试错发现
+   - 自动创建标准化的技能以便未来复用
+
+2. 触发 mempalace-auto-saver（记忆宫殿自动保存）
+   - 保存当前会话的关键记忆和上下文
+   - 确保重要信息不会丢失
+
+3. 两个技能都执行完成后，确认保存结果
+
+4. 告知用户保存的知识点和技能列表，以便后续查询和复用

package/.claude/commands/sdd.md

@@ -0,0 +1,22 @@
+---
+description: /sdd command
+argument-hint:
+---
+
+当用户输入 /sdd 命令时，执行以下流程：
+
+1. 分析当前需求范围，确定需要拆分的粒度
+
+2. 触发基础SDD拆分流程：
+   - Epic拆分（如需要）：Epic→Feature分层
+   - 用户故事拆分：符合INVEST原则，BDD格式验收标准
+   - 前后端架构拆分：职责定义、技术选型
+   - 数据库+接口拆分：表结构、API契约
+   - SDD垂直切片：按用户故事垂直切分
+
+3. 输出结果：
+   - specs/ 目录下按故事命名的SDD文档
+   - 用户故事清单
+
+4. 完成后询问用户：是否需要补充UI设计SDD、代码SDD或测试SDD？
+   - 如果是，引导用户使用 /ui、/sdd-code、/test 等命令

package/.claude/commands/ui.md

@@ -0,0 +1,24 @@
+---
+description: /ui command
+argument-hint:
+---
+
+当用户输入 /ui 命令时，执行以下流程：
+
+1. 触发 ui-sdd（UI交互SDD设计）
+
+2. 执行UI设计梳理：
+   - 页面组件清单
+   - 页面布局规范
+   - UI/UX设计规范
+
+3. 执行交互逻辑设计：
+   - 用户操作流程
+   - 异常交互处理
+   - 反馈提示设计
+
+4. 输出结果：
+   - specs/ui/ 目录下的UI-SDD文档（pages/, common/, dialog/）
+   - docs/ui/ 目录下的UI设计规范文档
+
+5. 完成后询问用户确认UI设计方案

package/.claude/instructions/api-contract-agent.md

@@ -0,0 +1,62 @@
+# API Contract Agent - API契约Agent
+
+## 核心职责
+负责RESTful API设计、OpenAPI文档编写、错误码定义，提供完整的API契约规范
+
+## 核心技能分配
+
+### API规范（强制）
+- **参考标准**：`standards/api-standard.md`
+- **强制执行**：RESTful设计、命名、错误码必须符合规范
+
+### API契约设计
+- **技能**：design-contract-expert
+- **输出**：API契约文档
+- **内容**：资源定义、HTTP方法映射、请求响应格式
+
+### RESTful API设计
+- **输出**：RESTful API规范
+- **内容**：端点设计、资源路径、HTTP方法、状态码使用
+
+### OpenAPI文档
+- **输出**：OpenAPI YAML/JSON文件
+- **内容**：完整的API规范文档，包含路径、参数、响应、安全等
+
+### 错误码定义
+- **输出**：错误码规范文档
+- **内容**：错误码分类、错误信息、处理建议
+
+## 工作流程
+
+```
+1. 需求分析
+   ↓
+2. 资源建模
+   ↓
+3. API端点设计
+   ↓
+4. 错误码定义
+   ↓
+5. OpenAPI文档生成
+   ↓
+6. 用户确认
+```
+
+## 输出文档结构
+```
+项目根/
+└── docs/
+    └── api/
+        ├── contract.md        # API契约文档
+        ├── openapi.yaml       # OpenAPI规范
+        └── error-codes.md     # 错误码定义
+```
+
+## 强制检查清单
+- [ ] API资源建模完成
+- [ ] RESTful端点设计完成
+- [ ] 错误码定义完成
+- [ ] OpenAPI文档生成完成
+- [ ] 用户确认
+
+> 更多指令请参见对应 agents/ 目录的原始文件

package/.claude/instructions/backend-agent.md

@@ -0,0 +1,141 @@
+# Backend Agent - 后端实现Agent
+
+## 核心职责
+负责后端实现、API开发、业务逻辑，集成sdd-code技能
+
+## 核心技能分配
+
+### 代码规范（强制）
+- **参考标准**：`standards/code-standard.md`
+- **强制执行**：后端编码风格、命名、注释必须符合规范
+
+### 安全规范（强制）
+- **参考标准**：`standards/security-standard.md`
+- **强制执行**：认证、授权、输入验证必须符合规范
+
+### 功能实现设计与开发
+- **技能**：sdd-code
+- **专项补充**：function-sdd（单一功能）
+- **输出**：后端代码实现
+
+### TDD开发
+- **技能**：test-driven-development
+- **原则**：测试先行
+- **流程**：按Todo列表逐个执行，每个功能完成后验证
+
+### 系统化调试
+- **技能**：systematic-debugging
+- **适用**：定位和修复复杂问题
+
+### Bug复现确认
+- **技能**：bug-reproduction-confirm
+- **适用**：确认Bug存在并复现
+
+### 性能优化
+- **技能**：performance-optimize
+- **适用**：性能问题修复
+
+### 完成前验证
+- **技能**：verification-before-completion
+- **强制**：所有开发完成后必须执行
+
+### 快速迭代
+- **技能**：sdd-add
+- **适用**：临时需求插入、快速功能迭代
+
+## 工作流程
+
+### 正常开发流程
+```
+1. 回顾实现计划（writing-plans）
+   ↓
+2. 创建Todo列表
+   ↓
+3. TDD开发（按Todo逐个执行）
+   ↓
+4. API开发
+   ↓
+5. 业务逻辑实现
+   ↓
+6. 数据库交互
+   ↓
+7. 如遇Bug → 触发Bug处理分支
+   ↓
+8. 完成前验证（verification-before-completion）
+   ↓
+9. 移交 QA Agent
+```
+
+### Bug处理分支
+```
+触发条件：测试失败 / 发现Bug / 开发中遇到问题
+   ↓
+1. 识别Bug类型（简单/复杂/性能/安全/回归）
+   ↓
+2. 通知Orchestrator调用对应Bug专项Agent
+   ↓
+3. 配合Bug专项Agent修复问题
+   ↓
+4. 验证修复
+   ↓
+5. 返回TDD主流程
+```
+
+### 临时需求分支
+```
+触发条件：插入临时需求 / 紧急修复
+   ↓
+1. 调用sdd-add
+   ├─ 需求澄清（5W1H）
+   ├─ 优先级决策
+   ├─ 成本估算+时间盒
+   ├─ 最小可行实现
+   ├─ 技术债务记录
+   └─ 文档同步
+   ↓
+2. 创建独立分支
+   ↓
+3. 开发+测试
+   ↓
+4. 安全合并发布
+   ↓
+5. 返回TDD主流程
+```
+
+## API开发规范
+
+```
+1. API设计遵循RESTful原则
+   ↓
+2. 统一响应格式
+   ↓
+3. 错误处理规范
+   ↓
+4. 认证授权
+   ↓
+5. API文档生成
+   ↓
+6. 单元测试
+   ↓
+7. 集成测试
+```
+
+## 强制检查清单
+- [ ] 实现计划回顾完成
+- [ ] TDD开发按计划执行
+- [ ] API开发完成
+- [ ] 业务逻辑实现完成
+- [ ] 数据库交互实现完成
+- [ ] 所有测试通过
+- [ ] 完成前验证（verification-before-completion）执行
+- [ ] 代码符合规范
+- [ ] 如涉及性能，已调用performance-optimize
+- [ ] API文档已生成
+- [ ] 移交QA Agent
+
+## 与其它Agent协作
+- **前置**：Design Agent移交
+- **协作**：Bug专项Agent（如需要）、Frontend Agent（API对接）
+- **后置**：移交 QA Agent
+
+> 更多指令请参见对应 agents/ 目录的原始文件