sdd-full 5.0.5 → 5.0.7

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
+  }
+}

package/.claude/skills/README.md

@@ -1,19 +1,18 @@
-【claude code调用标识：技能文档目录索引】【trae调用标识：技能文档目录索引+文档导航】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代、4.Bug处理、5.代码发布】
-
 # SDD Full 技能包
 
-**版本**: 5.1.0  
+**版本**: 5.2.0  
 **发布日期**: 2026-05-12  
-**更新时间**: 2026-05-12 10:35:00  
+**更新时间**: 2026-05-12 18:00:00  
 
 ---
 
 ## 技能包概览
 
-- **技能数量**: 46 个技能
-- **分层结构**: 7 个层级
+- **技能数量**: 46 个技能（33个核心 + 13个Flutter扩展）
+- **分层结构**: 9 个层级
 - **SDD 模板**: 21 种标准化/专项模板
-- **规则文件**: 2 个项目级规则（已移至 .claude/rules/）
+- **规则文件**: 3 个项目级规则（.claude/rules/）
+- **兼容平台**: Trae / Solo / Trae-cn / Claude Code
 
 ---
 
@@ -33,7 +32,7 @@ skills/
 ├── templates/              # SDD模板库（21个模板）
 ├── README.md               # 本文件（技能目录索引+版本信息）
 
-../agents/                 # 多Agent架构（19个）
+../agents/                 # 多Agent架构（19个，Trae专用）
 ../rules/                  # 规则文件（2个）
 ../standards/              # 规范文件（5个）
 ```
@@ -148,7 +147,7 @@ skills/
 ## 快速安装
 
 ```bash
-# 默认安装到 Trae / Solo
+# 默认安装到 Trae / Solo（完整技能集）
 npx sdd-full
 
 # 安装到 Claude Code
@@ -157,9 +156,18 @@ npx sdd-full cc
 # 仅安装到 Trae-cn
 npx sdd-full trae-cn
 
-# 安装到所有环境（Trae + Trae-cn + Claude Code）
+# 安装到所有环境
 npx sdd-full all
 
+# 仅安装核心技能集（33个，通用项目）
+npx sdd-full cc --core
+
+# 安装核心 + Flutter扩展（46个）
+npx sdd-full cc --flutter
+
+# 指定安装目录
+npx sdd-full cc --dir ./myproject
+
 # 查看帮助
 npx sdd-full --help
 ```
@@ -168,6 +176,17 @@ npx sdd-full --help
 
 ## 更新历史
 
+### v5.2.0 (2026-05-12)
+- 完成Claude Code全面适配
+- 清理71个SKILL.md文件中的Trae特定标签
+- 模板文件标记Trae-only章节
+- 新增 .claude/settings.json 配置文件
+- 新增 CLAUDE.local.md 用户配置文件
+- 拆分规则文件：project_rules.md + trae-rules.md
+- 新增分层安装选项：--core（33个核心技能）、--flutter（含Flutter扩展）
+- 更新bin.js支持按环境注入/过滤
+- 优化安装脚本，支持Claude Code完整部署
+
 ### v5.1.0 (2026-05-12)
 - 完成多Agent架构重构（19个Agent）
 - 补充8个Agent的Slots定义
@@ -177,6 +196,7 @@ npx sdd-full --help
 - 清理8个冗余技能目录
 - 修正README数据（技能数量46，模板21）
 - 完成sdd-common/SKILL.md索引更新
+- 移除Trae特定标签，支持Claude Code
 
 ### v5.0.1 (2026-05-09)
 - 默认安装新增 Trae-cn 支持，`npx sdd-full` 同时安装到 `.trae/` 和 `.trae-cn/`
@@ -199,4 +219,4 @@ npx sdd-full --help
 
 ## 项目链接
 
-- **npm**: https://www.npmjs.com/package/sdd-full
+- **npm**: https://www.npmjs.com/package/sdd-full

package/.claude/skills/ai-coding-rules/SKILL.md

@@ -1,3 +1,8 @@
+---
+name: ai-coding-rules
+description: Use when applying AI coding best practices and rules
+---
+
 name: Andrej Karpathy AI编码规则落地SDD
 description: 编码约束、开源/商用方案对比范式、禁止自由发挥落地细则
 author: 
@@ -11,7 +16,6 @@ tags:
   - AI编码
   - 开发规范
 
-【claude code调用标识：Andrej Karpathy AI编码规则落地SDD】【trae调用标识：Andrej Karpathy AI编码规则落地SDD+编码规范】【流程场景：1.完整3阶段SDD流程、3.小型功能迭代】
 
 ## 功能描述
 

package/.claude/skills/bdd-acceptance/SKILL.md

@@ -1,3 +1,8 @@
+---
+name: bdd-acceptance
+description: Use when defining BDD-style acceptance criteria
+---
+
 name: BDD风格验收标准SDD
 description: BDD验收句式、场景写法、准入/准出标准
 author: 
@@ -12,7 +17,6 @@ tags:
   - 验收标准
   - SDD模板
 
-【claude code调用标识：BDD风格验收标准SDD】【trae调用标识：BDD风格验收标准SDD+验收规范】【流程场景：1.完整3阶段SDD流程、3.小型功能迭代、4.Bug处理】
 
 ## 功能描述
 

package/.claude/skills/brainstorming/SKILL.md

@@ -1,4 +1,8 @@
-【claude code调用标识：brainstorming】【trae调用标识：brainstorming+头脑风暴】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代】
+---
+name: brainstorming
+description: Use when conducting brainstorming sessions for creative ideas and requirements
+---
+
 
 ---
 name: brainstorming

package/.claude/skills/bug-reproduction-confirm/SKILL.md

@@ -1,5 +1,9 @@
+---
+name: bug-reproduction-confirm
+description: Use when confirming bug reproduction steps
+---
+
 
-【claude code调用标识：bug-reproduction-confirm】【trae调用标识：bug-reproduction-confirm+Bug复现确认】【流程场景：4.Bug处理】
 
 ---
 name: bug-reproduction-confirm

package/.claude/skills/claudeception/SKILL.md

@@ -1,51 +1,11 @@
-【claude code调用标识：claudeception】【trae调用标识：claudeception+持续学习】【流程场景：1.完整3阶段SDD流程、3.小型功能迭代、4.Bug处理】
-
 ---
 name: claudeception
-description: "Use when encountering non-obvious debugging solutions, workarounds, trial-and-error discoveries, or needing to extract reusable knowledge from work sessions. Trigger keywords: /claudeception, save this as a skill, extract a skill, what did we learn"
-tags:
-  - 学习
-  - 技能提取
-  - 自动化
-  - 调试
-  - 工作流
-version: 3.0.0
-author: Trae Code
-enabled: true
-run_on:
-  - manual
-  - after_task
-when:
-  any:
-    - command: /claudeception
-    - user_contains:
-        - save this as a skill
-        - extract a skill from this
-        - what did we learn
-        - 把这个保存为技能
-        - 提取技能
-        - 我们学到了什么
-    - task_has:
-        - debugging
-        - workaround
-        - trial_and_error
-        - non_obvious_solution
-tool_allowlist:
-  - read
-  - write
-  - edit
-  - grep
-  - glob
-  - web_search
-  - web_fetch
-  - skill
-  - ask_user
-  - todo
+description: Use when encountering non-obvious debugging solutions, workarounds, trial-and-error discoveries, or needing to extract reusable knowledge from work sessions
 ---
 
-# Claudeception（Trae 版）
+# Claudeception
 
-持续学习系统，从工作会话中提取可复用知识，并将其编码为标准化的 Trae 技能，实现自主改进。
+持续学习系统，从工作会话中提取可复用知识，并将其编码为标准化的技能，实现自主改进。
 
 ## 何时提取技能
 
@@ -67,16 +27,9 @@ tool_allowlist:
 
 ### 1. 检查现有技能
 搜索现有技能以避免重复：
-```sh
-# 项目级
-.trae-cn/skills/**/*.md
-
-# 用户级
-~/.trae-cn/skills/**/*.md
-```
 
 ---
 
 ## 安装说明
 
-此技能已包含在 `sdd-full` npm 包中，通过 `npx sdd-full install` 自动安装！
+此技能已包含在 `sdd-full` npm 包中，通过 `npx sdd-full install` 自动安装！

package/.claude/skills/competitive-brief/SKILL.md

@@ -1,4 +1,8 @@
-【claude code调用标识：competitive-brief】【trae调用标识：competitive-brief+竞品简报】【流程场景：2.从零开始新项目】
+---
+name: competitive-brief
+description: Use when conducting competitive analysis and competitor comparisons
+---
+
 
 ---
 name: competitive-brief

package/.claude/skills/design-to-code/SKILL.md

@@ -1,3 +1,8 @@
+---
+name: design-to-code
+description: Use when converting high-fidelity designs to code
+---
+
 name: 高保真设计转代码SDD
 description: Rive动画、Figma设计稿转Flutter 1:1还原交付规范
 author: 
@@ -12,7 +17,6 @@ tags:
   - Figma
   - Flutter
 
-【claude code调用标识：高保真设计转代码SDD】【trae调用标识：高保真设计转代码SDD+设计转代码】【流程场景：1.完整3阶段SDD流程、3.小型功能迭代】
 
 ## 功能描述
 

package/.claude/skills/env-check/SKILL.md

@@ -1,3 +1,8 @@
+---
+name: env-check
+description: Use when checking development environment prerequisites
+---
+
 name: 环境预检标准化SDD
 description: 本机配置、依赖版本、网络连接预检固定话术与流程规范
 author: 
@@ -11,7 +16,6 @@ tags:
   - 预检流程
   - 开发环境
 
-【claude code调用标识：环境预检标准化SDD】【trae调用标识：环境预检标准化SDD+环境检查】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代、4.Bug处理、5.代码发布】
 
 ## 功能描述
 

package/.claude/skills/finishing-a-development-branch/SKILL.md

@@ -1,4 +1,8 @@
-【claude code调用标识：finishing-a-development-branch】【trae调用标识：finishing-a-development-branch+完成开发分支】【流程场景：5.代码发布】
+---
+name: finishing-a-development-branch
+description: Use when completing and merging development branches
+---
+
 
 ---
 name: finishing-a-development-branch

package/.claude/skills/flutter-add-integration-test/SKILL.md

@@ -1,4 +1,8 @@
-【claude code调用标识：flutter-add-integration-test】【trae调用标识：flutter-add-integration-test+Flutter开发】【流程场景：1.完整3阶段SDD流程、3.小型功能迭代】
+---
+name: flutter-add-integration-test
+description: Use when adding integration tests to Flutter projects
+---
+
 
 ---
 name: flutter-add-integration-test

package/.claude/skills/flutter-add-widget-preview/SKILL.md

@@ -1,4 +1,8 @@
-【claude code调用标识：flutter-add-widget-preview】【trae调用标识：flutter-add-widget-preview+Flutter开发】【流程场景：1.完整3阶段SDD流程、3.小型功能迭代】
+---
+name: flutter-add-widget-preview
+description: Use when adding widget previews in Flutter
+---
+
 
 ---
 name: flutter-add-widget-preview

package/.claude/skills/flutter-add-widget-test/SKILL.md

@@ -1,4 +1,8 @@
-【claude code调用标识：flutter-add-widget-test】【trae调用标识：flutter-add-widget-test+Flutter开发】【流程场景：1.完整3阶段SDD流程、3.小型功能迭代、4.Bug处理】
+---
+name: flutter-add-widget-test
+description: Use when adding widget tests to Flutter projects
+---
+
 
 ---
 name: flutter-add-widget-test

package/.claude/skills/flutter-apply-architecture-best-practices/SKILL.md

@@ -1,4 +1,8 @@
-【claude code调用标识：flutter-apply-architecture-best-practices】【trae调用标识：flutter-apply-architecture-best-practices+Flutter开发】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目】
+---
+name: flutter-apply-architecture-best-practices
+description: Use when applying architecture best practices in Flutter
+---
+
 
 ---
 name: flutter-apply-architecture-best-practices

package/.claude/skills/flutter-build-responsive-layout/SKILL.md

@@ -1,4 +1,8 @@
-【claude code调用标识：flutter-build-responsive-layout】【trae调用标识：flutter-build-responsive-layout+Flutter开发】【流程场景：1.完整3阶段SDD流程、3.小型功能迭代】
+---
+name: flutter-build-responsive-layout
+description: Use when building responsive layouts in Flutter
+---
+
 
 ---
 name: flutter-build-responsive-layout

package/.claude/skills/flutter-errors/SKILL.md

@@ -1,3 +1,8 @@
+---
+name: flutter-errors
+description: Use when debugging Flutter-specific errors
+---
+
 name: Flutter常见异常专项SDD
 description: SocketException、Framebuffer渲染异常排查与修复标准化流程
 author: 
@@ -13,7 +18,6 @@ tags:
   - Bug修复
   - 调试
 
-【claude code调用标识：Flutter常见异常专项SDD】【trae调用标识：Flutter常见异常专项SDD+异常处理】【流程场景：4.Bug处理】
 
 ## 功能描述
 

package/.claude/skills/flutter-fix-layout-issues/SKILL.md

@@ -1,4 +1,8 @@
-【claude code调用标识：flutter-fix-layout-issues】【trae调用标识：flutter-fix-layout-issues+Flutter开发】【流程场景：4.Bug处理】
+---
+name: flutter-fix-layout-issues
+description: Use when fixing layout issues in Flutter
+---
+
 
 ---
 name: flutter-fix-layout-issues

package/.claude/skills/flutter-implement-json-serialization/SKILL.md

@@ -1,4 +1,8 @@
-【claude code调用标识：flutter-implement-json-serialization】【trae调用标识：flutter-implement-json-serialization+Flutter开发】【流程场景：1.完整3阶段SDD流程、3.小型功能迭代】
+---
+name: flutter-implement-json-serialization
+description: Use when implementing JSON serialization in Flutter
+---
+
 
 ---
 name: flutter-implement-json-serialization

package/.claude/skills/flutter-setup-declarative-routing/SKILL.md

@@ -1,4 +1,8 @@
-【claude code调用标识：flutter-setup-declarative-routing】【trae调用标识：flutter-setup-declarative-routing+Flutter开发】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目】
+---
+name: flutter-setup-declarative-routing
+description: Use when setting up declarative routing in Flutter
+---
+
 
 ---
 name: flutter-setup-declarative-routing

package/.claude/skills/flutter-setup-localization/SKILL.md

@@ -1,4 +1,8 @@
-【claude code调用标识：flutter-setup-localization】【trae调用标识：flutter-setup-localization+Flutter开发】【流程场景：1.完整3阶段SDD流程、3.小型功能迭代】
+---
+name: flutter-setup-localization
+description: Use when setting up localization in Flutter
+---
+
 
 ---
 name: flutter-setup-localization

package/.claude/skills/flutter-test/SKILL.md

@@ -1,3 +1,8 @@
+---
+name: flutter-test
+description: Use when implementing Flutter testing strategies
+---
+
 name: Flutter全类型测试策略SDD
 description: Golden截图测试、E2E端到端、TDD单元、冒烟测试边界/优缺点/自动化实现规范
 author: 
@@ -14,7 +19,6 @@ tags:
   - E2E
   - TDD
 
-【claude code调用标识：Flutter全类型测试策略SDD】【trae调用标识：Flutter全类型测试策略SDD+测试方案】【流程场景：1.完整3阶段SDD流程、3.小型功能迭代、4.Bug处理】
 
 ## 功能描述
 

package/.claude/skills/flutter-use-http-package/SKILL.md

@@ -1,4 +1,8 @@
-【claude code调用标识：flutter-use-http-package】【trae调用标识：flutter-use-http-package+Flutter开发】【流程场景：1.完整3阶段SDD流程、3.小型功能迭代】
+---
+name: flutter-use-http-package
+description: Use when implementing HTTP requests in Flutter
+---
+
 
 ---
 name: flutter-use-http-package

package/.claude/skills/ios-full-auto-debug/SKILL.md

@@ -1,3 +1,8 @@
+---
+name: ios-full-auto-debug
+description: Use when debugging iOS-specific issues in Flutter
+---
+
 name: iOS真机全自动化调试
 description: Flutter iOS真机全自动化AI闭环调试，自动环境检测、缓存清理、错误修复、崩溃日志抓取
 author: 
@@ -13,7 +18,6 @@ tags:
   - 真机调试
   - 自动化
 
-【claude code调用标识：iOS真机全自动化调试】【trae调用标识：iOS真机全自动化调试+iOS调试】【流程场景：1.Flutter开发调试、2.iOS真机测试、3.Bug修复、4.自动化构建】
 
 ## 功能描述
 

package/.claude/skills/market-research/SKILL.md

@@ -1,4 +1,8 @@
-【claude code调用标识：market-research】【trae调用标识：market-research+市场调研】【流程场景：2.从零开始新项目】
+---
+name: market-research
+description: Use when performing market research and target user analysis
+---
+
 
 ---
 name: market-research