rolecraft 是做什么的？
通过一条命令在 87 个代理（27 个已验证）之间安装和管理 AI 代理技能。零依赖。无需注册中心。
使用场景
- 安装技能 — 从本地文件夹、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