sdd-full 4.8.0 → 4.8.2

package/bin.js

@@ -6,7 +6,7 @@ const fs = require('fs');
 const path = require('path');
 
 const SDD = {
-  version: '4.8.0',
+  version: '4.8.2',
   name: 'sdd-full',
   description: '完整的软件设计开发技能包'
 };
@@ -221,7 +221,7 @@ function install(targetDir, environment) {
     console.log(`  - ${config.name}`);
     console.log(`    技能位置: ${config.skillsPath}`);
     console.log(`    规则位置: ${config.rulesPath}`);
-    console.log(`    版本信息: ${path.join(config.skillsPath, 'VERSION.md')}`);
+    console.log(`    版本信息: ${path.join(config.skillsPath, 'README.md')}`);
   });
   console.log('\n🎉 开始使用吧！\n');
 }

package/index.js

@@ -17,22 +17,28 @@ const SDD = {
     const skillsDir = path.join(__dirname, 'skills');
     const skills = [];
     
-    if (fs.existsSync(skillsDir)) {
-      const items = fs.readdirSync(skillsDir);
-      
-      items.forEach(item => {
-        const itemPath = path.join(skillsDir, item);
-        const stat = fs.statSync(itemPath);
+    function searchSkills(dir, parentPath = '') {
+      if (fs.existsSync(dir)) {
+        const items = fs.readdirSync(dir);
         
-        if (stat.isDirectory() && !item.endsWith('.md')) {
-          const skillPath = path.join(itemPath, 'SKILL.md');
-          if (fs.existsSync(skillPath)) {
-            skills.push(item);
+        items.forEach(item => {
+          const itemPath = path.join(dir, item);
+          const stat = fs.statSync(itemPath);
+          
+          if (stat.isDirectory() && !item.startsWith('.')) {
+            const skillPath = path.join(itemPath, 'SKILL.md');
+            const skillRelativePath = parentPath ? path.join(parentPath, item) : item;
+            if (fs.existsSync(skillPath)) {
+              skills.push(skillRelativePath);
+            }
+            // 继续递归搜索子目录
+            searchSkills(itemPath, skillRelativePath);
           }
-        }
-      });
+        });
+      }
     }
     
+    searchSkills(skillsDir);
     return skills;
   },
   

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sdd-full",
-  "version": "4.8.0",
+  "version": "4.8.2",
   "description": "SDD Full - 完整的软件设计开发技能包",
   "main": "index.js",
   "bin": "./bin.js",

package/skills/README.md

@@ -1,81 +1,159 @@
 【claude code调用标识：技能文档目录索引】【trae调用标识：技能文档目录索引+文档导航】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代、4.Bug处理、5.代码发布】
 
-# 技能文档目录索引
+# SDD Full 技能包
 
-## 概述
+**版本**: 4.8.2  
+**发布日期**: 2026-05-09  
+**更新时间**: 2026-05-09 09:52:00  
 
-本目录包含所有技能体系相关的文档，帮助你快速了解和使用整个技能体系。
+---
 
-## 文档列表
+## 技能包概览
 
-### 核心文档
+- **技能数量**: 55+ 个技能
+- **分层结构**: 10 个层级
+- **SDD 模板**: 25 种标准化/专项模板
+- **规则文件**: 2 个项目级规则
 
-| 文档名称 | 路径 | 说明 |
-|---------|------|------|
-| **技能使用指南.md** | `技能使用指南.md` | 所有技能的使用场景、功能特点、与其他技能的关系，快速选择和使用合适的技能 |
-| **完整开发流程手册.md** | `完整开发流程手册.md` | 从需求想法到上线发布的完整端到端开发流程，包含每个阶段的目标、使用技能、产出物、检查清单 |
-| **技能决策树.md** | `技能决策树.md` | 什么场景用什么技能，快速决策选择 |
-| **技能体系完善建议.md** | `技能体系完善建议.md` | 技能体系的现状分析、完整技能列表、最佳实践 |
+---
 
-## 快速开始
+## 技能分层结构
 
-### 新手入门
-1. 先看 **技能决策树.md** - 了解什么场景用什么技能
-2. 再看 **技能使用指南.md** - 了解所有技能的功能
-3. 最后看 **完整开发流程手册.md** - 了解端到端流程
+```
+skills/
+├── requirement-analysis/     # 需求分析层（7个技能）
+├── design-planning/          # 设计规划层（15个技能）
+├── development-execution/    # 开发执行层（7个技能）
+├── flutter/                  # Flutter专项技能层（10个技能）
+├── quality-assurance/        # 质量保障层（4个技能）
+├── release-ops/              # 发布运维层（2个技能）
+├── knowledge-precipitation/  # 知识沉淀层（2个技能）
+├── special-tools/            # 专项工具层（5个技能）
+├── writing-skills/           # 技能编写工具层（1个技能）
+├── call-adaptation/          # 调用机制适配（1个）
+├── templates/                # SDD模板库（25个模板）
+├── rules/                    # 规则文件（2个）
+├── README.md                 # 本文件（技能目录索引+版本信息）
+```
 
-### 新项目
-1. 查看 **完整开发流程手册.md** - 了解完整流程
-2. 根据场景使用 **技能决策树.md** - 选择合适的技能
-3. 需要时参考 **技能使用指南.md** - 了解技能详情
+---
 
-## 现有技能列表
+## 详细技能列表
 
-### 需求分析类
+### 1. 需求分析层（7个）
 - brainstorming - 创意头脑风暴
-- market-research - 市场调研
 - competitive-brief - 竞品简报
+- market-research - 市场调研
 - prd-write - PRD文档编写
 - requirement-completion-officer - 需求补全
 - sdd - 基础SDD拆分
 - sdd-full - 完整SDD流程
 
-### 设计规划类
-- ui-sdd - UI交互SDD
-- sdd-code - 功能实现SDD
-- sdd-test - 测试SDD
+### 2. 设计规划层（15个）
+- ai-coding-rules - AI编码规则
+- design-to-code - 设计转代码
+- enterprise-spec - 企业级工程规范
+- flutter-av - Flutter音视频
+- flutter-map - Flutter地图导航
+- function-sdd - 功能SDD
+- global-overlay-stack-standard - 全局浮层堆叠规范
+- sdd-code - 代码实现SDD
 - sdd-deploy - 部署SDD
 - sdd-ops - 运维SDD
+- sdd-test - 测试SDD
+- ui-motion-interaction-standard - UI动效交互规范
+- ui-sdd - UI交互SDD
+- ui-sdd-specialized - 专用UI-SDD
 - writing-plans - 编写计划
 
-### 开发执行类
-- sdd-add - 快速迭代
-- test-driven-development - TDD开发
+### 3. 开发执行层（7个）
+- bug-reproduction-confirm - Bug复现确认
+- flutter-errors - Flutter异常排查
+- performance-optimize - 性能优化
+- sdd-add - 快速迭代开发
 - systematic-debugging - 系统化调试
-- **bug-reproduction-confirm - Bug复现确认**
-- **performance-optimize - 性能优化**
+- test-driven-development - TDD开发
 - verification-before-completion - 完成前验证
 
-### 质量保障类
+### 4. Flutter专项技能层（10个）
+- flutter-add-integration-test - 集成测试
+- flutter-add-widget-preview - 组件预览
+- flutter-add-widget-test - 组件测试
+- flutter-apply-architecture-best-practices - 架构最佳实践
+- flutter-build-responsive-layout - 响应式布局
+- flutter-fix-layout-issues - 布局问题修复
+- flutter-implement-json-serialization - JSON序列化
+- flutter-setup-declarative-routing - 声明式路由
+- flutter-setup-localization - 本地化
+- flutter-use-http-package - HTTP网络请求
+
+### 5. 质量保障层（4个）
+- bdd-acceptance - BDD验收标准
+- flutter-test - Flutter测试策略
 - quality-gate - 质量门禁
 - security-audit - 安全审计
 
-### 发布运维类
+### 6. 发布运维层（2个）
 - finishing-a-development-branch - 完成开发分支
 - release-flow - 发布流程
 
-### 知识沉淀类
+### 7. 知识沉淀层（2个）
 - claudeception - 持续学习
 - mempalace-auto-saver - 自动保存记忆
 
-### 专项工具类
-- using-superpowers - Superpowers全流程
-- requesting-code-review - 请求代码审查
-- receiving-code-review - 接收代码审查
+### 8. 专项工具层（5个）
+- env-check - 环境预检
 - ios-full-auto-debug - iOS真机全自动化调试
+- receiving-code-review - 接收代码审查
+- requesting-code-review - 请求代码审查
+- using-superpowers - Superpowers全流程
+
+### 9. 技能编写工具层（1个）
+- writing-skills - 技能编写工具
+
+### 10. 调用机制适配（1个）
+- call-adaptation - 双调用机制适配
+
+---
+
+## SDD 模板列表
+
+### 基础模板（9个）
+| 模板名称 | 简称 | 适配场景 |
+|---------|------|---------|
+| Base-SDD | Base | 全局通用基线 |
+| Brain-SDD | Brain | 头脑风暴 |
+| Competitor-SDD | Competitor | 竞品分析 |
+| PRD-SDD | PRD | 产品需求 |
+| UI-SDD | UI | UI设计 |
+| Code-SDD | Code | 代码实现 |
+| API-SDD | API | 接口设计 |
+| Env-SDD | Env | 环境配置 |
+| Test-SDD | Test | 测试设计 |
+
+### 专项模板（16个）
+| 模板名称 | 适用场景 |
+|---------|---------|
+| UI-SDD专用模板 | UI设计阶段 |
+| 功能SDD专用模板 | 功能开发 |
+| BDD风格验收标准SDD | 测试验收 |
+| 环境预检标准化SDD | 项目启动 |
+| Flutter地图导航业务SDD | 地图开发 |
+| Flutter音视频全栈SDD | 音视频功能 |
+| Flutter全类型测试策略SDD | 测试策略 |
+| Flutter常见异常专项SDD | Bug修复 |
+| 企业级全栈工程规范SDD | 工程规范 |
+| Andrej Karpathy AI编码规则落地SDD | 编码规范 |
+| 高保真设计转代码SDD | 设计转代码 |
+| UI资源提示词生成SDD | UI资源生成 |
+| BugReproduction-SDD | Bug复现确认 |
+| Performance-SDD | 性能优化 |
+| 全流程SDD融合体系 | 全流程管理 |
+
+---
 
 ## 快速安装
-### 使用npm包安装（推荐）
+
 ```bash
 # 默认安装到Trae环境
 npx sdd-full
@@ -88,13 +166,43 @@ npx sdd-full all
 
 # 查看帮助
 npx sdd-full --help
-
-# 显示详细信息
-npx sdd-full --verbose
 ```
 
-## 更新日志
+---
+
+## 更新历史
+
+### v4.8.1 (2026-05-08)
+- 同步 VERSION.md 版本号，修复版本不一致问题
+- 合并 README.md 与 VERSION.md，统一版本信息入口
+- 更新技能列表，新增 flutter/、writing-skills/ 等技能目录
+
+### v4.8.0 (2026-05-08)
+- 新增 Flutter 专项技能 10 个（集成测试、组件测试、响应式布局等）
+- 新增 writing-skills 技能编写工具
+- 新增 global-overlay-stack-standard、ui-motion-interaction-standard 设计规范
+
+### v4.6.2 (2026-05-06)
+- 同步 VERSION.md 版本号至 4.6.2
+- 修正版本号同步遗漏问题
+
+### v4.6.1 (2026-05-06)
+- 同步 VERSION.md 版本号至 4.6.1
+
+### v4.6.0 (2026-05-06)
+- 新增 VERSION.md 版本文件
+- 优化安装输出，显示版本信息
+- 完善技能清单和模板列表
+
+### v4.5.0 (2026-05-06)
+- 新增 bug-reproduction-confirm、performance-optimize 技能
+- 新增 BugReproduction-SDD、Performance-SDD 模板
+
+### v4.3.0 (2026-05-06)
+- 初始版本发布
+
+---
+
+## 项目链接
 
-- 2026-05-05: 发布到npm包，新增npx安装方式，支持Trae/Trae-cn/Claude Code多环境安装
-- 2026-05-04: 更新技能列表，匹配当前实际存在的技能
-- 2024-05-04: 创建目录索引，整理技能文档
+- **npm**: https://www.npmjs.com/package/sdd-full

package/skills/design-planning/ai-coding-rules/SKILL.md

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

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

@@ -1,9 +1,18 @@
-【claude code调用标识：高保真设计转代码SDD】【trae调用标识：高保真设计转代码SDD+设计转代码】【流程场景：1.完整3阶段SDD流程、3.小型功能迭代】
+name: 高保真设计转代码SDD
+description: Rive动画、Figma设计稿转Flutter 1:1还原交付规范
+author: 
+version: 1.0.0
+trigger:
+  - 设计转代码
+  - Rive动画
+  - Figma转Flutter
+tags:
+  - 设计转代码
+  - Rive动画
+  - Figma
+  - Flutter
 
----
-name: design-to-code
-description: 高保真设计转代码SDD - Rive动画、Figma设计稿转Flutter 1:1还原交付规范
----
+【claude code调用标识：高保真设计转代码SDD】【trae调用标识：高保真设计转代码SDD+设计转代码】【流程场景：1.完整3阶段SDD流程、3.小型功能迭代】
 
 ## 功能描述
 

package/skills/design-planning/enterprise-spec/SKILL.md

@@ -1,9 +1,17 @@
-【claude code调用标识：企业级全栈工程规范SDD】【trae调用标识：企业级全栈工程规范SDD+工程规范】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目】
+name: 企业级全栈工程规范SDD
+description: 环境预检前置、项目目录、版本管理、交付物统一标准
+author: 
+version: 1.0.0
+trigger:
+  - 企业级工程规范
+  - 项目规范
+  - 工程标准
+tags:
+  - 工程规范
+  - 项目管理
+  - 交付标准
 
----
-name: enterprise-spec
-description: 企业级全栈工程规范SDD - 环境预检前置、项目目录、版本管理、交付物统一标准
----
+【claude code调用标识：企业级全栈工程规范SDD】【trae调用标识：企业级全栈工程规范SDD+工程规范】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目】
 
 ## 功能描述
 

package/skills/design-planning/flutter-av/SKILL.md

@@ -1,9 +1,20 @@
-【claude code调用标识：Flutter音视频全栈SDD】【trae调用标识：Flutter音视频全栈SDD+音视频集成】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代】
+name: Flutter音视频全栈SDD
+description: 离线ASR语音转写、TTS语音合成、OCR文字识别接入规范
+author: 
+version: 1.0.0
+trigger:
+  - Flutter音视频
+  - ASR语音转写
+  - TTS语音合成
+  - OCR识别
+tags:
+  - Flutter
+  - 音视频
+  - ASR
+  - TTS
+  - OCR
 
----
-name: flutter-av
-description: Flutter音视频全栈SDD - 离线ASR语音转写、TTS语音合成、OCR文字识别接入规范
----
+【claude code调用标识：Flutter音视频全栈SDD】【trae调用标识：Flutter音视频全栈SDD+音视频集成】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代】
 
 ## 功能描述
 

package/skills/design-planning/flutter-map/SKILL.md

@@ -1,9 +1,18 @@
-【claude code调用标识：Flutter地图导航业务SDD】【trae调用标识：Flutter地图导航业务SDD+地图集成】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代】
+name: Flutter地图导航业务SDD
+description: 高德SDK集成、Marker警告处理、地图不显示问题落地规范
+author: 
+version: 1.0.0
+trigger:
+  - Flutter地图导航
+  - 高德地图集成
+  - 地图开发
+tags:
+  - Flutter
+  - 地图
+  - 高德SDK
+  - 导航
 
----
-name: flutter-map
-description: Flutter地图导航业务SDD - 高德SDK集成、Marker警告处理、地图不显示问题落地规范
----
+【claude code调用标识：Flutter地图导航业务SDD】【trae调用标识：Flutter地图导航业务SDD+地图集成】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代】
 
 ## 功能描述
 

package/skills/design-planning/function-sdd/SKILL.md

@@ -1,9 +1,17 @@
-【claude code调用标识：功能SDD专用模板】【trae调用标识：功能SDD专用模板+功能设计规范】【流程场景：1.完整3阶段SDD流程、3.小型功能迭代、4.Bug处理】
+name: 功能SDD专用模板
+description: 业务功能专属SDD模板、章节结构、必填项规范
+author: 
+version: 1.0.0
+trigger:
+  - 功能SDD专用模板
+  - 业务功能模板
+  - 功能设计规范
+tags:
+  - 功能设计
+  - SDD模板
+  - 业务规范
 
----
-name: function-sdd
-description: 功能SDD专用模板 - 业务功能专属SDD模板、章节结构、必填项规范
----
+【claude code调用标识：功能SDD专用模板】【trae调用标识：功能SDD专用模板+功能设计规范】【流程场景：1.完整3阶段SDD流程、3.小型功能迭代、4.Bug处理】
 
 ## 功能描述
 

package/skills/design-planning/global-overlay-stack-standard/SKILL.md

@@ -1,9 +1,19 @@
-【claude code调用标识：global-overlay-stack-standard】【trae调用标识：global-overlay-stack-standard+浮层管理】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代】
-
----
 name: global-overlay-stack-standard
 description: 全局浮层栈与层级规范 - 跨技术栈通用浮层管理规则
----
+author:
+version: 1.0.0
+trigger:
+  - 浮层栈
+  - 浮层规范
+  - 弹窗管理
+  - 层级管理
+tags:
+  - 浮层管理
+  - 工程规范
+  - UI规范
+  - 跨端通用
+
+【claude code调用标识：global-overlay-stack-standard】【trae调用标识：global-overlay-stack-standard+浮层管理】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代】
 
 ## 功能说明
 

package/skills/design-planning/ui-motion-interaction-standard/SKILL.md

@@ -1,9 +1,19 @@
-【claude code调用标识：ui-motion-interaction-standard】【trae调用标识：ui-motion-interaction-standard+UI动效】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代】
-
----
 name: ui-motion-interaction-standard
 description: 全局UI动效与交互反馈规范 - 跨端通用交互动效管理
----
+author:
+version: 1.0.0
+trigger:
+  - 动效规范
+  - 交互动效
+  - 动画规范
+  - 交互反馈
+tags:
+  - UI动效
+  - 交互动画
+  - 工程规范
+  - 跨端通用
+
+【claude code调用标识：ui-motion-interaction-standard】【trae调用标识：ui-motion-interaction-standard+UI动效】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代】
 
 ## 功能说明
 

package/skills/design-planning/ui-sdd-specialized/SKILL.md

@@ -1,9 +1,18 @@
-【claude code调用标识：UI-SDD专用模板】【trae调用标识：UI-SDD专用模板+UI设计规范】【流程场景：1.完整3阶段SDD流程、3.小型功能迭代】
+name: UI-SDD专用模板
+description: UI设计稿结构化SDD固定格式、字段、交付标准
+author: 
+version: 1.0.0
+trigger:
+  - UI-SDD专用模板
+  - UI设计稿模板
+  - UI交付标准
+tags:
+  - UI设计
+  - SDD模板
+  - 设计规范
+  - 交付标准
 
----
-name: ui-sdd-specialized
-description: UI-SDD专用模板 - UI设计稿结构化SDD固定格式、字段、交付标准
----
+【claude code调用标识：UI-SDD专用模板】【trae调用标识：UI-SDD专用模板+UI设计规范】【流程场景：1.完整3阶段SDD流程、3.小型功能迭代】
 
 ## 功能描述
 

package/skills/development-execution/flutter-errors/SKILL.md

@@ -1,9 +1,19 @@
-【claude code调用标识：Flutter常见异常专项SDD】【trae调用标识：Flutter常见异常专项SDD+异常处理】【流程场景：4.Bug处理】
+name: Flutter常见异常专项SDD
+description: SocketException、Framebuffer渲染异常排查与修复标准化流程
+author: 
+version: 1.0.0
+trigger:
+  - Flutter异常处理
+  - SocketException
+  - Framebuffer异常
+  - Bug排查
+tags:
+  - Flutter
+  - 异常处理
+  - Bug修复
+  - 调试
 
----
-name: flutter-errors
-description: Flutter常见异常专项SDD - SocketException、Framebuffer渲染异常排查与修复标准化流程
----
+【claude code调用标识：Flutter常见异常专项SDD】【trae调用标识：Flutter常见异常专项SDD+异常处理】【流程场景：4.Bug处理】
 
 ## 功能描述
 

package/skills/quality-assurance/bdd-acceptance/SKILL.md

@@ -1,9 +1,18 @@
-【claude code调用标识：BDD风格验收标准SDD】【trae调用标识：BDD风格验收标准SDD+验收规范】【流程场景：1.完整3阶段SDD流程、3.小型功能迭代、4.Bug处理】
+name: BDD风格验收标准SDD
+description: BDD验收句式、场景写法、准入/准出标准
+author: 
+version: 1.0.0
+trigger:
+  - BDD验收标准
+  - BDD测试
+  - 验收规范
+tags:
+  - BDD
+  - 测试
+  - 验收标准
+  - SDD模板
 
----
-name: bdd-acceptance
-description: BDD风格验收标准SDD - BDD验收句式、场景写法、准入/准出标准
----
+【claude code调用标识：BDD风格验收标准SDD】【trae调用标识：BDD风格验收标准SDD+验收规范】【流程场景：1.完整3阶段SDD流程、3.小型功能迭代、4.Bug处理】
 
 ## 功能描述
 

package/skills/quality-assurance/flutter-test/SKILL.md

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