● 社群
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。支援內嵌/本地技能,讓專案專屬的技能可存放於你的儲存庫中。
為什麼要用
核心特性
- 從 GitHub URL 或 git 儲存庫安裝(自動 URL 正規化)
- 支援 monorepo 子目錄與單一檔案
- 遞迴依賴解析
- craftdesk.json + lockfile 確保可重現性
- 多代理同步:Claude Code、Cursor、Windsurf、Continue.dev
- 校驗碼驗證確保完整性
- 支援內嵌(本地儲存庫)技能
- 支援打包多個 crafts 的集合
即時演示
實際使用效果
craftdesk-skill.replay
▶ 就緒
使用場景
實戰用法: craftdesk
何時使用: 團隊成員各自選用不同技能,你希望所有人使用相同的技能組合。
步驟
-
初始化專案清單
craftdesk init — 為此儲存庫建立 craftdesk.json。✓ 已複製
→ craftdesk.json 已建立
-
新增技能
craftdesk add planning-with-files agent-skill-tdd swing-skills — 鎖定版本。✓ 已複製
→ 清單已更新,lockfile 已寫入
-
團隊安裝
隊友在 clone 後執行 craftdesk install。✓ 已複製
→ 相同技能與版本部署至其機器上
結果: 如同 package.json 般可重現的 AI 技能環境。
注意事項
- 在內嵌技能中提交機密資訊 — 內嵌技能不應包含憑證——請將其保存在環境變數中
何時使用: 你在 Claude Code 安裝了某個技能,也希望在 Cursor 中使用它。
步驟
-
同步
craftdesk sync — 將所有已安裝的 crafts 提供給我所有的代理。✓ 已複製
→ 各代理的安裝路徑已填入
-
驗證
craftdesk verify — 有任何不一致嗎?✓ 已複製
→ 所有代理均顯示正常
結果: 無論開啟哪個代理,工具環境保持一致。
何時使用: 你為內部流程建立了一個技能,並希望它可透過 craftdesk add 安裝。
步驟
-
發布
craftdesk publish — 將此 craft 推送至我們的 registry。✓ 已複製
→ 已附帶版本號發布
結果: 像管理程式碼依賴一樣,建立一個有版本控制的內部 crafts 函式庫。
組合
與其他 MCP 搭配,撬動十倍槓桿
直接從 GitHub URL 安裝 crafts
craftdesk add https://github.com/org/skill✓ 已複製
放在 ./skills/ 下的內嵌技能會自動被偵測
在 ./skills/custom-review 建立一個內嵌技能,然後執行 craftdesk sync。✓ 已複製
成本與限制
運行它的成本
- API 配額
- None
- 每次呼叫 Token 數
- 極少 — CraftDesk 以 CLI 驅動
- 費用
- Free
- 提示
- 使用 lockfile — 可避免每次安裝時重新解析依賴
安全
權限、密鑰、影響範圍
憑證儲存: 若需私有發布,請將 registry 金鑰存放於環境變數中
資料出站: 僅傳送至你安裝來源的 git 主機及任何已設定的 registry
- CraftDesk 會從 URL 安裝任意程式碼——在新增來源不明的 crafts 前,請搭配 repo-forensics 進行審查。
故障排查
常見錯誤與修復
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 | 你想要自動產生技能,而非管理技能 | 解決的是不同問題 |