rolecraft 是做什麼的？
只需一個指令，即可在 87 個 AI 代理（27 個已驗證）上安裝與管理技能。零依賴，無需註冊表。
使用時機
- 安裝技能 — 從本機資料夾、GitHub 儲存庫、GitLab 專案或 SSH Git URL 安裝
- 管理技能 — 列出、更新、移除及驗證已安裝的技能
- CI/CD 管線 — 基於鎖定檔的可重複安裝，使用
rolecraft ci - 故障排除 — 使用
rolecraft doctor診斷代理偵測、鎖定檔及 Node.js 問題 - 團隊入職 — 單一指令即可批量安裝
- 跨代理設定 — 同時安裝相同技能到多個代理
快速入門
# 無需安裝即可試用
npx rolecraft --help
# 建立技能
npx rolecraft init my-skill
# 從任何來源安裝
npx rolecraft install ./my-skill
npx rolecraft install user/repo
npx rolecraft install https://gitlab.com/org/project
npx rolecraft install [email protected]:user/repo.git
# 安裝到特定代理
npx rolecraft install user/repo --cursor --devin
# 檢查更新
npx rolecraft check
# 執行系統健康檢查
npx rolecraft doctor
# 列出已安裝的技能
npx rolecraft list
# 在 SKILL.md 與 .mdc 之間轉換格式
npx rolecraft convert ./my-skill
安裝命令
| 命令 | 用途 |
|---|---|
rolecraft install <source> | 安裝技能（本機、GitHub、GitLab、SSH） |
rolecraft init [name] | 建立新的 SKILL.md 腳手架（--template、--list） |
rolecraft list | 顯示已安裝的技能 |
rolecraft check | 檢查是否有可用更新 |
rolecraft remove <slug> | 解除安裝技能 |
rolecraft update <slug> | 重新安裝到最新版本 |
rolecraft rollback <slug> | 從備份還原至前一個版本 |
rolecraft bundle <sources> | 從檔案或內嵌內容一次安裝多個技能 |
rolecraft ci | 從鎖定檔重新安裝（CI 模式） |
rolecraft verify | 透過內容雜湊檢查技能完整性 |
rolecraft watch [<slug>] | 監視技能變更並自動同步 |
rolecraft search <query> | 在 GitHub 上搜尋技能 |
rolecraft doctor | 執行系統健康檢查 |
rolecraft agents-xml [--write] | 為 AGENTS.md 產生技能 XML |
rolecraft use <source> | 預覽而無需安裝 |
| `rolecraft completions bash | zsh |
rolecraft convert <source> | 在 SKILL.md 與 .mdc 格式之間轉換 |
rolecraft test <skill-path> | 使用內建斷言測試技能品質 |
常用標誌
| 標誌 | 用途 |
|---|---|
--cursor、--devin、--claude、--codex | 指定目標代理 |
--all | 安裝到所有支援的代理 |
--yes / -y | 非互動模式（CI/CD） |
--dry-run | 預覽而不實際進行變更 |
--symlink | 使用符號連結而非複製 |
--global / --project | 範圍選擇 |
支援的代理（共 87 個 · 27 個已驗證）
opencode、claude-code、cursor、windsurf、devin、codex、copilot、aider、cline、gemini-cli、cody、continue、warp、codeium、fabric、goose、tabnine、supermaven、pr-pilot、loom、roo、trae、hermes、kiro、augment、kilo、openhands、junie、factory、command-code、cortex、mistral-vibe、qwen-code、openclaw、codebuddy、mux、pi、omp (oh-my-pi)、autohand-code、rovo-dev、firebender、ibm-bob、aider-desk，以及另外 45 個。
範例
從 GitHub 安裝
rolecraft install vercel-labs/agent-skills --skill frontend-design
安裝到多個代理
rolecraft install ./my-team-rules --cursor --devin --copilot --all
CI 管線安裝
rolecraft ci --yes
建立並安裝自己的技能
rolecraft init my-skill
rolecraft install ./my-skill --all