RAAGENT 文档中心

Appearance

CLI 参考 · AI Agent Skill ​

把 raagent 的两种能力都打包成了一个 skill，安装到你的 AI 编码代理（Claude Code、Codex、Cursor 等）里后，代理就能自主用 raagent 接入主机、管理 daemon，并用 market/agent/session/schedule/auth 操作平台，无需你手把手教它命令。

这是什么 ​

  • 覆盖主机接入 + 平台控制面：SKILL.md 有两个分支——「管理主机」（-key/-dir 配对、daemon 服务）和「控制面」（市场/智能体/会话/定时任务/登录）。
  • 含 session push：智能体生成文件后可用 raagent session push --file <路径> --text <文字> 主动把文件/消息推给会话，IM 会话（当前支持飞书）会把文件发到你的 IM 对话框（单文件 ≤30M）。
  • 一份渐进式披露的 skill：入口 SKILL.md 只放触发条件、前置检查和命令速查；主机细节在 references/host.md、完整命令参数在 references/commands.md、排障在 references/troubleshooting.md，代理按需加载，不占用上下文。
  • 纯 Markdown + 目录：零依赖，只依赖各工具对 SKILL.md 的原生支持。
  • 源文件：随仓库维护在 skills/raagent-cli/，这里提供打包下载。

下载 ​

自动安装

RAAGENT 的 CLI 用户在首次配对主机时，CLI 会自动下载并安装本 skill 到 ~/.claude/skills 与 ~/.agents/skills，无需手动操作。下面的手动方式用于其它场景或手动补齐。

⬇️ 下载 raagent-skill.zip

zip 解压后是一个 raagent-cli/ 文件夹，内含 SKILL.md 与 references/。

安装到哪个位置 ​

各主流代理工具的 skills 目录（官方文档确认）：

工具用户级（全局，所有项目）项目级（团队共享，提交进仓库）
Claude Code~/.claude/skills/.claude/skills/
Codex~/.agents/skills/$REPO_ROOT/.agents/skills/
Cursor~/.cursor/skills/ 或 ~/.agents/skills/.cursor/skills/ 或 .agents/skills/
Gemini CLI~/.gemini/skills/ 或 ~/.agents/skills/.gemini/skills/ 或 .agents/skills/
OpenCode~/.config/opencode/skills/（兼容 ~/.claude/skills、~/.agents/skills）.opencode/skills/（兼容同上）
Qoder~/.qoder/skills/.qoder/skills/

怎么选：

  • 只用 Claude Code → 放 ~/.claude/skills/。Cursor、OpenCode 也兼容读这个目录。
  • 跨工具通用 → 放 ~/.agents/skills/。这是 Codex / Cursor / Gemini CLI / OpenCode 的互操作标准目录（agentskills.io），放一次多工具生效。
  • 项目内团队共享 → 把 raagent-cli/ 提交到仓库的 .claude/skills/ 或 .agents/skills/，克隆即得。

安装步骤 ​

bash
# 下载 zip 后，按你用的工具选一个目录解压
unzip raagent-skill.zip -d ~/.claude/skills/     # Claude Code / Cursor / OpenCode
# 或
unzip raagent-skill.zip -d ~/.agents/skills/     # Codex / Cursor / Gemini CLI / OpenCode

# 验证
ls ~/.claude/skills/raagent-cli/SKILL.md

使用验证 ​

安装后新开会话，让代理做一件 raagent 能做的事，例如：

用 raagent 看看市场上有哪些代码审查相关的智能体

代理应通过 raagent market list --q 代码审查 之类的命令去查。也可以在工具内查看已加载的技能列表：Claude Code 的 / 命令面板、Codex 的 /skills、Cursor 的 Agent 面板。

提示

skill 只覆盖平台控制面命令（auth/market/agent/session/schedule）。主机配对（-key/-dir、daemon）请见 安装与配对。