Skill Marketplace Integration
在執行任務前，自動從 38,000+ 技能市集中找到最適合的工具。
🎯 執行時機
自動觸發條件：
- 用戶要求執行複雜任務（如測試、文檔生成、部署）
- 需要專業領域知識（DevOps、AI/ML、Security）
- 本地 skills 無法滿足需求
- 用戶明確提到「找工具」、「搜尋 skill」、「market」
不觸發條件：
- 簡單的檔案讀寫操作
- 已有適合的本地 skill
- 用戶要求不使用外部工具
📋 執行流程
Phase 1: 任務分析
1. 解析用戶任務需求
2. 提取關鍵字（如: testing, docker, documentation）
3. 判斷任務複雜度和專業性
4. 決定是否需要搜尋市集Phase 2: 市集搜尋
1. 使用 WebSearch 在 skillsmp.com 搜尋相關 skills
2. 使用 WebFetch 讀取搜尋結果頁面
3. 解析 skill 列表（名稱、描述、星數、分類）
4. 依相關性和品質排序Phase 3: 評估與選擇
評分標準：
- 關鍵字匹配度 (40%)
- GitHub stars/下載次數 (25%)
- 更新時間 (15%)
- 描述完整度 (10%)
- 社群評價 (10%)
選擇：取分數最高的 1-3 個 skillsPhase 4: 安裝與使用
1. 下載 SKILL.md 到 .claude/skills/marketplace-temp/
2. 驗證 YAML frontmatter 格式
3. 檢查 allowed-tools 安全性
4. 詢問用戶確認安裝（可選）
5. 使用 Skill 工具執行新安裝的 skillPhase 5: 清理（可選）
- 任務完成後詢問是否保留 skill
- 若否，刪除臨時安裝的 skill
- 記錄使用統計供未來參考🔍 搜尋策略
關鍵字映射表
| 任務類型 | 搜尋關鍵字 | 推薦分類 |
|---|---|---|
| 測試生成 | testing, jest, playwright | Testing & Security |
| API 文檔 | documentation, api, openapi | Documentation |
| Docker 部署 | docker, container, deploy | DevOps |
| 資料處理 | data, csv, json, transform | Data & AI |
| 代碼審查 | review, lint, quality | Development |
| 安全掃描 | security, vulnerability, audit | Testing & Security |
| CI/CD | github-actions, ci, pipeline | DevOps |
| 資料庫 | database, sql, migration | Databases |
高級搜尋範例
情境 1: 用戶要求「幫我生成 API 測試」
搜尋: 'api testing skill site:skillsmp.com';
過濾: ((category = Testing), stars > 100);
結果: (api - test - generator, postman - converter, openapi - test);
選擇: api - test - generator(最高分);情境 2: 用戶要求「自動化 Docker 部署」
搜尋: 'docker deployment automation site:skillsmp.com';
過濾: ((category = DevOps), updated > 2024);
結果: (docker - compose - gen, k8s - deployer, vercel - docker);
選擇: docker - compose - gen(最相關);🛡️ 安全檢查
安裝前必檢：
- SKILL.md 有正確的 YAML frontmatter
- allowed-tools 不包含危險工具（如
Bash(rm -rf)） - 來源為 skillsmp.com 官方或信任的 GitHub repo
- 沒有可疑的 script 或外部連結
- 描述清楚，沒有混淆行為
危險警告標誌：
- 要求存取敏感環境變數
- 修改系統檔案
- 建立網路連線到未知伺服器
- 執行未加密的 shell 指令
📊 使用範例
範例 1: 自動尋找測試工具
用戶輸入：
"我需要為這個 API 自動生成測試案例"
Agent 流程：
1. [skill-marketplace] 分析任務: API testing
2. [skill-marketplace] 搜尋 skillsmp.com: "api testing generator"
3. [skill-marketplace] 找到 3 個相關 skills:
- api-test-generator (⭐ 245)
- rest-api-tester (⭐ 189)
- graphql-test-gen (⭐ 156)
4. [skill-marketplace] 選擇: api-test-generator
5. [skill-marketplace] 下載並安裝到 .claude/skills/marketplace-temp/
6. [Skill] 執行 api-test-generator
7. [api-test-generator] 生成測試案例完成
8. [skill-marketplace] 詢問是否保留此 skill？範例 2: DevOps 自動化
用戶輸入：
"幫我設定 GitHub Actions 自動部署到 Vercel"
Agent 流程：
1. [skill-marketplace] 關鍵字: github-actions, vercel, deploy
2. [skill-marketplace] 搜尋市集 DevOps 分類
3. [skill-marketplace] 找到: vercel-ci-setup (⭐ 312)
4. [skill-marketplace] 安裝並執行
5. [vercel-ci-setup] 生成 .github/workflows/deploy.yml
6. [vercel-ci-setup] 配置 Vercel secrets
7. 完成自動化設定🎛️ 配置選項
可在 .claude/settings.json 中配置行為：
{
"skills": {
"marketplace": {
"enabled": true,
"auto_install": false, // 是否自動安裝（false=詢問用戶）
"cache_duration": "24h", // 搜尋結果快取時間
"max_results": 5, // 最多顯示幾個結果
"min_stars": 50, // 最低星數要求
"trusted_sources": [
// 信任的來源
"github.com/anthropics",
"github.com/openai"
],
"cleanup_after_use": true // 使用後自動清理臨時 skills
}
}
}🔄 與現有 Skills 整合
優先級順序：
1. read-before-edit (最高優先級，永遠先執行)
2. skill-marketplace (任務開始前搜尋工具)
3. 本地專案 skills (code-validator, type-checker, etc.)
4. 市集臨時 skills (下載後使用)
5. pre-commit-validator (最後驗證)決策樹：
任務開始
│
├─ 是否為代碼修改？
│ └─ YES → read-before-edit
│
├─ 本地 skills 是否適用？
│ ├─ YES → 使用本地 skill
│ └─ NO → skill-marketplace 搜尋市集
│
├─ 執行主要任務
│
└─ 是否要 commit？
└─ YES → pre-commit-validator📈 效能優化
快取策略：
- 搜尋結果快取 24 小時
- 常用 skills 永久保留（如使用次數 >3）
- 市集 API 請求限制：10 次/分鐘
載入優化：
- 並行搜尋多個關鍵字
- 預先載入熱門 skills 的 metadata
- 使用 HEAD 請求驗證檔案存在性
🧪 測試驗證
單元測試：
# 測試搜尋功能
node .claude/skills/skill-marketplace/search-marketplace.cjs "docker deployment"
# 測試安裝流程 (模擬)
node .claude/skills/skill-marketplace/install-skill.cjs --help
# 搜尋測試相關 skills
node .claude/skills/skill-marketplace/search-marketplace.cjs "testing"整合測試：
場景 1: 搜尋 → 安裝 → 使用 → 清理
場景 2: 本地 skill 優先於市集
場景 3: 安全檢查阻止惡意 skill
場景 4: 離線模式降級處理🚨 錯誤處理
常見錯誤與解決：
| 錯誤 | 原因 | 解決方案 |
|---|---|---|
| 搜尋失敗 | 網路問題 | 使用本地快取或本地 skills |
| 下載失敗 | GitHub API 限制 | 等待 1 分鐘後重試 |
| 格式錯誤 | SKILL.md 格式不正確 | 跳過此 skill，選擇次優 |
| 權限不足 | allowed-tools 超出範圍 | 詢問用戶是否信任 |
| 執行失敗 | Skill 代碼有 bug | 回退使用基本工具 |
📚 相關資源
- Skills Marketplace: https://skillsmp.com/
- SKILL.md 規範: https://docs.anthropic.com/claude-code/skills
- GitHub Discussions: https://github.com/anthropics/claude-code/discussions
- 本地 Skills 文檔:
.claude/skills/README.md
✅ 驗收標準
- 能成功搜尋 skillsmp.com
- 能解析搜尋結果並排序
- 能下載並安裝 SKILL.md
- 能驗證安全性
- 能執行新安裝的 skill
- 能清理臨時檔案
- 有完整的錯誤處理
- 與現有 skills 無衝突
此 Skill 讓 Agent 具備自我學習能力，能根據任務自動尋找最佳工具！ 🚀