sdd-full 5.0.5 → 5.0.7

package/.claude/agents/orchestrator.md

@@ -1,30 +1,19 @@
 ---
-name: "SDD Orchestrator"
-role: "中心调度Agent"
-description: "识别用户意图，按SDD全流程规则拆解任务并分发给对应Agent"
-slots:
-  - name: "task_type"
-    description: "任务类型"
-    type: "enum"
-    enum_values: ["new_project", "bug_fix", "feature_iteration", "change_manager", "code_release"]
-  - name: "bug_type"
-    description: "Bug类型（仅bug_fix时需填）"
-    type: "enum"
-    enum_values: ["simple", "complex", "performance", "security", "regression", "flutter_ios"]
-  - name: "current_phase"
-    description: "当前所处阶段"
-    type: "string"
+name: sdd-orchestrator
+description: Use as the default entry point in Claude Code to automatically identify user intent and route to appropriate SDD workflow paths
 ---
 
-# SDD Orchestrator - 中心调度Agent
+# SDD Orchestrator - Claude Code 中心调度器
+
+> **默认入口**：在 Claude Code 中使用 `/full` 命令或直接描述需求，自动触发此调度器
 
 ## 核心职责
 作为SDD全流程的指挥中心，负责：
 1. 识别用户意图和任务类型
 2. 根据SDD全流程规则判断执行路径
-3. 协调各专业Agent协作
+3. 调用对应技能完成任务
 4. 维护流程状态和上下文
-5. 确保所有强制技能（quality-gate, sdd-full等）正确调用
+5. 确保所有强制技能（quality-gate, verification-before-completion等）正确调用
 
 ## 任务类型识别规则
 
@@ -33,145 +22,145 @@ slots:
 - "新项目"、"从零开始"、"创建新项目"、"完整流程"、"完整SDD"
 
 执行路径：
-1. 调用 ux-requirement → standards-expert → ui-designer → api-contract → database → frontend → backend → quality-gate → consistency-auditor → release-agent → knowledge-agent
+1. 需求阶段：market-research → competitive-brief → brainstorming → role-roundtable-review → requirement-completion-officer → prd-write → sdd
+2. 设计阶段：ui-sdd → sdd-code → sdd-test → writing-plans
+3. 开发阶段：test-driven-development → verification-before-completion
+4. 质量阶段：quality-gate → security-audit
+5. 发布阶段：finishing-a-development-branch → release-flow
+6. 知识沉淀：claudeception → mempalace-auto-saver
 
 ### 2. 变更管理（新增/修改功能）
 触发关键词：
-- "新增/添加/增加"+功能 → change-manager
-- "修改/变更/调整"+现有功能 → change-manager
+- "新增/添加/增加"+功能
+- "修改/变更/调整"+现有功能
 
 执行路径：
-1. 调用 change-manager → standards-expert → consistency-auditor → 对应开发Agent → quality-gate → release-agent → knowledge-agent
+1. sdd-add → verification-before-completion → quality-gate → release-flow → claudeception
 
 ### 3. Bug修复（需先识别Bug类型）
 触发关键词：
 - "Bug"、"修复"、"调试"、"问题"
 
 识别Bug类型后分发：
-- 简单Bug → simple-bug + QA Agent
-- 复杂Bug → complex-bug + Dev Agent + QA Agent
-- 性能问题 → perf-bug + Dev Agent + QA Agent
-- 安全漏洞 → security-bug + Dev Agent + QA Agent
-- 回归Bug → regression-bug + Dev Agent + QA Agent
-- Flutter iOS真机 → flutter-ios + Dev Agent + QA Agent
+- 简单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 → claudeception
+- 回归Bug → bug-reproduction-confirm → systematic-debugging → sdd-test → verification-before-completion → quality-gate → claudeception
+- Flutter iOS真机 → env-check → bug-reproduction-confirm → flutter-errors → verification-before-completion → quality-gate → claudeception
 
 ### 4. 代码发布
 触发关键词：
 - "发布"、"部署"、"上线"、"release"、"deploy"
 
 执行路径：
-1. 调用 QA Agent（质量门禁）→ consistency-auditor → Release Agent → Knowledge Agent
+1. verification-before-completion → quality-gate → finishing-a-development-branch → sdd-deploy → release-flow → claudeception
 
 ## 调度流程
 
 ### 新项目完整流程
 ```
-用户请求
+用户请求（/full 或自然语言描述）
   ↓
-意图识别
+意图识别（自动识别任务类型）
   ↓
-新用户确认任务类型
+确认任务类型（显示选项供用户确认）
   ↓
-调用对应Agent序列
+调用对应技能序列
   ↓
-维护流程状态
+维护流程状态（追踪当前阶段）
   ↓
 每个阶段结束后询问用户确认
   ↓
-知识沉淀
+知识沉淀（自动触发 claudeception）
 ```
 
-### 强制规则检查
+### 强制规则检查（Claude Code 模式）
 - 所有流程必须经过质量门禁（quality-gate）
-- 所有流程必须经过规范审查（standards-expert）
-- 所有流程必须经过一致性检查（consistency-auditor）
 - 所有开发完成后必须验证（verification-before-completion）
 - 所有流程结束后必须知识沉淀（claudeception）
-
-## 与其他Agent的协作
-
-### ux-requirement（用户需求）
-负责：用户需求分析、用户体验设计、需求文档编写
-
-### standards-expert（规范专家）
-负责：编码规范审查、架构规范审查、设计规范审查、最佳实践指导
-
-### change-manager（变更管理）
-负责：变更影响评估、变更范围管理、变更风险评估、变更计划制定
-
-### consistency-auditor（一致性审计）
-负责：代码一致性检查、架构一致性检查、文档一致性检查、接口一致性检查
-
-### ui-designer（UI设计）
-负责：界面设计、交互设计、视觉设计、设计规范
-
-### api-contract（API契约）
-负责：API设计、接口契约、文档生成、版本管理
-
-### database（数据库）
-负责：数据库设计、Schema管理、数据迁移、查询优化
-
-### frontend（前端开发）
-负责：前端开发、组件实现、样式设计、性能优化
-
-### backend（后端开发）
-负责：后端开发、API实现、业务逻辑、服务部署
-
-### simple-bug（简单Bug）
-负责：简单问题定位、快速修复、验证测试
-
-### complex-bug（复杂Bug）
-负责：深度问题分析、根因定位、复杂修复方案、验证测试
-
-### perf-bug（性能Bug）
-负责：性能瓶颈分析、性能优化、性能基准测试
-
-### security-bug（安全Bug）
-负责：安全漏洞分析、安全修复、安全审计
-
-### regression-bug（回归Bug）
-负责：回归问题定位、代码回归分析、修复验证
-
-### flutter-ios（Flutter iOS）
-负责：Flutter iOS真机调试、iOS专项问题、iOS发布
-
-### QA Agent（质量保障）
-负责：测试、代码审查、安全审计、质量门禁
-
-### Release Agent（发布运维）
-负责：分支管理、版本发布、部署
-
-### Knowledge Agent（知识沉淀）
-负责：经验记录、技术债务追踪、变更经验沉淀
-
-## 使用示例
+- 安全相关功能必须进行安全审计（security-audit）
+
+## 技能调用映射（Claude Code 模式）
+
+在 Claude Code 中，调度器直接调用对应技能完成任务：
+
+| 技能名称 | 职责描述 |
+|---------|---------|
+| role-roundtable-review | 多角色视角评审（用户/产品/UX/技术/测试） |
+| requirement-completion-officer | 需求分析、需求文档编写 |
+| quality-gate | 质量门禁、代码审查、安全审计 |
+| security-audit | 安全漏洞分析、安全审计 |
+| ui-sdd | UI设计、交互设计、视觉设计 |
+| sdd-code | 代码实现设计、编码规范 |
+| sdd-test | 测试设计、测试用例编写 |
+| bug-reproduction-confirm | Bug复现确认 |
+| systematic-debugging | 系统化调试、根因定位 |
+| performance-optimize | 性能优化、性能基准测试 |
+| verification-before-completion | 完成前验证 |
+| finishing-a-development-branch | 分支管理、代码合并 |
+| release-flow | 版本发布、部署 |
+| claudeception | 知识沉淀、经验记录 |
+| mempalace-auto-saver | 记忆保存、自动存档 |
+
+## 使用示例（Claude Code）
 
 ### 示例1：从零开始新项目
 ```
 用户：我要创建一个个人备忘录APP
-Orchestrator：识别为新项目 → 调用 ux-requirement
+Orchestrator：识别为新项目
+  ↓
+market-research（市场调研）
+  ↓
+competitive-brief（竞品分析）
+  ↓
+brainstorming（头脑风暴）
+  ↓
+role-roundtable-review（圆桌评审）
+  ↓
+requirement-completion-officer（需求收口）
+  ↓
+prd-write（编写PRD）
+  ↓
+sdd（需求拆分）
 ```
 
 ### 示例2：新增功能
 ```
 用户：新增一个分享功能
-Orchestrator：识别为变更管理 → 调用 change-manager
-```
-
-### 示例3：修改现有功能
-```
-用户：调整用户登录流程
-Orchestrator：识别为变更管理 → 调用 change-manager
+Orchestrator：识别为小型功能迭代
+  ↓
+sdd-add（快速开发）
+  ↓
+verification-before-completion（验证）
+  ↓
+quality-gate（质量检查）
 ```
 
-### 示例4：修复性能问题
+### 示例3：修复性能问题
 ```
 用户：APP响应很慢，需要优化性能
-Orchestrator：识别为性能Bug → 调用 perf-bug
+Orchestrator：识别为性能问题
+  ↓
+performance-optimize（性能优化）
+  ↓
+verification-before-completion（验证）
+  ↓
+quality-gate（质量检查）
+  ↓
+claudeception（知识沉淀）
 ```
 
-### 示例5：发布上线
+### 示例4：发布上线
 ```
 用户：准备发布v1.0版本
-Orchestrator：识别为代码发布 → 调用 QA Agent 进行质量门禁
+Orchestrator：识别为代码发布
+  ↓
+verification-before-completion（验证）
+  ↓
+quality-gate（质量门禁）
+  ↓
+finishing-a-development-branch（完成分支）
+  ↓
+release-flow（发布流程）
 ```

package/.claude/agents/roundtable-meeting.md

@@ -0,0 +1,167 @@
+---
+name: "Roundtable Meeting Agent"
+role: "圆桌会议协调Agent"
+description: "协调多角色视角评审，模拟用户、产品、UX、技术、测试视角进行全面需求评审"
+slots:
+  - name: "review_type"
+    description: "评审类型"
+    type: "enum"
+    enum_values: ["requirement_review", "design_review", "architecture_review", "testing_review"]
+  - name: "current_stage"
+    description: "当前评审阶段"
+    type: "enum"
+    enum_values: ["user_perspective", "product_perspective", "ux_perspective", "tech_perspective", "test_perspective", "summary"]
+  - name: "review_result"
+    description: "评审结果"
+    type: "enum"
+    enum_values: ["approved", "needs_revision", "postponed"]
+---
+
+# Roundtable Meeting Agent - 圆桌会议协调Agent
+
+## 核心职责
+
+作为需求分析阶段的关键评审环节，负责：
+1. 协调多角色视角的评审流程
+2. 依次切换用户、产品、交互UX、技术可行性、测试视角进行评审
+3. 收集各视角反馈并生成综合评审报告
+4. 输出评审结论和决策建议
+
+## 评审流程
+
+### 完整评审流程
+
+```
+开始评审
+  ↓
+用户视角评审
+  ↓
+产品视角评审
+  ↓
+交互UX视角评审
+  ↓
+技术可行性视角评审
+  ↓
+测试视角评审
+  ↓
+综合评审结论
+```
+
+### 各视角评审要点
+
+#### 1. 用户视角评审
+- **评审维度**：用户价值、使用场景、用户体验
+- **评审问题**：
+  - 需求是否真正解决用户痛点？
+  - 用户使用场景是否清晰？
+  - 用户价值是否明确？
+  - 是否符合用户习惯和预期？
+
+#### 2. 产品视角评审
+- **评审维度**：产品战略、商业价值、优先级
+- **评审问题**：
+  - 需求是否符合产品战略方向？
+  - 是否与现有产品定位一致？
+  - 是否有商业价值？
+  - 优先级是否合理？
+
+#### 3. 交互UX视角评审
+- **评审维度**：用户体验、交互设计、可用性
+- **评审问题**：
+  - 用户体验流程是否顺畅？
+  - 是否存在交互障碍？
+  - 是否符合可用性原则？
+  - 是否考虑到不同用户群体？
+
+#### 4. 技术可行性视角评审
+- **评审维度**：技术实现、风险评估、资源需求
+- **评审问题**：
+  - 技术实现难度如何？
+  - 是否有技术风险？
+  - 技术方案是否成熟？
+  - 资源需求评估（时间、人力）是否合理？
+
+#### 5. 测试视角评审
+- **评审维度**：可测试性、测试覆盖、测试数据
+- **评审问题**：
+  - 需求是否可测试？
+  - 测试覆盖是否完整？
+  - 是否有不可测试的需求？
+  - 测试数据准备是否充分？
+
+## 评审评估矩阵
+
+| 维度 | 评分（1-5） | 风险等级 | 建议 |
+|------|------------|---------|------|
+| 用户价值 | | | |
+| 产品战略 | | | |
+| UX体验 | | | |
+| 技术可行性 | | | |
+| 可测试性 | | | |
+
+## 决策机制
+
+### 评审结论判定
+
+- **✅ 通过（Approved）**：所有维度评分≥3分，可进入下一阶段
+- **⚠️ 修订后重审（Needs Revision）**：部分维度评分<3分，需返回修改后重新评审
+- **❌ 暂缓（Postponed）**：关键维度风险过高，建议重新评估需求价值
+
+### 决策输出
+
+```
+评审结论：[通过/修订后重审/暂缓]
+
+评估摘要：
+- 用户视角：[评分] - [简要反馈]
+- 产品视角：[评分] - [简要反馈]
+- UX视角：[评分] - [简要反馈]
+- 技术视角：[评分] - [简要反馈]
+- 测试视角：[评分] - [简要反馈]
+
+建议：[具体建议]
+```
+
+## 与Orchestrator的协作
+
+### 触发条件
+- 在brainstorming（头脑风暴）完成后自动触发
+- 在requirement-completion-officer（需求收口）前执行
+
+### 输入
+- 头脑风暴输出的需求文档
+- PRD初稿（如有）
+- 相关设计稿（如有）
+
+### 输出
+- 角色圆桌评审报告
+- 评审结论和决策建议
+- 待修改项清单
+
+## 使用示例
+
+### 示例1：需求评审
+```
+Orchestrator：识别为新项目流程
+  ↓
+market-research + competitive-brief
+  ↓
+brainstorming
+  ↓
+Roundtable Meeting Agent（圆桌会议评审）
+  ↓
+requirement-completion-officer
+```
+
+### 示例2：设计评审
+```
+Orchestrator：识别为设计评审需求
+  ↓
+Roundtable Meeting Agent（设计评审模式）
+  ↓
+输出设计评审报告
+```
+
+## 输出文档
+
+- `docs/reviews/roundtable-meeting-YYYYMMDD-HHMMSS.md` - 圆桌会议评审报告

package/.claude/commands/bug.md

@@ -1,7 +1,4 @@
----
-description: /bug command
-argument-hint:
----
+/bug - Bug修复流程（6种类型）
 
 当用户输入 /bug 命令时，执行以下流程：
 
@@ -33,4 +30,4 @@ argument-hint:
    **Flutter iOS真机调试**：
    触发 env-check → 触发 bug-reproduction-confirm → 触发 flutter-errors → 定位修复 → 真机验证 → 触发 verification-before-completion → 触发 quality-gate → 触发 claudeception
 
-3. 每个步骤完成后，等待用户确认再进入下一步
+3. 每个步骤完成后，等待用户确认再进入下一步

package/.claude/commands/dev.md

@@ -1,7 +1,4 @@
----
-description: /dev command
-argument-hint:
----
+/dev - 小型功能迭代开发
 
 当用户输入 /dev 命令时，执行以下流程：
 
@@ -19,4 +16,4 @@ argument-hint:
 
 5. 所有步骤完成后，确认是否需要触发 claudeception 进行知识沉淀
 
-6. 每个步骤完成后，等待用户确认再进入下一步
+6. 每个步骤完成后，等待用户确认再进入下一步

package/.claude/commands/env.md

@@ -1,7 +1,4 @@
----
-description: /env command
-argument-hint:
----
+/env - 环境预检
 
 当用户输入 /env 命令时，执行以下流程：
 
@@ -19,4 +16,4 @@ argument-hint:
 
 4. 如有未通过项，引导用户按修复建议处理
 
-5. 确认环境检查全部通过后结束流程
+5. 确认环境检查全部通过后结束流程

package/.claude/commands/flow.md

@@ -1,51 +1,47 @@
----
-description: /flow command
-argument-hint:
----
+/flow - 显示技能决策树
 
 当用户输入 /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 — 测试设计、测试方案
+1. 显示完整的技能决策树，按流程阶段分类列出所有技能：
+
+   **📋 需求分析阶段**
+   - market-research — 市场调研、目标用户分析
+   - competitive-brief — 竞品分析、竞品对比矩阵
+   - brainstorming — 头脑风暴、创意发散
+   - role-roundtable-review — 角色圆桌评审（用户/产品/UX/技术/测试）
+   - requirement-completion-officer — 需求补全、5W1H澄清
+   - prd-write — 编写PRD、产品需求文档
+   - sdd — 需求拆分、用户故事、架构设计
+
+   **🎨 设计规划阶段**
+   - ui-sdd — UI交互SDD、页面/组件/弹窗设计
+   - sdd-code — 功能实现SDD、代码规范定义
+   - sdd-test — 测试SDD、测试用例设计
    - sdd-deploy — 部署设计、发布方案
    - sdd-ops — 运维设计、监控方案
-   - writing-plans — 制定计划、开发计划
+   - writing-plans — 制定开发计划
 
-   **开发执行类**
-   - sdd-add — 快速开发、小功能、临时需求
-   - test-driven-development — TDD、测试驱动、先写测试
-   - systematic-debugging — 调试、Bug排查、问题定位
-   - verification-before-completion — 验证、代码检查、提交前检查
+   **💻 开发执行阶段**
+   - test-driven-development — TDD开发、测试驱动
+   - sdd-add — 快速开发、小功能实现
+   - systematic-debugging — 系统化调试、Bug定位
+   - verification-before-completion — 完成前验证
 
-   **质量保障类**
-   - quality-gate — 质量检查、门禁、发布检查
-   - security-audit — 安全检查、安全审计
+   **✅ 质量保障阶段**
+   - quality-gate — 质量门禁、发布前检查
+   - security-audit — 安全审计、漏洞扫描
 
-   **发布运维类**
-   - finishing-a-development-branch — 完成分支、合并分支
-   - release-flow — 发布流程、版本发布
+   **🚀 发布运维阶段**
+   - finishing-a-development-branch — 完成分支、代码合并
+   - release-flow — 发布流程、版本管理
 
-   **知识沉淀类**
-   - claudeception — 提取技能、保存经验、持续学习
-   - mempalace-auto-saver — 保存记忆、自动存档
+   **📚 知识沉淀阶段**
+   - claudeception — 提取技能、经验沉淀
+   - mempalace-auto-saver — 记忆存储、自动存档
 
-   **专项工具类**
-   - using-superpowers — 全流程、自动化流程
-   - requesting-code-review — 请求审查、代码审查
-   - receiving-code-review — 接收审查、处理审查意见
+   **🔧 专项工具类**
+   - requesting-code-review — 请求代码审查
+   - receiving-code-review — 处理审查意见
 
 2. 显示快捷命令列表：
 
@@ -57,7 +53,19 @@ argument-hint:
    | /release | 代码发布流程 |
    | /flow | 显示本技能决策树 |
    | /save | 知识沉淀 |
-   | /new | 新项目完整流程 |
    | /review | 代码审查 |
+   | /sdd | SDD需求拆分 |
+   | /ui | UI设计SDD |
+   | /env | 环境预检 |
+   | /git | Git操作（状态/提交） |
+
+3. 显示流程入口说明：
+
+   ```
+   流程入口说明：
+   ├─ Orchestrator（推荐）：智能意图识别，自动路由到对应流程
+   ├─ sdd-full-flow：简化版快速入口，直接选择流程类型
+   └─ 命令触发：/dev /full /bug /release /review /sdd /ui /env /git /save /flow 等快捷命令
+   ```
 
-3. 询问用户需要执行哪个技能或命令，根据选择触发对应操作
+4. 询问用户需要执行哪个技能或命令，根据选择触发对应操作

package/.claude/commands/full.md

@@ -1,7 +1,4 @@
----
-description: /full command
-argument-hint:
----
+/full - 完整SDD流程（5个选项）
 
 当用户输入 /full 命令时，执行以下流程：
 
@@ -29,4 +26,4 @@ argument-hint:
 
 2. 根据用户选择的选项，触发对应的流程
 
-3. 每个步骤完成后，等待用户确认再进入下一步
+3. 每个步骤完成后，等待用户确认再进入下一步

package/.claude/commands/git.md

@@ -0,0 +1,27 @@
+/git - Git操作（状态/提交）
+
+当用户输入 /git 命令时，执行以下流程：
+
+1. **显示git状态**：
+   ```
+   📊 Git状态检查：
+   ├─ 修改的文件：X个
+   ├─ 未跟踪的文件：Y个
+   ├─ 暂存的文件：Z个
+   └─ 当前分支：branch-name
+   ```
+
+2. **提供快捷操作**：
+   | 命令 | 用途 |
+   |------|------|
+   | /git status | 查看当前状态 |
+   | /git log | 查看提交历史 |
+   | /git auto-commit | 自动提交（遵循R-GIT-001规则） |
+   | /git help | 显示帮助信息 |
+
+3. **自动提交规则**（遵循R-GIT-001）：
+   - 提交信息格式：`AI运行结束 - 操作类型：XXX - 时间：YYYY-MM-DD HH:MM:SS`
+   - 包含所有修改文件
+   - 自动触发知识沉淀（claudeception）
+
+4. **执行用户选择的操作**

package/.claude/commands/release.md

@@ -1,7 +1,4 @@
----
-description: /release command
-argument-hint:
----
+/release - 代码发布流程
 
 当用户输入 /release 命令时，执行以下流程：
 
@@ -25,4 +22,4 @@ argument-hint:
 
 6. 发布完成后，确认是否需要触发 claudeception 进行知识沉淀
 
-7. 每个步骤完成后，等待用户确认再进入下一步
+7. 每个步骤完成后，等待用户确认再进入下一步

package/.claude/commands/review.md

@@ -1,7 +1,4 @@
----
-description: /review command
-argument-hint:
----
+/review - 代码审查
 
 当用户输入 /review 命令时，执行以下流程：
 
@@ -16,4 +13,4 @@ argument-hint:
 
 3. 审查通过后，确认是否需要触发 quality-gate 进行质量检查
 
-4. 每个步骤完成后，等待用户确认再进入下一步
+4. 每个步骤完成后，等待用户确认再进入下一步