文档 / CLI / Orca 技能注册表与 MCP

Orca 提供 技能，智能体可将其安装到各自的技能目录中。公共安装包是 混合发现存根：简短的 SKILL.md 文件，用于告诉智能体 何时 启用 Orca，以及如何从正在运行的 CLI 加载完整指南。命令标志位于二进制文件中，因此不会与应用版本发生偏差。

可安装的 Orca 技能¶

使用 npx skills add 配合公共 Orca 仓库和技能名称。默认智能体配置通常会安装 orca-cli、computer-use 和 orchestration。

混合存根与实时指南¶

运行 npx skills add 后，智能体会看到一个简短存根，其中说明：

1. 解析本次会话的 CLI 可执行文件（ORCA_CLI_COMMAND、orca-dev、Linux 上的 orca-ide，否则为 orca）。
2. 加载完整指南：orca skills get <topic>（或使用 --full 获取长指南）。
3. 优先使用 --json，不要凭记忆臆造标志。

orca skills list
orca skills get orca-cli
orca skills get orchestration --references
orca skills get orchestration --reference recovery-and-cleanup
orca skills get orchestration --full
orca skills get orca-linear --json

指南的操作门控会命名条件引用。--reference <name> 只单独打印其中一个，因此智能体只需获取核心内容和该文档，而不是整个包；--references 会列出这些名称。名称可以是裸名称（recovery-and-cleanup），也可以按指南中书写的方式拼写（references/recovery-and-cleanup.md）。--full 仍会打印核心内容以及所有引用。

当智能体需要用于自动化的确定性输出时，添加 --json。skills show 是 skills get 的别名。

保持技能更新¶

当 Orca 发布了比全局已安装版本更新的技能包时，应用可以：

• 显示 有可用更新 提示（当某个更新器无法安全重写的副本已过时时，显示 需要关注）。
• 打开 更新技能 —— 列出安装位置和跳过原因，然后无头运行 npx --yes skills update <names> --global -y（不使用嵌入式终端）。
• 让运行保持在 后台：关闭对话框不会取消它。状态栏片段会显示进度（运行时显示加载指示器，短暂显示成功对勾，失败状态会持续显示直到你处理）。点击该片段可重新打开对话框。
• 在 设置 → 智能体 中显示已安装技能的更新状态（全局安装栏），当某一行需要审查时包括 详情。

手动等效操作（桌面设置中仍显示相同的 npx 形式）：

npx skills update orca-cli orchestration computer-use --global

在无设置 UI 的无头主机（SSH、容器、CI、orca serve）上，使用本地 CLI 封装器——它们会解析相同的 npx 命令，添加非交互式标志，并且 不 需要正在运行的 Orca 运行时：

orca skills install                                      # list installable names
orca skills install --skill orca-cli --skill orchestration
orca skills install --skill orca-cli --agent claude-code,codex
orca skills install --all --dry-run
orca skills update --all
orca skills update --skill orca-cli --dry-run

• 默认范围是 全局（--global）；仅针对当前项目时传入 --local。
• install 的目标是 Orca 在主机上检测到的智能体（外加共享的 .agents/skills 目录）。使用 --agent <name>[,<name>…] 或 --agent universal 进行覆盖；如果未检测到智能体，则必须提供 --agent。
• update 只会刷新已安装的技能。
• --dry-run 会打印解析后的命令；--json 仅与列表 / --dry-run 一起有效。

当 Orca 提供应用内更新器时，优先使用它，以便应用扫描过的相同全局安装位置会被重写。标记为 已跳过 的行会解释为什么该技能无法自动更新（例如缺少源注册）——修复安装位置，然后重新检查。

从技能页面安装和删除¶

当应用内安装要求选择工作区目标时，可按工作区名称或类型（工作树 / 文件夹）搜索选择器。智能体选择器会将 Orca 始终包含的目录与你可选择的其他智能体目录分开，因此你可以在继续之前查看确切的安装目标。

要删除已扫描的技能，请打开其操作菜单并选择 删除…。对于多个技能，请打开页面的 更多操作 菜单，选择 删除技能…，然后选择符合条件的结果。Orca 会在你确认之前解释为什么某个副本无法删除——例如，因为它已捆绑、由插件管理、只读，或位于可删除技能文件夹之外。这与 管理安装 不同，后者管理从共享链接安装的副本。

在主机之间共享私有技能¶

打开 技能 → 共享技能，可通过一个未列出且可撤销的链接发布一个技能或一个捆绑包。发布需要你的 Orca 账户。发布前，请检查所包含的文件、脚本、可执行文件、摘要以及可选的发布说明；每个已发布版本都是不可变的，因此后续的本地编辑不会悄悄更改接收者安装的内容。

任何拥有有效链接的人都可以无需登录即可查看并安装共享技能，因此请像对待凭据一样对待该链接。接收者会查看确切版本，选择其全部技能或其中一部分，然后在本机、配对的 Orca 运行时、WSL 或 SSH 主机上选择全局或工作区范围。已修改的现有技能默认为 保留本地。使用 技能 → 管理安装 可更新、回滚或删除 Orca 安装的副本，使用 设置 → 共享技能 可复制或撤销你的有效链接。撤销链接会阻止后续访问，但不会删除已安装的副本。

在你启用独立的、默认关闭的 设置 → 共享技能 → 允许代理和 Orca CLI 发布技能链接 权限后，代理可以从 CLI 发布明确命名的集合：

orca skills installed --json
orca skills share --skill frontend --skill testing --bundle-name "Team Toolkit" --json

skills installed 返回安全的选择器，不会暴露本地路径。skills share 接受精确的发现 ID 或无歧义的名称；它不接受任意路径或 --all。

orca-cli¶

npx skills add https://github.com/stablyai/orca --skill orca-cli --global

安装后，使用 orca skills get orca-cli 加载版本匹配的命令指南。参见 Orca CLI。

orchestration¶

npx skills add https://github.com/stablyai/orca --skill orchestration --global

当代理需要通过 Runs、任务、受监督的工作者和决策门来协调其他代理时，请使用此技能。参见 编排。在更改编排状态之前，始终加载 orca skills get orchestration --full —— 旧版 orchestration run 命令已弃用。

computer-use¶

npx skills add https://github.com/stablyai/orca --skill computer-use --global

当代理需要检查和操作本地桌面应用窗口时，请使用此技能。参见 计算机使用。

orca-linear¶

npx skills add https://github.com/stablyai/orca --skill orca-linear --global

代理在更改工单之前应加载 orca skills get orca-linear。涵盖 issue --full、save-issue、list-issues、关系、完成附加+评论流程以及不可信工单规则。现有的 linear-tickets 安装仍可解析。参见 CLI 参考 → Linear。

orca-emulator¶

npx skills add https://github.com/stablyai/orca --skill orca-emulator --global

当代理应通过 orca emulator 命令从 Orca 内部控制 iOS 模拟器时，请使用此技能。

orca-emulator-android¶

npx skills add https://github.com/stablyai/orca --skill orca-emulator-android --global

用于通过 adb 连接的 Android AVD/设备：列出/启动、点击/滑动/输入、硬件按钮、安装/启动、权限、可访问性树、logcat。使用 orca skills get orca-emulator-android 加载详细信息。

orca-per-workspace-env¶

npx skills add https://github.com/stablyai/orca --skill orca-per-workspace-env --global

在 orca.yaml 中设置或调试按工作区划分的环境配方时使用。参见 运行 Orca 的方式。

发现源¶

Orca 的技能 UI 会扫描 Claude、Codex、Agent Skills 和 OMP（~/.omp/agent/skills）的已安装技能主目录，因此放置在那里的技能会显示出来，无需手动符号链接。

添加你自己的技能¶

任何包含 skills/<name>/SKILL.md 文件的仓库都可以通过 npx skills add 安装。将你的代理指向内部仓库，以赋予其公司特定的能力。

MCP 服务器¶

模型上下文协议（MCP）服务器会将外部工具暴露给兼容的代理。在 设置 → 集成 → MCP 下注册 MCP 端点；这些工具会出现在支持 MCP 的代理 CLI 中。