Skill 生成器
描述
自動生成符合標準的 SKILL.md 和資料夾結構。
觸發條件
- •「新增 skill」「建立技能」「create skill」「SG」
標準格式規範
YAML Frontmatter(必要)
yaml
--- name: skill-name # kebab-case 必須(小寫 + 連字號) description: 描述 # 包含 WHAT + WHEN + Triggers category: core # core/workflow/meta/integration version: 1.0.0 # SemVer compatibility: # 支援的平台(可選) - claude-code - github-copilot - vscode allowed-tools: # 可使用的工具(可選) - read_file - write_file orchestrates: # 組合的其他 skills(workflow 用) - skill-a - skill-b ---
命名規則
| 規則 | 正確 ✅ | 錯誤 ❌ |
|---|---|---|
| kebab-case | code-reviewer | codeReviewer, CodeReviewer |
| 小寫 | git-precommit | Git-Precommit |
| 有意義 | test-generator | tg, testgen |
| 無底線 | memory-bank | memory_bank |
資料夾結構
code
.claude/skills/
└── skill-name/
├── SKILL.md # 主要技能定義(必要)
├── references/ # 詳細參考文檔(可選)
│ ├── examples.md
│ └── api.md
├── templates/ # 範本檔案(可選)
│ └── template.py
└── scripts/ # 輔助腳本(可選)
└── helper.ps1
生成流程
Step 1: 收集資訊
code
❓ Skill 名稱:[輸入名稱,會自動轉 kebab-case] ❓ 描述:[一句話描述 + 觸發詞] ❓ 類別:[core/workflow/meta/integration] ❓ 需要額外資料夾嗎?[references/templates/scripts]
Step 2: 驗證
- •✅ 名稱是 kebab-case
- •✅ 名稱不重複
- •✅ 描述包含觸發詞
- •✅ 類別有效
Step 3: 生成
code
📁 建立 .claude/skills/{name}/
📄 建立 .claude/skills/{name}/SKILL.md
📁 建立子資料夾(如需要)
📝 更新 AGENTS.md skills 清單
使用範例
code
「新增 skill: api-tester」 「SG 建立 docker 管理技能」 「create skill for database migrations」
輸出範本
當你說「新增 skill: example-skill」,我會生成:
markdown
--- name: example-skill description: [描述]. Triggers: [觸發詞列表]. category: core version: 1.0.0 compatibility: - claude-code - github-copilot - vscode --- # [Skill 名稱] ## 描述 [詳細描述] ## 觸發條件 - 「[觸發詞 1]」「[觸發詞 2]」 ## 執行流程 [流程圖或步驟] ## 參數 | 參數 | 說明 | 預設 | |------|------|------| | `--option` | 說明 | false | ## 使用範例
[範例 1] [範例 2]
code
## 輸出格式
[預期輸出格式]
code
Token 預算指南
| 項目 | 建議 | 上限 |
|---|---|---|
| SKILL.md 總行數 | < 300 行 | 500 行 |
| SKILL.md Token | < 3000 | 5000 |
| 單個區塊 | < 50 行 | 100 行 |
如果內容過長:
- •拆分到
references/子資料夾 - •使用連結引用
- •精簡主要邏輯