sdd-full 4.2.0 → 4.3.1

package/bin.js

@@ -6,7 +6,7 @@ const fs = require('fs');
 const path = require('path');
 
 const SDD = {
-  version: '3.2.0',
+  version: '4.3.1',
   name: 'sdd-full',
   description: '完整的软件设计开发技能包'
 };
@@ -81,114 +81,132 @@ function install(targetDir, environment) {
   console.log(`  版本: ${SDD.version}`);
   console.log('========================================');
   
-  const sourceSkillsDir = path.join(__dirname, 'skills');
-  const sourceRulesDir = path.join(__dirname, 'skills', 'rules');
-  debug(`技能源目录: ${sourceSkillsDir}`);
-  debug(`规则源目录: ${sourceRulesDir}`);
+  const skillsSourceDir = path.join(__dirname, 'skills');
+  const rulesSourceDir = path.join(__dirname, 'skills', 'rules');
+  debug(`技能源目录: ${skillsSourceDir}`);
+  debug(`规则源目录: ${rulesSourceDir}`);
+  debug(`技能源目录存在: ${fs.existsSync(skillsSourceDir)}`);
+  debug(`规则源目录存在: ${fs.existsSync(rulesSourceDir)}`);
   
   // 根据环境选择安装目录
-  let dirsToInstall;
+  let installConfig;
   
   if (environment === 'cc') {
-    dirsToInstall = [
-      { name: 'Claude Code 技能', path: path.join(baseDir, '.claude', 'skills') },
-      { name: 'Claude Code 规则', path: path.join(baseDir, '.claude', 'rules') }
+    installConfig = [
+      { name: 'Claude Code', skillsPath: path.join(baseDir, '.claude', 'skills'), rulesPath: path.join(baseDir, '.claude', 'rules') }
     ];
   } else if (environment === 'all') {
-    dirsToInstall = [
-      { name: 'Trae / Solo 技能', path: path.join(baseDir, '.trae', 'skills') },
-      { name: 'Trae / Solo 规则', path: path.join(baseDir, '.trae', 'rules') },
-      { name: 'Claude Code 技能', path: path.join(baseDir, '.claude', 'skills') },
-      { name: 'Claude Code 规则', path: path.join(baseDir, '.claude', 'rules') },
-      { name: '通用 sdd-full', path: path.join(baseDir, '.sdd-full', 'skills') }
+    installConfig = [
+      { name: 'Trae / Solo', skillsPath: path.join(baseDir, '.trae', 'skills'), rulesPath: path.join(baseDir, '.trae', 'rules') },
+      { name: 'Claude Code', skillsPath: path.join(baseDir, '.claude', 'skills'), rulesPath: path.join(baseDir, '.claude', 'rules') },
+      { name: '通用 sdd-full', skillsPath: path.join(baseDir, '.sdd-full', 'skills'), rulesPath: path.join(baseDir, '.sdd-full', 'rules') }
     ];
   } else {
     // 默认：Trae / Solo
-    dirsToInstall = [
-      { name: 'Trae / Solo 技能', path: path.join(baseDir, '.trae', 'skills') },
-      { name: 'Trae / Solo 规则', path: path.join(baseDir, '.trae', 'rules') }
+    installConfig = [
+      { name: 'Trae / Solo', skillsPath: path.join(baseDir, '.trae', 'skills'), rulesPath: path.join(baseDir, '.trae', 'rules') }
     ];
   }
   
-  let totalSkillCount = 0;
-  let totalRuleCount = 0;
+  let totalSkillsCount = 0;
+  let totalRulesCount = 0;
   
-  dirsToInstall.forEach(dirInfo => {
-    const destDir = dirInfo.path;
-    debug(`安装目标: ${dirInfo.name} -> ${destDir}`);
+  installConfig.forEach(config => {
+    const skillsDestDir = config.skillsPath;
+    const rulesDestDir = config.rulesPath;
+    debug(`安装目标: ${config.name}`);
+    debug(`  技能目录: ${skillsDestDir}`);
+    debug(`  规则目录: ${rulesDestDir}`);
     
-    console.log(`\n正在安装到: ${dirInfo.name} (${destDir})`);
+    console.log(`\n正在安装到: ${config.name}`);
     
-    if (!fs.existsSync(destDir)) {
-      debug(`创建目标目录: ${destDir}`);
-      fs.mkdirSync(destDir, { recursive: true });
+    // 安装技能（不含rules目录）
+    console.log(`  📦 安装技能到: ${skillsDestDir}`);
+    if (!fs.existsSync(skillsDestDir)) {
+      debug(`创建技能目录: ${skillsDestDir}`);
+      fs.mkdirSync(skillsDestDir, { recursive: true });
     }
     
-    let count = 0;
-    if (dirInfo.name.includes('技能')) {
-      // 安装技能
-      if (fs.existsSync(sourceSkillsDir)) {
-        const items = fs.readdirSync(sourceSkillsDir);
-        debug(`技能源目录内容: ${items.join(', ')}`);
+    let skillsCount = 0;
+    if (fs.existsSync(skillsSourceDir)) {
+      const items = fs.readdirSync(skillsSourceDir);
+      debug(`技能源目录内容: ${items.join(', ')}`);
+      
+      items.forEach(item => {
+        // 跳过rules目录，它将单独安装
+        if (item === 'rules') {
+          return;
+        }
         
-        items.forEach(item => {
-          const srcItem = path.join(sourceSkillsDir, item);
-          const destItem = path.join(destDir, item);
-          const stat = fs.statSync(srcItem);
-          
-          if (stat.isDirectory()) {
-            // 跳过 rules 目录，单独处理
-            if (item === 'rules') return;
-            debug(`复制技能目录: ${item}`);
-            copyDirectory(srcItem, destItem);
-            count++;
-          } else if (stat.isFile() && item.endsWith('.md')) {
-            debug(`复制技能文件: ${item}`);
-            fs.copyFileSync(srcItem, destItem);
-          }
-        });
-      }
-      totalSkillCount += count;
-    } else if (dirInfo.name.includes('规则')) {
-      // 安装规则
-      if (fs.existsSync(sourceRulesDir)) {
-        const items = fs.readdirSync(sourceRulesDir);
-        debug(`规则源目录内容: ${items.join(', ')}`);
+        const srcItem = path.join(skillsSourceDir, item);
+        const destItem = path.join(skillsDestDir, item);
+        const stat = fs.statSync(srcItem);
         
-        items.forEach(item => {
-          const srcItem = path.join(sourceRulesDir, item);
-          const destItem = path.join(destDir, item);
-          const stat = fs.statSync(srcItem);
-          
-          if (stat.isFile()) {
-            debug(`复制规则文件: ${item}`);
-            fs.copyFileSync(srcItem, destItem);
-            count++;
-          }
-        });
-      }
-      totalRuleCount += count;
+        if (stat.isDirectory()) {
+          debug(`复制技能目录: ${item}`);
+          copyDirectory(srcItem, destItem);
+          skillsCount++;
+        } else if (stat.isFile() && item.endsWith('.md')) {
+          debug(`复制技能文件: ${item}`);
+          fs.copyFileSync(srcItem, destItem);
+        }
+      });
+    }
+    
+    totalSkillsCount += skillsCount;
+    console.log(`    ✅ ${skillsCount} 个技能`);
+    
+    // 安装规则到.trae根目录下
+    console.log(`  📋 安装规则到: ${rulesDestDir}`);
+    if (!fs.existsSync(rulesDestDir)) {
+      debug(`创建规则目录: ${rulesDestDir}`);
+      fs.mkdirSync(rulesDestDir, { recursive: true });
     }
     
-    console.log(`  ✅ ${count} 个文件`);
+    let rulesCount = 0;
+    if (fs.existsSync(rulesSourceDir)) {
+      const items = fs.readdirSync(rulesSourceDir);
+      debug(`规则源目录内容: ${items.join(', ')}`);
+      
+      items.forEach(item => {
+        const srcItem = path.join(rulesSourceDir, item);
+        const destItem = path.join(rulesDestDir, item);
+        const stat = fs.statSync(srcItem);
+        
+        if (stat.isFile() && item.endsWith('.md')) {
+          debug(`复制规则文件: ${item}`);
+          fs.copyFileSync(srcItem, destItem);
+          rulesCount++;
+        }
+      });
+    }
+    
+    totalRulesCount += rulesCount;
+    console.log(`    ✅ ${rulesCount} 个规则文件`);
     
     // 验证安装结果
-    if (fs.existsSync(destDir)) {
-      const installedItems = fs.readdirSync(destDir);
-      debug(`目标目录内容: ${installedItems.join(', ')}`);
-      console.log(`  📁 已安装内容: ${installedItems.length} 项`);
+    if (fs.existsSync(skillsDestDir)) {
+      const installedSkills = fs.readdirSync(skillsDestDir);
+      debug(`技能目录内容: ${installedSkills.join(', ')}`);
+      console.log(`    📁 技能内容: ${installedSkills.length} 项`);
+    }
+    if (fs.existsSync(rulesDestDir)) {
+      const installedRules = fs.readdirSync(rulesDestDir);
+      debug(`规则目录内容: ${installedRules.join(', ')}`);
+      console.log(`    📁 规则内容: ${installedRules.length} 项`);
     }
   });
   
   console.log('\n========================================');
   console.log(`✅ 安装完成！`);
-  console.log(`   技能: ${totalSkillCount} 个`);
-  console.log(`   规则: ${totalRuleCount} 个`);
+  console.log(`   - 技能: ${totalSkillsCount} 个`);
+  console.log(`   - 规则: ${totalRulesCount} 个文件`);
   console.log('========================================');
   console.log('\n现在您可以在以下环境中使用这些技能和规则：');
-  dirsToInstall.forEach(dirInfo => {
-    console.log(`  - ${dirInfo.name}`);
-    console.log(`    位置: ${dirInfo.path}`);
+  installConfig.forEach(config => {
+    console.log(`  - ${config.name}`);
+    console.log(`    技能位置: ${config.skillsPath}`);
+    console.log(`    规则位置: ${config.rulesPath}`);
   });
   console.log('\n🎉 开始使用吧！\n');
 }
@@ -254,4 +272,4 @@ function main() {
 }
 
 // 运行主函数
-main();
+main();

package/package.json

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

package/skills/README.md

@@ -0,0 +1,97 @@
+【claude code调用标识：技能文档目录索引】【trae调用标识：技能文档目录索引+文档导航】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代、4.Bug处理、5.代码发布】
+
+# 技能文档目录索引
+
+## 概述
+
+本目录包含所有技能体系相关的文档，帮助你快速了解和使用整个技能体系。
+
+## 文档列表
+
+### 核心文档
+
+| 文档名称 | 路径 | 说明 |
+|---------|------|------|
+| **技能使用指南.md** | `技能使用指南.md` | 所有技能的使用场景、功能特点、与其他技能的关系，快速选择和使用合适的技能 |
+| **完整开发流程手册.md** | `完整开发流程手册.md` | 从需求想法到上线发布的完整端到端开发流程，包含每个阶段的目标、使用技能、产出物、检查清单 |
+| **技能决策树.md** | `技能决策树.md` | 什么场景用什么技能，快速决策选择 |
+| **技能体系完善建议.md** | `技能体系完善建议.md` | 技能体系的现状分析、完整技能列表、最佳实践 |
+
+## 快速开始
+
+### 新手入门
+1. 先看 **技能决策树.md** - 了解什么场景用什么技能
+2. 再看 **技能使用指南.md** - 了解所有技能的功能
+3. 最后看 **完整开发流程手册.md** - 了解端到端流程
+
+### 新项目
+1. 查看 **完整开发流程手册.md** - 了解完整流程
+2. 根据场景使用 **技能决策树.md** - 选择合适的技能
+3. 需要时参考 **技能使用指南.md** - 了解技能详情
+
+## 现有技能列表
+
+### 需求分析类
+- brainstorming - 创意头脑风暴
+- market-research - 市场调研
+- competitive-brief - 竞品简报
+- prd-write - PRD文档编写
+- requirement-completion-officer - 需求补全
+- sdd - 基础SDD拆分
+- sdd-full - 完整SDD流程
+
+### 设计规划类
+- ui-sdd - UI交互SDD
+- sdd-code - 功能实现SDD
+- sdd-test - 测试SDD
+- sdd-deploy - 部署SDD
+- sdd-ops - 运维SDD
+- writing-plans - 编写计划
+
+### 开发执行类
+- sdd-add - 快速迭代
+- test-driven-development - TDD开发
+- systematic-debugging - 系统化调试
+- verification-before-completion - 完成前验证
+
+### 质量保障类
+- quality-gate - 质量门禁
+- security-audit - 安全审计
+
+### 发布运维类
+- finishing-a-development-branch - 完成开发分支
+- release-flow - 发布流程
+
+### 知识沉淀类
+- claudeception - 持续学习
+- mempalace-auto-saver - 自动保存记忆
+
+### 专项工具类
+- using-superpowers - Superpowers全流程
+- requesting-code-review - 请求代码审查
+- receiving-code-review - 接收代码审查
+
+## 快速安装
+### 使用npm包安装（推荐）
+```bash
+# 默认安装到Trae环境
+npx sdd-full
+
+# 安装到Claude Code
+npx sdd-full cc
+
+# 安装到所有环境
+npx sdd-full all
+
+# 查看帮助
+npx sdd-full --help
+
+# 显示详细信息
+npx sdd-full --verbose
+```
+
+## 更新日志
+
+- 2026-05-05: 发布到npm包，新增npx安装方式，支持Trae/Trae-cn/Claude Code多环境安装
+- 2026-05-04: 更新技能列表，匹配当前实际存在的技能
+- 2024-05-04: 创建目录索引，整理技能文档

package/skills/call-adaptation/SKILL.md

@@ -0,0 +1,23 @@
+【claude code调用标识：call-adaptation】【trae调用标识：call-adaptation+调用机制适配】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代、4.Bug处理、5.代码发布】
+
+---
+name: call-adaptation
+description: 调用机制适配技能 - 处理Trae与Claude Code两种调用机制的差异，提供调用指南和规范说明
+---
+
+# 调用机制适配
+
+## 功能说明
+本技能用于处理Trae与Claude Code两种调用机制的适配，提供：
+- Trae调用规范
+- Claude Code调用规范
+- 调用方式切换指南
+
+## 核心文档
+- trae-call-spec.md - Trae调用规范
+- claude-code-call-spec.md - Claude Code调用规范
+- call-adaptation-guide.md - 调用适配指南
+
+## 调用方式
+- **Claude Code**: 调用 call-adaptation
+- **Trae**: trae调用 call-adaptation

package/skills/call-adaptation/call-adaptation-guide.md

@@ -0,0 +1,136 @@
+# 两种调用机制切换指南及异常处理
+
+## 一、切换逻辑
+
+### 1.1 使用claude code调用
+- 直接通过关键词触发，无需额外操作
+- 示例："调用brainstorming技能，项目名称：XX"
+
+### 1.2 使用trae调用
+
+#### 方式1：完整路径调用（标准）
+- 需按固定格式输入调用指令，包含技能文档路径、必传参数、流程场景
+- 格式：trae调用 skills/对应分类目录/技能名称.md 参数1=值1 参数2=值2 流程场景=场景名称
+- 示例：trae调用 skills/requirement-analysis/brainstorming.md 项目名称=XX 触发场景=需求分析 流程场景=从零开始新项目
+
+#### 方式2：模板快捷调用（推荐）
+- 无需填写完整路径，系统自动匹配templates目录及流程适配逻辑
+- 格式：trae调用 模板名称 必传参数 流程场景=场景名称
+- 示例：trae调用 Brain-SDD 项目名称=个人备忘录APP 阶段=初期想法收集 流程场景=从零开始新项目
+
+#### 方式3：简称快捷调用（最快捷）
+- 使用预设的模板简称，输入更简洁
+- 格式：trae快捷 模板简称 必传参数 流程场景=场景名称
+- 示例：trae快捷 Brain 项目名称=个人备忘录APP 阶段=初期想法收集 流程场景=从零开始新项目
+
+### 1.3 快捷指令映射表
+
+| 模板简称 | 完整模板名称 | 对应目录 |
+|---------|------------|---------|
+| Base | Base-SDD.md | skills/templates/ |
+| Brain | Brain-SDD.md | skills/templates/ |
+| Competitor | Competitor-SDD.md | skills/templates/ |
+| PRD | PRD-SDD.md | skills/templates/ |
+| UI | UI-SDD.md | skills/templates/ |
+| Code | Code-SDD.md | skills/templates/ |
+| API | API-SDD.md | skills/templates/ |
+| Env | Env-SDD.md | skills/templates/ |
+| Test | Test-SDD.md | skills/templates/ |
+
+### 1.4 SDD全流程场景说明
+
+| 流程场景 | 场景编号 | 适用范围 | 核心技能 |
+|---------|---------|---------|---------|
+| 完整3阶段SDD流程 | 1 | 大型项目、完整迭代 | sdd, brainstorming, prd-write, ui-sdd, sdd-code, sdd-test |
+| 从零开始新项目 | 2 | 新项目启动 | brainstorming, market-research, competitive-brief, prd-write |
+| 小型功能迭代 | 3 | 功能新增/优化 | sdd-add, sdd-code, sdd-test |
+| Bug处理 | 4 | Bug修复 | systematic-debugging, sdd-add, sdd-test |
+| 代码发布 | 5 | 版本发布 | quality-gate, release-flow, finishing-a-development-branch |
+
+### 1.5 按需加载优化逻辑
+
+基于流程场景拆分技能/模板加载范围，确保加载体积≤30k：
+
+| 流程场景 | 加载范围 | 排除技能 |
+|---------|---------|---------|
+| Bug处理 | systematic-debugging, sdd-add, sdd-test | market-research, competitive-brief, ui-sdd |
+| 代码发布 | quality-gate, release-flow, security-audit | brainstorming, ui-sdd, market-research |
+| 小型功能迭代 | sdd-add, sdd-code, sdd-test | competitive-brief, market-research |
+| 从零开始新项目 | brainstorming, market-research, competitive-brief, prd-write | sdd-deploy, sdd-ops |
+| 完整3阶段SDD流程 | 全部技能 | 无 |
+
+### 1.6 流程场景缓存策略
+
+- 高频流程（如小型功能迭代、Bug处理）：首次加载后缓存，后续调用无需重复加载
+- 低频流程（如完整3阶段SDD流程）：不缓存，每次调用重新加载
+- 缓存清理：定期清理过期缓存（建议每周一次）
+
+## 二、异常处理方案
+
+### 2.1 trae调用失败
+优先核对以下4点：
+1. 技能文档路径是否正确
+2. 文档头部是否有trae调用标识
+3. 必传参数是否完整
+4. 流程场景参数是否正确
+
+核对后重新触发调用，仍失败则检查缓存和加载配置。
+
+### 2.2 claude code调用失败
+- 无需额外核对，直接重试或手动选择技能选项
+- 简单流程场景可使用原生触发（/命令）提升效率
+
+### 2.3 两种机制均调用失败
+- 查看本指南及相关适配文档
+- 检查技能文档是否符合统一规范
+- 清除trae本地缓存后重试
+
+### 2.4 流程场景适配失败
+- 检查流程场景参数是否在允许范围内（场景编号1-5）
+- 核对call-adaptation中的场景适配逻辑
+- 检查按需加载配置是否正确
+
+## 三、技能文档规范检查清单
+
+| 检查项 | 说明 |
+|--------|------|
+| 双调用标识 | 文档头部是否包含【claude code调用标识】和【trae调用标识】 |
+| 流程场景标识 | 文档头部是否包含【流程场景：对应全流程场景（1-5）】 |
+| 命名规范 | 文件名是否与原始技能列表一致，无特殊字符 |
+| 选项式设计 | 是否每个模块都有可选项和自定义补充入口 |
+| 参数说明 | 是否包含trae调用参数说明（调用路径、必传/可选参数、流程场景参数） |
+| 路径匹配 | 调用路径是否与实际目录结构一致 |
+| 流程衔接 | 是否包含流程衔接说明（前后步骤关联） |
+
+## 四、技能目录结构参考
+
+```
+skills/
+├─ requirement-analysis/     # 需求分析类（brainstorming, market-research, competitive-brief, prd-write, requirement-completion-officer, sdd, sdd-full, unified-flow）
+├─ design-planning/          # 设计规划类（ui-sdd, sdd-code, sdd-test, sdd-deploy, sdd-ops, writing-plans）
+├─ development-execution/    # 开发执行类（sdd-add, test-driven-development, systematic-debugging, verification-before-completion）
+├─ quality-assurance/        # 质量保障类（quality-gate, security-audit）
+├─ release-ops/              # 发布运维类（finishing-a-development-branch, release-flow）
+├─ knowledge-precipitation/  # 知识沉淀类（claudeception, mempalace-auto-saver）
+├─ special-tools/            # 专项工具类（using-superpowers, requesting-code-review, receiving-code-review）
+├─ call-adaptation/          # 调用机制适配
+├─ sdd-framework/            # SDD框架模板
+└─ templates/                # SDD模板
+```
+
+## 五、调用标识格式规范
+
+### 5.1 统一标识格式
+```
+【claude code调用标识：技能/模板名称】【trae调用标识：技能/模板名称+关联项】【流程场景：对应全流程场景（1-5）】
+```
+
+### 5.2 示例
+```
+【claude code调用标识：Brain-SDD】【trae调用标识：Brain-SDD+头脑风暴】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目】
+```
+
+---
+
+**版本**: v2.0  
+**适用场景**: 两种调用机制切换与异常处理、SDD全流程适配

package/skills/call-adaptation/claude-code-call-spec.md

@@ -0,0 +1,50 @@
+# claude code调用机制说明及技能文档适配规范
+
+## 一、claude code调用机制核心特性
+
+### 1.1 调用触发方式
+- 支持关键词触发、主动调用两种方式
+- 可直接读取技能文档中的选项式内容，自动匹配调用逻辑
+
+### 1.2 文档解析逻辑
+- 可自动解析技能文档中的层级结构（标题、列表、选项）
+- 无需额外标注，直接提取核心调用信息
+
+### 1.3 异常处理
+- 调用失败时可自动重试，或提示手动选择技能选项
+
+## 二、技能文档适配规范
+
+### 2.1 调用标识要求
+所有技能文档头部添加claude code调用标识（可选但推荐）：
+```markdown
+【claude code调用标识：技能名称】
+```
+
+### 2.2 选项式设计要求
+技能文档采用选项式设计，便于AI调用：
+- 每个模块提供明确可选项
+- 保留自定义补充入口
+- 支持多选
+
+### 2.3 命名规范
+- 技能文档命名格式：技能名称.md（与原始技能列表一致）
+- 禁止使用特殊字符、空格
+
+## 三、调用示例
+
+```
+调用brainstorming技能，项目名称：个人备忘录APP
+```
+
+## 四、常见问题排查
+
+| 问题现象 | 可能原因 | 排查方法 |
+|---------|---------|---------|
+| 调用失败 | 技能名称不匹配 | 核对技能名称是否与原始列表一致 |
+| 选项缺失 | 选项式设计不完整 | 检查是否每个模块都有可选项 |
+
+---
+
+**版本**: v1.0  
+**适用场景**: claude code平台技能调用

package/skills/call-adaptation/trae-call-spec.md

@@ -0,0 +1,56 @@
+# trae调用机制说明及技能文档适配规范
+
+## 一、trae调用机制核心特性
+
+### 1.1 调用触发方式
+- 仅支持指定格式触发，需明确技能文档路径、调用参数
+- 不支持关键词触发、不支持模糊匹配
+
+### 1.2 文档解析逻辑
+- 需在技能文档头部添加固定格式的调用标识
+- 调用标识格式：【trae调用标识：技能名称+关联SDD】
+- 示例：【trae调用标识：brainstorming+Brain-SDD】
+
+### 1.3 异常处理
+- 调用失败后直接返回错误提示
+- 需手动核对技能文档格式、调用路径后重新触发
+
+## 二、技能文档适配规范
+
+### 2.1 调用标识要求
+所有技能文档头部必须添加trae调用标识：
+```markdown
+【trae调用标识：技能名称+关联SDD模板名称】
+```
+
+### 2.2 参数说明要求
+在文档末尾补充trae调用参数说明：
+```markdown
+## trae调用参数说明（仅trae触发时使用）
+- 调用路径：skills/对应分类目录/技能名称.md
+- 必传参数：项目名称、技能触发场景
+- 可选参数：自定义选项补充内容
+```
+
+### 2.3 命名规范
+- 技能文档命名格式：技能名称.md（与原始技能列表一致）
+- 禁止使用特殊字符、空格
+
+## 三、调用示例
+
+```
+trae调用 skills/requirement-analysis/brainstorming.md 项目名称=个人备忘录APP 触发场景=需求分析阶段
+```
+
+## 四、常见问题排查
+
+| 问题现象 | 可能原因 | 排查方法 |
+|---------|---------|---------|
+| 调用失败 | 文档路径错误 | 核对skills目录结构 |
+| 解析失败 | 缺少调用标识 | 检查文档头部是否有trae调用标识 |
+| 参数错误 | 必传参数缺失 | 确认必传参数是否完整 |
+
+---
+
+**版本**: v1.0  
+**适用场景**: trae平台技能调用