/ 目錄 / 演練場 / craftdesk
● 社群 mensfeld ⚡ 即開即用

craftdesk

作者 mensfeld · mensfeld/craftdesk

Claude Code 技能的 npm — 安裝、版本鎖定、lockfile、跨 Claude Code / Cursor / Windsurf / Continue 同步,並支援校驗碼驗證與技能集合。

CraftDesk 是一個用於管理 AI 能力(技能、代理、指令、hooks、外掛)的 CLI 套件管理器。可從 GitHub URL 或 git 儲存庫安裝,支援 monorepo 子目錄與遞迴依賴解析。產生 craftdesk.json 與 lockfile 以確保環境可重現。可將已安裝的 crafts 同步至 Claude Code、Cursor、Windsurf 及 Continue.dev。支援內嵌/本地技能,讓專案專屬的技能可存放於你的儲存庫中。

為什麼要用

核心特性

即時演示

實際使用效果

craftdesk-skill.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "craftdesk-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/mensfeld/craftdesk",
        "~/.claude/skills/craftdesk"
      ],
      "_inferred": true
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "craftdesk-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/mensfeld/craftdesk",
        "~/.claude/skills/craftdesk"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "craftdesk-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/mensfeld/craftdesk",
        "~/.claude/skills/craftdesk"
      ],
      "_inferred": true
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "craftdesk-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/mensfeld/craftdesk",
        "~/.claude/skills/craftdesk"
      ],
      "_inferred": true
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "craftdesk-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/mensfeld/craftdesk",
        "~/.claude/skills/craftdesk"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "craftdesk-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/mensfeld/craftdesk",
          "~/.claude/skills/craftdesk"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add craftdesk-skill -- git clone https://github.com/mensfeld/craftdesk ~/.claude/skills/craftdesk

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: craftdesk

跨多位開發者管理團隊標準技能集

👤 負責統一 AI 工具的平台團隊 ⏱ ~30 min intermediate

何時使用: 團隊成員各自選用不同技能,你希望所有人使用相同的技能組合。

前置條件
  • 已安裝 CraftDesk — git clone https://github.com/mensfeld/craftdesk ~/.claude/skills/craftdesk 或 npm install -g craftdesk(依專案而定)
步驟
  1. 初始化專案清單
    craftdesk init — 為此儲存庫建立 craftdesk.json。✓ 已複製
    → craftdesk.json 已建立
  2. 新增技能
    craftdesk add planning-with-files agent-skill-tdd swing-skills — 鎖定版本。✓ 已複製
    → 清單已更新,lockfile 已寫入
  3. 團隊安裝
    隊友在 clone 後執行 craftdesk install。✓ 已複製
    → 相同技能與版本部署至其機器上

結果: 如同 package.json 般可重現的 AI 技能環境。

注意事項
  • 在內嵌技能中提交機密資訊 — 內嵌技能不應包含憑證——請將其保存在環境變數中
搭配使用: filesystem · github

在 Claude Code、Cursor 與 Windsurf 之間同步技能

👤 使用多種代理工具的開發者 ⏱ ~10 min beginner

何時使用: 你在 Claude Code 安裝了某個技能,也希望在 Cursor 中使用它。

步驟
  1. 同步
    craftdesk sync — 將所有已安裝的 crafts 提供給我所有的代理。✓ 已複製
    → 各代理的安裝路徑已填入
  2. 驗證
    craftdesk verify — 有任何不一致嗎?✓ 已複製
    → 所有代理均顯示正常

結果: 無論開啟哪個代理,工具環境保持一致。

將內部 craft 發布至私有 registry

👤 擁有專有技能的團隊 ⏱ ~20 min intermediate

何時使用: 你為內部流程建立了一個技能,並希望它可透過 craftdesk add 安裝。

步驟
  1. 發布
    craftdesk publish — 將此 craft 推送至我們的 registry。✓ 已複製
    → 已附帶版本號發布

結果: 像管理程式碼依賴一樣,建立一個有版本控制的內部 crafts 函式庫。

搭配使用: github

組合

與其他 MCP 搭配,撬動十倍槓桿

craftdesk-skill + github

直接從 GitHub URL 安裝 crafts

craftdesk add https://github.com/org/skill✓ 已複製
craftdesk-skill + filesystem

放在 ./skills/ 下的內嵌技能會自動被偵測

在 ./skills/custom-review 建立一個內嵌技能,然後執行 craftdesk sync。✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
craftdesk init none 新專案開始時 0
craftdesk install (reads craftdesk.json + lockfile) clone 或 pull 之後 0
craftdesk add name or URL 新增依賴時 0
craftdesk list none 查看已安裝項目清單 0
craftdesk sync none 安裝或更新後 0
craftdesk publish craft path 內部發布時 0
craftdesk verify none 進行完整性檢查時 0

成本與限制

運行它的成本

API 配額
None
每次呼叫 Token 數
極少 — CraftDesk 以 CLI 驅動
費用
Free
提示
使用 lockfile — 可避免每次安裝時重新解析依賴

安全

權限、密鑰、影響範圍

憑證儲存: 若需私有發布,請將 registry 金鑰存放於環境變數中
資料出站: 僅傳送至你安裝來源的 git 主機及任何已設定的 registry

故障排查

常見錯誤與修復

Install fails with checksum mismatch

上游內容已變更;請鎖定至特定 commit sha,或謹慎地重新對齊 lockfile

craftdesk sync misses one agent

確認該代理的路徑存在且具有寫入權限;請參閱 craftdesk config

替代方案

craftdesk 對比其他方案

替代方案何時用它替代權衡
Manual git clone into skills dir僅單機使用,無團隊協作需求無版本鎖定,無同步功能
gsd-skill-creator你想要自動產生技能,而非管理技能解決的是不同問題

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills