sdd-full 4.8.2 → 5.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (61) hide show
  1. package/bin.js +15 -20
  2. package/package.json +1 -1
  3. package/skills/README.md +15 -5
  4. package/skills/call-adaptation/SKILL.md +0 -23
  5. package/skills/call-adaptation/call-adaptation-guide.md +0 -136
  6. package/skills/call-adaptation/claude-code-call-spec.md +0 -50
  7. package/skills/call-adaptation/trae-call-spec.md +0 -56
  8. /package/skills/{design-planning/ai-coding-rules → ai-coding-rules}/SKILL.md +0 -0
  9. /package/skills/{quality-assurance/bdd-acceptance → bdd-acceptance}/SKILL.md +0 -0
  10. /package/skills/{requirement-analysis/brainstorming → brainstorming}/SKILL.md +0 -0
  11. /package/skills/{development-execution/bug-reproduction-confirm → bug-reproduction-confirm}/SKILL.md +0 -0
  12. /package/skills/{knowledge-precipitation/claudeception → claudeception}/SKILL.md +0 -0
  13. /package/skills/{requirement-analysis/competitive-brief → competitive-brief}/SKILL.md +0 -0
  14. /package/skills/{design-planning/design-to-code → design-to-code}/SKILL.md +0 -0
  15. /package/skills/{design-planning/enterprise-spec → enterprise-spec}/SKILL.md +0 -0
  16. /package/skills/{special-tools/env-check → env-check}/SKILL.md +0 -0
  17. /package/skills/{release-ops/finishing-a-development-branch → finishing-a-development-branch}/SKILL.md +0 -0
  18. /package/skills/{flutter/skills/flutter-add-integration-test → flutter-add-integration-test}/SKILL.md +0 -0
  19. /package/skills/{flutter/skills/flutter-add-widget-preview → flutter-add-widget-preview}/SKILL.md +0 -0
  20. /package/skills/{flutter/skills/flutter-add-widget-test → flutter-add-widget-test}/SKILL.md +0 -0
  21. /package/skills/{flutter/skills/flutter-apply-architecture-best-practices → flutter-apply-architecture-best-practices}/SKILL.md +0 -0
  22. /package/skills/{design-planning/flutter-av → flutter-av}/SKILL.md +0 -0
  23. /package/skills/{flutter/skills/flutter-build-responsive-layout → flutter-build-responsive-layout}/SKILL.md +0 -0
  24. /package/skills/{development-execution/flutter-errors → flutter-errors}/SKILL.md +0 -0
  25. /package/skills/{flutter/skills/flutter-fix-layout-issues → flutter-fix-layout-issues}/SKILL.md +0 -0
  26. /package/skills/{flutter/skills/flutter-implement-json-serialization → flutter-implement-json-serialization}/SKILL.md +0 -0
  27. /package/skills/{design-planning/flutter-map → flutter-map}/SKILL.md +0 -0
  28. /package/skills/{flutter/skills/flutter-setup-declarative-routing → flutter-setup-declarative-routing}/SKILL.md +0 -0
  29. /package/skills/{flutter/skills/flutter-setup-localization → flutter-setup-localization}/SKILL.md +0 -0
  30. /package/skills/{quality-assurance/flutter-test → flutter-test}/SKILL.md +0 -0
  31. /package/skills/{flutter/skills/flutter-use-http-package → flutter-use-http-package}/SKILL.md +0 -0
  32. /package/skills/{design-planning/function-sdd → function-sdd}/SKILL.md +0 -0
  33. /package/skills/{design-planning/global-overlay-stack-standard → global-overlay-stack-standard}/SKILL.md +0 -0
  34. /package/skills/{special-tools/ios-full-auto-debug → ios-full-auto-debug}/SKILL.md +0 -0
  35. /package/skills/{special-tools/ios-full-auto-debug → ios-full-auto-debug}/ios_full_auto_debug.sh +0 -0
  36. /package/skills/{requirement-analysis/market-research → market-research}/SKILL.md +0 -0
  37. /package/skills/{knowledge-precipitation/mempalace-auto-saver → mempalace-auto-saver}/SKILL.md +0 -0
  38. /package/skills/{development-execution/performance-optimize → performance-optimize}/SKILL.md +0 -0
  39. /package/skills/{requirement-analysis/prd-write → prd-write}/SKILL.md +0 -0
  40. /package/skills/{quality-assurance/quality-gate → quality-gate}/SKILL.md +0 -0
  41. /package/skills/{special-tools/receiving-code-review → receiving-code-review}/SKILL.md +0 -0
  42. /package/skills/{release-ops/release-flow → release-flow}/SKILL.md +0 -0
  43. /package/skills/{special-tools/requesting-code-review → requesting-code-review}/SKILL.md +0 -0
  44. /package/skills/{requirement-analysis/requirement-completion-officer → requirement-completion-officer}/SKILL.md +0 -0
  45. /package/skills/{requirement-analysis/sdd → sdd}/SKILL.md +0 -0
  46. /package/skills/{requirement-analysis/sdd → sdd}/mock_sdd.md +0 -0
  47. /package/skills/{development-execution/sdd-add → sdd-add}/SKILL.md +0 -0
  48. /package/skills/{design-planning/sdd-code → sdd-code}/SKILL.md +0 -0
  49. /package/skills/{design-planning/sdd-deploy → sdd-deploy}/SKILL.md +0 -0
  50. /package/skills/{requirement-analysis/sdd-full → sdd-full}/SKILL.md +0 -0
  51. /package/skills/{design-planning/sdd-ops → sdd-ops}/SKILL.md +0 -0
  52. /package/skills/{design-planning/sdd-test → sdd-test}/SKILL.md +0 -0
  53. /package/skills/{quality-assurance/security-audit → security-audit}/SKILL.md +0 -0
  54. /package/skills/{development-execution/systematic-debugging → systematic-debugging}/SKILL.md +0 -0
  55. /package/skills/{development-execution/test-driven-development → test-driven-development}/SKILL.md +0 -0
  56. /package/skills/{design-planning/ui-motion-interaction-standard → ui-motion-interaction-standard}/SKILL.md +0 -0
  57. /package/skills/{design-planning/ui-sdd → ui-sdd}/SKILL.md +0 -0
  58. /package/skills/{design-planning/ui-sdd-specialized → ui-sdd-specialized}/SKILL.md +0 -0
  59. /package/skills/{special-tools/using-superpowers → using-superpowers}/SKILL.md +0 -0
  60. /package/skills/{development-execution/verification-before-completion → verification-before-completion}/SKILL.md +0 -0
  61. /package/skills/{design-planning/writing-plans → writing-plans}/SKILL.md +0 -0
package/bin.js CHANGED
@@ -6,7 +6,7 @@ const fs = require('fs');
6
6
  const path = require('path');
7
7
 
8
8
  const SDD = {
9
- version: '4.8.2',
9
+ version: '5.0.0',
10
10
  name: 'sdd-full',
11
11
  description: '完整的软件设计开发技能包'
12
12
  };
@@ -95,22 +95,27 @@ function install(targetDir, environment) {
95
95
  installConfig = [
96
96
  { name: 'Claude Code', skillsPath: path.join(baseDir, '.claude', 'skills'), rulesPath: path.join(baseDir, '.claude', 'rules') }
97
97
  ];
98
+ } else if (environment === 'trae-cn') {
99
+ installConfig = [
100
+ { name: 'Trae-cn', skillsPath: path.join(baseDir, '.trae-cn', 'skills'), rulesPath: path.join(baseDir, '.trae-cn', 'rules') }
101
+ ];
98
102
  } else if (environment === 'all') {
99
103
  installConfig = [
100
104
  { name: 'Trae / Solo', skillsPath: path.join(baseDir, '.trae', 'skills'), rulesPath: path.join(baseDir, '.trae', 'rules') },
105
+ { name: 'Trae-cn', skillsPath: path.join(baseDir, '.trae-cn', 'skills'), rulesPath: path.join(baseDir, '.trae-cn', 'rules') },
101
106
  { name: 'Claude Code', skillsPath: path.join(baseDir, '.claude', 'skills'), rulesPath: path.join(baseDir, '.claude', 'rules') },
102
107
  { name: '通用 sdd-full', skillsPath: path.join(baseDir, '.sdd-full', 'skills'), rulesPath: path.join(baseDir, '.sdd-full', 'rules') }
103
108
  ];
104
109
  } else {
105
- // 默认:Trae / Solo
110
+ // 默认:Trae / Solo + Trae-cn
106
111
  installConfig = [
107
- { name: 'Trae / Solo', skillsPath: path.join(baseDir, '.trae', 'skills'), rulesPath: path.join(baseDir, '.trae', 'rules') }
112
+ { name: 'Trae / Solo', skillsPath: path.join(baseDir, '.trae', 'skills'), rulesPath: path.join(baseDir, '.trae', 'rules') },
113
+ { name: 'Trae-cn', skillsPath: path.join(baseDir, '.trae-cn', 'skills'), rulesPath: path.join(baseDir, '.trae-cn', 'rules') }
108
114
  ];
109
115
  }
110
116
 
111
117
  let totalSkillsCount = 0;
112
118
  let totalRulesCount = 0;
113
- let copyVersionFile = false;
114
119
 
115
120
  installConfig.forEach(config => {
116
121
  const skillsDestDir = config.skillsPath;
@@ -153,16 +158,6 @@ function install(targetDir, environment) {
153
158
  }
154
159
  });
155
160
  }
156
-
157
- // 复制版本文件
158
- const versionSourcePath = path.join(__dirname, 'skills', 'VERSION.md');
159
- const versionDestPath = path.join(skillsDestDir, 'VERSION.md');
160
- if (fs.existsSync(versionSourcePath)) {
161
- console.log(` 📋 复制版本文件`);
162
- fs.copyFileSync(versionSourcePath, versionDestPath);
163
- copyVersionFile = true;
164
- }
165
-
166
161
  totalSkillsCount += skillsCount;
167
162
  console.log(` ✅ ${skillsCount} 个技能`);
168
163
 
@@ -212,9 +207,6 @@ function install(targetDir, environment) {
212
207
  console.log(` - 版本: ${SDD.version}`);
213
208
  console.log(` - 技能: ${totalSkillsCount} 个`);
214
209
  console.log(` - 规则: ${totalRulesCount} 个文件`);
215
- if (copyVersionFile) {
216
- console.log(` - 版本信息: VERSION.md 已安装`);
217
- }
218
210
  console.log('========================================');
219
211
  console.log('\n现在您可以在以下环境中使用这些技能和规则:');
220
212
  installConfig.forEach(config => {
@@ -248,9 +240,10 @@ function main() {
248
240
  console.log(` 版本: ${SDD.version}`);
249
241
  console.log('========================================');
250
242
  console.log('\n用法:');
251
- console.log(' npx sdd-full - 安装到 Trae / Solo(默认)');
243
+ console.log(' npx sdd-full - 安装到 Trae / Solo + Trae-cn(默认)');
252
244
  console.log(' npx sdd-full cc - 安装到 Claude Code');
253
- console.log(' npx sdd-full all - 安装到所有环境');
245
+ console.log(' npx sdd-full trae-cn - 仅安装到 Trae-cn');
246
+ console.log(' npx sdd-full all - 安装到所有环境(Trae + Trae-cn + Claude Code)');
254
247
  console.log(' npx sdd-full --help - 显示帮助');
255
248
  console.log(' npx sdd-full --dir ./myproj - 安装到指定目录');
256
249
  console.log(' npx sdd-full --verbose - 显示详细调试信息');
@@ -276,10 +269,12 @@ function main() {
276
269
  let environment;
277
270
  if (args.indexOf('cc') !== -1) {
278
271
  environment = 'cc';
272
+ } else if (args.indexOf('trae-cn') !== -1) {
273
+ environment = 'trae-cn';
279
274
  } else if (args.indexOf('all') !== -1) {
280
275
  environment = 'all';
281
276
  } else {
282
- environment = 'trae'; // 默认
277
+ environment = 'trae'; // 默认:Trae / Solo + Trae-cn
283
278
  }
284
279
 
285
280
  install(targetDir, environment);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "sdd-full",
3
- "version": "4.8.2",
3
+ "version": "5.0.0",
4
4
  "description": "SDD Full - 完整的软件设计开发技能包",
5
5
  "main": "index.js",
6
6
  "bin": "./bin.js",
package/skills/README.md CHANGED
@@ -2,9 +2,9 @@
2
2
 
3
3
  # SDD Full 技能包
4
4
 
5
- **版本**: 4.8.2
5
+ **版本**: 5.0.0
6
6
  **发布日期**: 2026-05-09
7
- **更新时间**: 2026-05-09 09:52:00
7
+ **更新时间**: 2026-05-09 10:30:00
8
8
 
9
9
  ---
10
10
 
@@ -155,13 +155,16 @@ skills/
155
155
  ## 快速安装
156
156
 
157
157
  ```bash
158
- # 默认安装到Trae环境
158
+ # 默认安装到 Trae / Solo + Trae-cn
159
159
  npx sdd-full
160
160
 
161
- # 安装到Claude Code
161
+ # 安装到 Claude Code
162
162
  npx sdd-full cc
163
163
 
164
- # 安装到所有环境
164
+ # 仅安装到 Trae-cn
165
+ npx sdd-full trae-cn
166
+
167
+ # 安装到所有环境(Trae + Trae-cn + Claude Code)
165
168
  npx sdd-full all
166
169
 
167
170
  # 查看帮助
@@ -172,6 +175,13 @@ npx sdd-full --help
172
175
 
173
176
  ## 更新历史
174
177
 
178
+ ### v4.9.0 (2026-05-09)
179
+ - 默认安装新增 Trae-cn 支持,`npx sdd-full` 同时安装到 `.trae/` 和 `.trae-cn/`
180
+ - 新增 `npx sdd-full trae-cn` 单独安装到 Trae-cn 命令
181
+ - `npx sdd-full all` 新增 Trae-cn 支持(Trae + Trae-cn + Claude Code)
182
+ - 清理已删除的 VERSION.md 残留引用
183
+ - 更新技能列表
184
+
175
185
  ### v4.8.1 (2026-05-08)
176
186
  - 同步 VERSION.md 版本号,修复版本不一致问题
177
187
  - 合并 README.md 与 VERSION.md,统一版本信息入口
@@ -1,23 +0,0 @@
1
- 【claude code调用标识:call-adaptation】【trae调用标识:call-adaptation+调用机制适配】【流程场景:1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代、4.Bug处理、5.代码发布】
2
-
3
- ---
4
- name: call-adaptation
5
- description: 调用机制适配技能 - 处理Trae与Claude Code两种调用机制的差异,提供调用指南和规范说明
6
- ---
7
-
8
- # 调用机制适配
9
-
10
- ## 功能说明
11
- 本技能用于处理Trae与Claude Code两种调用机制的适配,提供:
12
- - Trae调用规范
13
- - Claude Code调用规范
14
- - 调用方式切换指南
15
-
16
- ## 核心文档
17
- - trae-call-spec.md - Trae调用规范
18
- - claude-code-call-spec.md - Claude Code调用规范
19
- - call-adaptation-guide.md - 调用适配指南
20
-
21
- ## 调用方式
22
- - **Claude Code**: 调用 call-adaptation
23
- - **Trae**: trae调用 call-adaptation
@@ -1,136 +0,0 @@
1
- # 两种调用机制切换指南及异常处理
2
-
3
- ## 一、切换逻辑
4
-
5
- ### 1.1 使用claude code调用
6
- - 直接通过关键词触发,无需额外操作
7
- - 示例:"调用brainstorming技能,项目名称:XX"
8
-
9
- ### 1.2 使用trae调用
10
-
11
- #### 方式1:完整路径调用(标准)
12
- - 需按固定格式输入调用指令,包含技能文档路径、必传参数、流程场景
13
- - 格式:trae调用 skills/对应分类目录/技能名称.md 参数1=值1 参数2=值2 流程场景=场景名称
14
- - 示例:trae调用 skills/requirement-analysis/brainstorming.md 项目名称=XX 触发场景=需求分析 流程场景=从零开始新项目
15
-
16
- #### 方式2:模板快捷调用(推荐)
17
- - 无需填写完整路径,系统自动匹配templates目录及流程适配逻辑
18
- - 格式:trae调用 模板名称 必传参数 流程场景=场景名称
19
- - 示例:trae调用 Brain-SDD 项目名称=个人备忘录APP 阶段=初期想法收集 流程场景=从零开始新项目
20
-
21
- #### 方式3:简称快捷调用(最快捷)
22
- - 使用预设的模板简称,输入更简洁
23
- - 格式:trae快捷 模板简称 必传参数 流程场景=场景名称
24
- - 示例:trae快捷 Brain 项目名称=个人备忘录APP 阶段=初期想法收集 流程场景=从零开始新项目
25
-
26
- ### 1.3 快捷指令映射表
27
-
28
- | 模板简称 | 完整模板名称 | 对应目录 |
29
- |---------|------------|---------|
30
- | Base | Base-SDD.md | skills/templates/ |
31
- | Brain | Brain-SDD.md | skills/templates/ |
32
- | Competitor | Competitor-SDD.md | skills/templates/ |
33
- | PRD | PRD-SDD.md | skills/templates/ |
34
- | UI | UI-SDD.md | skills/templates/ |
35
- | Code | Code-SDD.md | skills/templates/ |
36
- | API | API-SDD.md | skills/templates/ |
37
- | Env | Env-SDD.md | skills/templates/ |
38
- | Test | Test-SDD.md | skills/templates/ |
39
-
40
- ### 1.4 SDD全流程场景说明
41
-
42
- | 流程场景 | 场景编号 | 适用范围 | 核心技能 |
43
- |---------|---------|---------|---------|
44
- | 完整3阶段SDD流程 | 1 | 大型项目、完整迭代 | sdd, brainstorming, prd-write, ui-sdd, sdd-code, sdd-test |
45
- | 从零开始新项目 | 2 | 新项目启动 | brainstorming, market-research, competitive-brief, prd-write |
46
- | 小型功能迭代 | 3 | 功能新增/优化 | sdd-add, sdd-code, sdd-test |
47
- | Bug处理 | 4 | Bug修复 | systematic-debugging, sdd-add, sdd-test |
48
- | 代码发布 | 5 | 版本发布 | quality-gate, release-flow, finishing-a-development-branch |
49
-
50
- ### 1.5 按需加载优化逻辑
51
-
52
- 基于流程场景拆分技能/模板加载范围,确保加载体积≤30k:
53
-
54
- | 流程场景 | 加载范围 | 排除技能 |
55
- |---------|---------|---------|
56
- | Bug处理 | systematic-debugging, sdd-add, sdd-test | market-research, competitive-brief, ui-sdd |
57
- | 代码发布 | quality-gate, release-flow, security-audit | brainstorming, ui-sdd, market-research |
58
- | 小型功能迭代 | sdd-add, sdd-code, sdd-test | competitive-brief, market-research |
59
- | 从零开始新项目 | brainstorming, market-research, competitive-brief, prd-write | sdd-deploy, sdd-ops |
60
- | 完整3阶段SDD流程 | 全部技能 | 无 |
61
-
62
- ### 1.6 流程场景缓存策略
63
-
64
- - 高频流程(如小型功能迭代、Bug处理):首次加载后缓存,后续调用无需重复加载
65
- - 低频流程(如完整3阶段SDD流程):不缓存,每次调用重新加载
66
- - 缓存清理:定期清理过期缓存(建议每周一次)
67
-
68
- ## 二、异常处理方案
69
-
70
- ### 2.1 trae调用失败
71
- 优先核对以下4点:
72
- 1. 技能文档路径是否正确
73
- 2. 文档头部是否有trae调用标识
74
- 3. 必传参数是否完整
75
- 4. 流程场景参数是否正确
76
-
77
- 核对后重新触发调用,仍失败则检查缓存和加载配置。
78
-
79
- ### 2.2 claude code调用失败
80
- - 无需额外核对,直接重试或手动选择技能选项
81
- - 简单流程场景可使用原生触发(/命令)提升效率
82
-
83
- ### 2.3 两种机制均调用失败
84
- - 查看本指南及相关适配文档
85
- - 检查技能文档是否符合统一规范
86
- - 清除trae本地缓存后重试
87
-
88
- ### 2.4 流程场景适配失败
89
- - 检查流程场景参数是否在允许范围内(场景编号1-5)
90
- - 核对call-adaptation中的场景适配逻辑
91
- - 检查按需加载配置是否正确
92
-
93
- ## 三、技能文档规范检查清单
94
-
95
- | 检查项 | 说明 |
96
- |--------|------|
97
- | 双调用标识 | 文档头部是否包含【claude code调用标识】和【trae调用标识】 |
98
- | 流程场景标识 | 文档头部是否包含【流程场景:对应全流程场景(1-5)】 |
99
- | 命名规范 | 文件名是否与原始技能列表一致,无特殊字符 |
100
- | 选项式设计 | 是否每个模块都有可选项和自定义补充入口 |
101
- | 参数说明 | 是否包含trae调用参数说明(调用路径、必传/可选参数、流程场景参数) |
102
- | 路径匹配 | 调用路径是否与实际目录结构一致 |
103
- | 流程衔接 | 是否包含流程衔接说明(前后步骤关联) |
104
-
105
- ## 四、技能目录结构参考
106
-
107
- ```
108
- skills/
109
- ├─ requirement-analysis/ # 需求分析类(brainstorming, market-research, competitive-brief, prd-write, requirement-completion-officer, sdd, sdd-full, unified-flow)
110
- ├─ design-planning/ # 设计规划类(ui-sdd, sdd-code, sdd-test, sdd-deploy, sdd-ops, writing-plans)
111
- ├─ development-execution/ # 开发执行类(sdd-add, test-driven-development, systematic-debugging, verification-before-completion)
112
- ├─ quality-assurance/ # 质量保障类(quality-gate, security-audit)
113
- ├─ release-ops/ # 发布运维类(finishing-a-development-branch, release-flow)
114
- ├─ knowledge-precipitation/ # 知识沉淀类(claudeception, mempalace-auto-saver)
115
- ├─ special-tools/ # 专项工具类(using-superpowers, requesting-code-review, receiving-code-review)
116
- ├─ call-adaptation/ # 调用机制适配
117
- ├─ sdd-framework/ # SDD框架模板
118
- └─ templates/ # SDD模板
119
- ```
120
-
121
- ## 五、调用标识格式规范
122
-
123
- ### 5.1 统一标识格式
124
- ```
125
- 【claude code调用标识:技能/模板名称】【trae调用标识:技能/模板名称+关联项】【流程场景:对应全流程场景(1-5)】
126
- ```
127
-
128
- ### 5.2 示例
129
- ```
130
- 【claude code调用标识:Brain-SDD】【trae调用标识:Brain-SDD+头脑风暴】【流程场景:1.完整3阶段SDD流程、2.从零开始新项目】
131
- ```
132
-
133
- ---
134
-
135
- **版本**: v2.0
136
- **适用场景**: 两种调用机制切换与异常处理、SDD全流程适配
@@ -1,50 +0,0 @@
1
- # claude code调用机制说明及技能文档适配规范
2
-
3
- ## 一、claude code调用机制核心特性
4
-
5
- ### 1.1 调用触发方式
6
- - 支持关键词触发、主动调用两种方式
7
- - 可直接读取技能文档中的选项式内容,自动匹配调用逻辑
8
-
9
- ### 1.2 文档解析逻辑
10
- - 可自动解析技能文档中的层级结构(标题、列表、选项)
11
- - 无需额外标注,直接提取核心调用信息
12
-
13
- ### 1.3 异常处理
14
- - 调用失败时可自动重试,或提示手动选择技能选项
15
-
16
- ## 二、技能文档适配规范
17
-
18
- ### 2.1 调用标识要求
19
- 所有技能文档头部添加claude code调用标识(可选但推荐):
20
- ```markdown
21
- 【claude code调用标识:技能名称】
22
- ```
23
-
24
- ### 2.2 选项式设计要求
25
- 技能文档采用选项式设计,便于AI调用:
26
- - 每个模块提供明确可选项
27
- - 保留自定义补充入口
28
- - 支持多选
29
-
30
- ### 2.3 命名规范
31
- - 技能文档命名格式:技能名称.md(与原始技能列表一致)
32
- - 禁止使用特殊字符、空格
33
-
34
- ## 三、调用示例
35
-
36
- ```
37
- 调用brainstorming技能,项目名称:个人备忘录APP
38
- ```
39
-
40
- ## 四、常见问题排查
41
-
42
- | 问题现象 | 可能原因 | 排查方法 |
43
- |---------|---------|---------|
44
- | 调用失败 | 技能名称不匹配 | 核对技能名称是否与原始列表一致 |
45
- | 选项缺失 | 选项式设计不完整 | 检查是否每个模块都有可选项 |
46
-
47
- ---
48
-
49
- **版本**: v1.0
50
- **适用场景**: claude code平台技能调用
@@ -1,56 +0,0 @@
1
- # trae调用机制说明及技能文档适配规范
2
-
3
- ## 一、trae调用机制核心特性
4
-
5
- ### 1.1 调用触发方式
6
- - 仅支持指定格式触发,需明确技能文档路径、调用参数
7
- - 不支持关键词触发、不支持模糊匹配
8
-
9
- ### 1.2 文档解析逻辑
10
- - 需在技能文档头部添加固定格式的调用标识
11
- - 调用标识格式:【trae调用标识:技能名称+关联SDD】
12
- - 示例:【trae调用标识:brainstorming+Brain-SDD】
13
-
14
- ### 1.3 异常处理
15
- - 调用失败后直接返回错误提示
16
- - 需手动核对技能文档格式、调用路径后重新触发
17
-
18
- ## 二、技能文档适配规范
19
-
20
- ### 2.1 调用标识要求
21
- 所有技能文档头部必须添加trae调用标识:
22
- ```markdown
23
- 【trae调用标识:技能名称+关联SDD模板名称】
24
- ```
25
-
26
- ### 2.2 参数说明要求
27
- 在文档末尾补充trae调用参数说明:
28
- ```markdown
29
- ## trae调用参数说明(仅trae触发时使用)
30
- - 调用路径:skills/对应分类目录/技能名称.md
31
- - 必传参数:项目名称、技能触发场景
32
- - 可选参数:自定义选项补充内容
33
- ```
34
-
35
- ### 2.3 命名规范
36
- - 技能文档命名格式:技能名称.md(与原始技能列表一致)
37
- - 禁止使用特殊字符、空格
38
-
39
- ## 三、调用示例
40
-
41
- ```
42
- trae调用 skills/requirement-analysis/brainstorming.md 项目名称=个人备忘录APP 触发场景=需求分析阶段
43
- ```
44
-
45
- ## 四、常见问题排查
46
-
47
- | 问题现象 | 可能原因 | 排查方法 |
48
- |---------|---------|---------|
49
- | 调用失败 | 文档路径错误 | 核对skills目录结构 |
50
- | 解析失败 | 缺少调用标识 | 检查文档头部是否有trae调用标识 |
51
- | 参数错误 | 必传参数缺失 | 确认必传参数是否完整 |
52
-
53
- ---
54
-
55
- **版本**: v1.0
56
- **适用场景**: trae平台技能调用