sdd-full 5.0.6 → 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,7 +22,7 @@ slots:
 - "新项目"、"从零开始"、"创建新项目"、"完整流程"、"完整SDD"
 
 执行路径：
-1. 需求阶段：market-research + competitive-brief → brainstorming → roundtable-meeting → requirement-completion-officer → prd-write → sdd
+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
@@ -42,138 +31,92 @@ slots:
 
 ### 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的协作
-
-### roundtable-meeting（圆桌会议）
-负责：多角色视角评审、用户/产品/UX/技术/测试视角切换、评审报告生成、决策建议
-
-**协调流程**：
-1. 在brainstorming完成后自动触发
-2. 依次执行5个视角评审：用户→产品→UX→技术→测试
-3. 收集评审反馈并生成综合报告
-4. 根据评审结论决定是否进入下一阶段
-5. 通过→requirement-completion-officer；修订→返回修改；暂缓→重新评估
-
-**输入**：头脑风暴产出的需求文档、PRD初稿（如有）
-**输出**：评审报告、决策建议、待修改项清单
-
-### 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：识别为新项目
   ↓
-market-research + competitive-brief（市场调研+竞品分析）
+market-research（市场调研）
+  ↓
+competitive-brief（竞品分析）
   ↓
 brainstorming（头脑风暴）
   ↓
-roundtable-meeting（圆桌会议评审：用户→产品→UX→技术→测试）
+role-roundtable-review（圆桌评审）
   ↓
 requirement-completion-officer（需求收口）
   ↓
@@ -185,23 +128,39 @@ 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/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,7 +1,4 @@
----
-description: /flow command
-argument-hint:
----
+/flow - 显示技能决策树
 
 当用户输入 /flow 命令时，执行以下流程：
 
@@ -56,11 +53,10 @@ argument-hint:
    | /release | 代码发布流程 |
    | /flow | 显示本技能决策树 |
    | /save | 知识沉淀 |
-   | /new | 新项目完整流程 |
    | /review | 代码审查 |
    | /sdd | SDD需求拆分 |
    | /ui | UI设计SDD |
-   | /test | 测试SDD |
+   | /env | 环境预检 |
    | /git | Git操作（状态/提交） |
 
 3. 显示流程入口说明：
@@ -69,7 +65,7 @@ argument-hint:
    流程入口说明：
    ├─ Orchestrator（推荐）：智能意图识别，自动路由到对应流程
    ├─ sdd-full-flow：简化版快速入口，直接选择流程类型
-   └─ 命令触发：/new /full /dev /bug /release 等快捷命令
+   └─ 命令触发：/dev /full /bug /release /review /sdd /ui /env /git /save /flow 等快捷命令
    ```
 
-4. 询问用户需要执行哪个技能或命令，根据选择触发对应操作
+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

@@ -1,7 +1,4 @@
----
-description: /git command
-argument-hint: commit|status|log|auto-commit
----
+/git - Git操作（状态/提交）
 
 当用户输入 /git 命令时，执行以下流程：
 

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. 每个步骤完成后，等待用户确认再进入下一步

package/.claude/commands/save.md

@@ -1,7 +1,4 @@
----
-description: /save command
-argument-hint:
----
+/save - 知识沉淀
 
 当用户输入 /save 命令时，执行以下流程：
 
@@ -16,4 +13,4 @@ argument-hint:
 
 3. 两个技能都执行完成后，确认保存结果
 
-4. 告知用户保存的知识点和技能列表，以便后续查询和复用
+4. 告知用户保存的知识点和技能列表，以便后续查询和复用

package/.claude/commands/sdd.md

@@ -1,7 +1,4 @@
----
-description: /sdd command
-argument-hint:
----
+/sdd - SDD需求拆分
 
 当用户输入 /sdd 命令时，执行以下流程：
 
@@ -19,4 +16,4 @@ argument-hint:
    - 用户故事清单
 
 4. 完成后询问用户：是否需要补充UI设计SDD、代码SDD或测试SDD？
-   - 如果是，引导用户使用 /ui、/sdd-code、/test 等命令
+   - 如果是，引导用户使用 /ui、/sdd-code、/test 等命令

package/.claude/commands/ui.md

@@ -1,7 +1,4 @@
----
-description: /ui command
-argument-hint:
----
+/ui - UI设计SDD
 
 当用户输入 /ui 命令时，执行以下流程：
 
@@ -21,4 +18,4 @@ argument-hint:
    - specs/ui/ 目录下的UI-SDD文档（pages/, common/, dialog/）
    - docs/ui/ 目录下的UI设计规范文档
 
-5. 完成后询问用户确认UI设计方案
+5. 完成后询问用户确认UI设计方案

package/.claude/rules/project_rules.md

@@ -2,16 +2,19 @@
 
 ## 一、项目概述
 
-SDD全流程开发技能体系，覆盖从需求分析到发布运维的全流程技能，支持Trae调用机制。
+SDD全流程开发技能体系，覆盖从需求分析到发布运维的全流程技能，支持多平台调用机制（Trae、Claude Code）。
 
-## 七、调用机制规范
+## 二、调用机制规范
 
-### 7.1 Trae调用格式
-```
-trae调用 模板名称 项目名称=XXX 阶段=XXX 流程场景=XXX
-```
+### 2.1 通用调用格式
+
+根据使用的开发环境，调用格式有所不同：
+
+**Claude Code**: 使用快捷命令 `/full`、`/dev`、`/bug`、`/release`、`/flow` 等
+**Trae**: 使用 `trae调用` 命令（详见 `trae-rules.md`）
+
+### 2.2 流程场景参数
 
-### 7.3 流程场景参数
 | 参数值 | 说明 |
 |--------|------|
 | 完整3阶段SDD流程 | 大型项目完整流程 |
@@ -20,28 +23,28 @@ trae调用 模板名称 项目名称=XXX 阶段=XXX 流程场景=XXX
 | Bug处理 | Bug修复 |
 | 代码发布 | 版本发布 |
 
-## 八、工具与环境
+## 三、工具与环境
 
-### 8.1 推荐工具
+### 3.1 推荐工具
 - **Figma** - UI设计
 - **GitHub** - 代码托管
-- **Trae** - 技能调用
-- **Claude Code** - AI协作
+- **Trae** - 技能调用（可选）
+- **Claude Code** - AI协作（推荐）
 
-### 8.2 环境要求
+### 3.2 环境要求
 - Node.js ≥ 18.x
 - npm ≥ 9.x
 - sdd-full ≥ 2.2.0
 
-## 九、版本管理
+## 四、版本管理
 
-### 9.1 版本命名规范
+### 4.1 版本命名规范
 ```
 v{主版本}.{次版本}.{修订版本}
 示例：v2.2.0
 ```
 
-### 9.2 版本发布流程
+### 4.2 版本发布流程
 1. 完成功能开发与测试
 2. 更新版本号
 3. 通过 quality-gate
@@ -50,7 +53,8 @@ v{主版本}.{次版本}.{修订版本}
 
 ---
 
-**版本**: v1.0
-**更新时间**: 2026-05-06
+**版本**: v1.1
+**更新时间**: 2026-05-12
 **适用项目**: sdd-full-npm
 **团队**: SDD开发团队
+**兼容平台**: Trae、Claude Code

package/.claude/rules/trae-rules.md

@@ -0,0 +1,50 @@
+# Trae 专用规则
+
+> ⚠️ 此文件包含仅适用于 Trae 环境的规则
+> Claude Code 用户请参考 project_rules.md
+
+---
+
+## 一、Trae 调用格式
+
+```
+trae调用 模板名称 项目名称=XXX 阶段=XXX 流程场景=XXX
+```
+
+### 示例
+```
+trae调用 sdd-full 项目名称=个人备忘录APP 阶段=需求分析 流程场景=完整3阶段SDD流程
+```
+
+## 二、Trae 特定功能
+
+### 2.1 快捷命令
+- `trae快捷 sdd` - 快速启动 SDD 拆分
+- `trae快捷 dev` - 快速启动开发流程
+- `trae快捷 bug` - 快速启动 Bug 修复流程
+
+### 2.2 技能调用
+Trae 环境支持直接调用技能：
+```
+trae调用 brainstorming
+trae调用 prd-write
+trae调用 sdd-full
+```
+
+## 三、Trae 环境配置
+
+### 3.1 安装命令
+```bash
+npx sdd-full          # 默认安装到 Trae / Solo
+npx sdd-full trae-cn  # 仅安装到 Trae-cn
+```
+
+### 3.2 配置路径
+- 技能目录：`.trae/skills/` 或 `.trae-cn/skills/`
+- 规则目录：`.trae/rules/` 或 `.trae-cn/rules/`
+
+---
+
+**版本**: v1.0
+**更新时间**: 2026-05-12
+**适用环境**: Trae / Trae-cn

package/.claude/settings.json

@@ -0,0 +1,40 @@
+{
+  "permissions": {
+    "tools": {
+      "allowlist": [
+        "read",
+        "write",
+        "edit",
+        "delete",
+        "glob",
+        "grep",
+        "run_command",
+        "web_search",
+        "web_fetch"
+      ],
+      "denylist": []
+    }
+  },
+  "hooks": {
+    "after_task": [
+      {
+        "name": "claudeception",
+        "description": "自动触发知识沉淀，提取会话中的可复用知识"
+      }
+    ],
+    "before_task": [],
+    "on_error": []
+  },
+  "mcp_servers": [],
+  "preferences": {
+    "theme": "system",
+    "model": "claude-3-5-sonnet",
+    "auto_save": true,
+    "auto_commit": true
+  },
+  "workflow": {
+    "quality_gate_enabled": true,
+    "verification_enabled": true,
+    "consistency_check_enabled": true
+  }
+}