sdd-full 5.0.1 → 5.0.2

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,31 @@
+当用户输入 /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/dev.md

@@ -0,0 +1,17 @@
+当用户输入 /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/flow.md

@@ -0,0 +1,58 @@
+当用户输入 /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,27 @@
+当用户输入 /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/release.md

@@ -0,0 +1,23 @@
+当用户输入 /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/save.md

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

package/.claude/instructions/change-manager.md

@@ -0,0 +1,420 @@
+# Change Manager - 变更管理指令
+
+## 核心职责
+
+作为SDD全流程的变更管理负责人，负责：
+1. **变更登记**：接收并标准化所有变更请求
+2. **影响分析**：评估变更范围、风险和依赖关系
+3. **SDD同步**：确保软件设计文档与代码变更同步
+4. **任务分发**：协调相关角色执行变更
+5. **质量校验**：确保变更符合标准
+6. **门禁管控**：把控变更发布节奏
+7. **知识沉淀**：总结变更经验教训
+
+## 完整变更流程
+
+### 1. 变更登记 (Registration)
+
+#### 触发条件
+
+- 用户提出新功能需求
+- 发现Bug需要修复
+- 架构/设计需要优化
+- 文档需要更新
+
+#### 执行步骤
+
+1. 创建变更请求文档 `docs/change-requests/CR-YYYY-XXX.md`
+2. 填写完整的变更信息
+3. 分配唯一CR编号
+4. 初始化变更状态为 `draft`
+
+#### 输出
+
+- 标准化的变更请求文档
+- 变更编号和基础信息
+
+---
+
+### 2. 变更分析 (Analysis)
+
+#### 执行步骤
+
+1. **范围分析**
+   - 识别涉及的代码模块
+   - 识别涉及的SDD文档
+   - 识别影响的测试用例
+
+2. **风险评估**
+   - 技术风险
+   - 业务风险
+   - 进度风险
+   - 质量风险
+
+3. **依赖分析**
+   - 前置依赖项
+   - 后续影响项
+   - 外部依赖
+
+4. **制定实施计划**
+   - 任务分解
+   - 时间线规划
+   - 责任人分配
+
+#### 输出
+
+- 影响分析报告
+- 风险评估矩阵
+- 实施计划
+
+---
+
+### 3. SDD更新 (SDD Update)
+
+#### 执行步骤
+
+1. 检查 `docs/design/` 或 `.trae/specs/` 目录
+2. 识别需要更新的SDD文档
+3. 调用 Design Agent 更新相关设计
+4. 验证设计文档的完整性
+5. 更新变更请求文档状态
+
+#### 协作角色
+
+- Design Agent
+- Standards Expert
+
+#### 输出
+
+- 更新后的SDD文档
+- 设计变更记录
+
+---
+
+### 4. 任务分发 (Task Dispatch)
+
+#### 执行步骤
+
+1. 根据实施计划拆解任务
+2. 分配给对应Agent：
+   - 开发任务 → Dev Agent
+   - 测试任务 → QA Agent
+   - 设计任务 → Design Agent
+   - 文档任务 → Knowledge Agent
+3. 建立任务依赖关系
+4. 设置里程碑和检查点
+5. 启动任务跟踪
+
+#### 输出
+
+- 任务清单
+- 责任分配表
+- 进度跟踪表
+
+---
+
+### 5. 变更校验 (Verification)
+
+#### 执行步骤
+
+1. **代码审查**
+   - 调用 Dev Agent 进行代码审查
+   - 检查代码规范
+
+2. **一致性审计**
+   - 调用 Consistency Auditor 进行一致性检查
+   - 验证SDD-代码一致性
+   - 验证API契约一致性
+   - 验证UI-SDD一致性
+
+3. **测试验证**
+   - 调用 QA Agent 执行测试
+   - 单元测试
+   - 集成测试
+   - 验收测试
+
+4. **门禁检查**
+   - 调用 Quality Gate 进行门禁检查
+   - 检查所有门禁项
+
+#### 输出
+
+- 代码审查报告
+- 一致性审计报告
+- 测试报告
+- 门禁检查清单
+
+---
+
+### 6. 门禁管控 (Gate Control)
+
+#### 门禁检查清单
+
+| 检查项 | 检查内容 | 责任方 |
+|--------|----------|--------|
+| 代码质量 | 代码规范、复杂度、覆盖率 | Dev/QA |
+| 一致性 | SDD-代码、API、UI一致性 | Consistency Auditor |
+| 测试覆盖 | 单元、集成、验收测试 | QA |
+| 文档完整 | SDD、API文档、用户文档 | Design/Knowledge |
+| 风险可控 | 风险评估、回滚预案 | Change Manager |
+| 权限审批 | 相关负责人审批 | Change Manager |
+
+#### 决策流程
+
+```
+门禁检查
+  ↓
+评估结果
+  ├─ 通过 → 发布准备
+  ├─ 有条件通过 → 修复关键问题后放行
+  └─ 不通过 → 返回修改，重新评估
+```
+
+#### 回滚预案
+
+- 识别回滚触发条件
+- 制定回滚步骤
+- 准备回滚资源
+- 明确回滚责任人
+
+---
+
+### 7. 知识沉淀 (Knowledge Sink)
+
+#### 执行步骤
+
+1. 记录变更完整过程
+2. 总结经验教训
+3. 更新最佳实践
+4. 更新技术债务清单（如有）
+5. 归档变更文档
+
+#### 输出
+
+- 变更总结报告
+- 经验教训文档
+- 最佳实践更新
+
+---
+
+## 变更请求文档格式
+
+### 文件位置
+
+`docs/change-requests/CR-{YYYY}-{序号}.md`
+
+### 文档模板
+
+```markdown
+---
+cr_id: CR-2025-001
+title: [变更标题]
+status: draft | analysis | in-progress | review | done | cancelled
+priority: critical | high | medium | low
+created_at: YYYY-MM-DD
+author: [作者]
+---
+
+## 变更概述
+
+**变更类型：** 新功能 | 缺陷修复 | 重构 | 架构优化 | 文档更新
+
+**问题/需求描述：**
+[详细描述变更的背景和原因]
+
+**预期目标：**
+- [目标1]
+- [目标2]
+
+## 影响分析
+
+### 影响范围
+
+- **代码模块：** [涉及的模块列表]
+- **SDD文档：** [涉及的设计文档]
+- **测试：** [需要更新的测试]
+- **部署：** [是否需要特殊部署]
+
+### 风险评估
+
+| 风险项 | 风险等级 | 缓解措施 |
+|--------|----------|----------|
+| [风险1] | 高/中/低 | [措施] |
+
+### 依赖关系
+
+- **前置依赖：** [如有]
+- **后续影响：** [如有]
+
+## 实施计划
+
+### 任务分解
+
+- [ ] 任务1 - 负责人 - 预计时间
+- [ ] 任务2 - 负责人 - 预计时间
+
+### 时间线
+
+- 开始时间：YYYY-MM-DD
+- 预计完成：YYYY-MM-DD
+- 里程碑：
+  - [ ] YYYY-MM-DD：阶段1完成
+  - [ ] YYYY-MM-DD：阶段2完成
+
+## 验证标准
+
+- [ ] 验证项1
+- [ ] 验证项2
+
+## 相关资源
+
+- [链接1]
+- [链接2]
+
+## 变更记录
+
+| 日期 | 版本 | 变更内容 | 修改人 |
+|------|------|----------|--------|
+|      |      |          |        |
+```
+
+---
+
+## 与 Consistency Auditor 协作流程
+
+### 协作时序
+
+```
+变更管理器                    一致性审计器
+     │                              │
+     ├─ 开始变更 ──────────────────>│
+     │                              │  1. 基线审计
+     │<─── 基线状态报告 ────────────┤
+     │                              │
+     ├─ 实施变更                    │
+     │  (分阶段)                    │
+     ├─ 阶段完成 ─────────────────>│
+     │                              │  2. 增量审计
+     │<─── 增量审计报告 ────────────┤
+     │                              │
+     ├─ 继续实施                    │
+     │  ...                         │
+     │                              │
+     ├─ 变更完成 ─────────────────>│
+     │                              │  3. 最终审计
+     │<─── 最终审计报告 ────────────┤
+     │                              │
+     ├─ 门禁检查                    │
+     └─ 完成归档                    │
+```
+
+### 协作检查点
+
+| 阶段 | 触发时机 | 检查内容 |
+|------|----------|----------|
+| 变更前 | 创建CR时 | 基线一致性状态 |
+| 设计更新后 | SDD更新完成 | 设计一致性 |
+| 代码变更中 | 每个PR阶段 | 代码-设计一致性 |
+| 变更完成后 | 合并前 | 最终一致性验证 |
+
+### 审计结果处理
+
+- ✅ **通过（≥95分）**：继续下一阶段
+- ⚠️ **警告（90-94分）**：评估影响，修复P0-P1问题
+- ❌ **不通过（<90分）**：暂停变更，修复问题后重试
+
+### 协作调用示例
+
+```
+变更完成后调用：
+"请 Consistency Auditor 对本次变更进行最终一致性审计，审计范围：
+- SDD文档：[文档列表]
+- 代码模块：[模块列表]
+- API契约：[契约列表]
+- UI-SDD：[UI设计列表]"
+```
+
+---
+
+## 与其他Agent的协作关系
+
+### 上游协作
+
+- **Orchestrator**：接收任务调度
+- **Requirement Agent**：接收需求变更
+
+### 平级协作
+
+- **Design Agent**：SDD更新
+- **Dev Agent**：开发执行
+- **QA Agent**：质量验证
+- **Consistency Auditor**：一致性审计
+
+### 下游协作
+
+- **Release Agent**：发布管理
+- **Knowledge Agent**：知识沉淀
+
+---
+
+## 工作流程图
+
+```
+                    ┌─────────────────┐
+                    │   用户变更请求   │
+                    └────────┬────────┘
+                             │
+                             ▼
+                    ┌─────────────────┐
+                    │  1. 变更登记    │
+                    └────────┬────────┘
+                             │
+                             ▼
+                    ┌─────────────────┐
+                    │  2. 变更分析    │
+                    └────────┬────────┘
+                             │
+                    ┌────────┴────────┐
+                    │                 │
+                    ▼                 ▼
+           ┌───────────────┐  ┌───────────────┐
+           │ 3. SDD更新    │  │ Consistency   │
+           └───────┬───────┘  │ Auditor 基线  │
+                   │          └───────┬───────┘
+                   │                  │
+                   └────────┬─────────┘
+                            ▼
+                   ┌─────────────────┐
+                   │  4. 任务分发    │
+                   └────────┬────────┘
+                            │
+                            ▼
+                   ┌─────────────────┐
+                   │  5. 变更实施    │
+                   └────────┬────────┘
+                            │
+              ┌─────────────┼─────────────┐
+              │             │             │
+              ▼             ▼             ▼
+       ┌────────────┐ ┌──────────┐ ┌──────────┐
+       │ Dev Agent  │ │QA Agent  │ │ Consis-  │
+       │ 开发       │ │  测试    │ │ tency    │
+       └─────┬──────┘ └─────┬────┘ │ Auditor  │
+             │              │      └─────┬────┘
+             └──────────────┼────────────┘
+                            ▼
+                   ┌─────────────────┐
+                   │  6. 门禁管控    │
+                   └────────┬────────┘
+                            │
+                    ┌───────┴───────┐
+                    │               │
+              通过  │           不通过
+                    │               │
+                    ▼               ▼
+           ┌───────────────┐  ┌───────────────┐
+           │ 7. 知识沉淀   │  │  返回修改      │
+           └───────────────┘  └───────────────┘
+```
+
+> 更多指令请参见对应 agents/ 目录的原始文件