DevAgent skills 注册表与 MCP

用 npx skills add 安装 DevAgent agent skill。混合 stub 保持精简；devcore skills get 提供与版本匹配的指南。DevAgent 可以在后台更新 skill。

DevAgent 提供 skill，agent 可将其安装到各自的 skill 目录中。公开的安装包是混合发现 stub：即简短的 SKILL.md 文件，用来告诉 agent 何时 该调用 DevAgent，以及如何从正在运行的 CLI 加载完整指南。命令 flag 存在于二进制文件中，因此不会与应用版本发生偏离。

可安装的 DevAgent skill

使用 npx skills add 加上公开的 DevAgent repo 和 skill 名称。默认 agent 安装通常会装上 orca-cli、computer-use 和 orchestration。

Skill

Install

Use it for

orca-cli

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

worktree、终端、文件、automation、内嵌浏览器。

orchestration

npx skills add https://github.com/Clouditera/devagent-skills --skill orchestration --global

多 agent Run、task、受监督的 worker、消息、gate。

computer-use

npx skills add https://github.com/Clouditera/devagent-skills --skill computer-use --global

通过 accessibility 树和安全 UI 操作驱动桌面应用。

orca-linear

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

通过 devcore linear 读写 Linear ticket。

orca-emulator

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

iOS Simulator 控制。

orca-emulator-android

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

通过 adb 控制 Android emulator/设备。

orca-per-workspace-env

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

按 workspace 划分的环境配方（orca.yaml）。

混合 stub 与实时指南对比

在 npx skills add 之后，agent 会看到一个简短的 stub，它说明：

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

devcore skills list
devcore skills get orca-cli
devcore skills get orchestration --full
devcore skills get orca-linear --json

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

保持 skill 为最新

当 DevAgent 提供的 skill 包比全局安装的版本更新时，应用可以：

• 显示一个 update available 提示（当某处副本已过期而更新器无法安全重写时，则显示 Needs attention）。
• 打开 Update skills —— 展示各安装位置及跳过原因的列表，然后无头地运行 npx --yes skills update <names> --global -y（不使用内嵌终端）。
• 让该运行保持在后台：关闭对话框不会取消它。状态栏中的一个片段显示进度（运行时为旋转图标，成功时短暂显示对勾，失败则持续显示直到你处理）。点击该片段可重新打开对话框。
• 在 设置 → 智能体 上呈现已安装 skill 的新鲜度（全局安装栏），当某行需要审查时还包含 Details。

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

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

在没有 设置 UI 的无头主机（SSH、容器、CI、devcore serve）上，使用本地 CLI 包装器——它们会解析出相同的 npx 命令、加上非交互式 flag，且不需要正在运行的 DevAgent 运行时：

devcore skills install                                      # 列出可安装的名称
devcore skills install --skill orca-cli --skill orchestration
devcore skills install --skill orca-cli --agent claude-code,codex
devcore skills install --all --dry-run
devcore skills update --all
devcore skills update --skill orca-cli --dry-run

• 默认作用范围是全局（--global）；传入 --local 仅针对当前项目。
• install 面向 DevAgent 在主机上检测到的 agent（外加共享的 .agents/skills 目录）。使用 --agent <name>[,<name>…] 或 --agent universal 来覆盖；如果未检测到任何 agent，则 --agent 是必需的。
• update 只刷新已安装的 skill。
• --dry-run 打印解析出的命令；--json 仅在列出 / --dry-run 时有效。

当 DevAgent 提供应用内更新器时优先使用它，这样应用扫描过的相同全局安装位置就会被重写。标记为 Skipped 的行会解释为什么该 skill 无法自动更新（例如缺少源注册）——请修正该安装位置，然后重新检查。

orca-cli

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

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

orchestration

npx skills add https://github.com/Clouditera/devagent-skills --skill orchestration --global

当某个 agent 需要通过 Run、task、受监督的 worker 和决策门来协调其他 agent 时使用它。参见 Orchestration。在变更 orchestration 状态前始终先加载 devcore skills get orchestration --full——旧的 orchestration run 命令已退役。

computer-use

npx skills add https://github.com/Clouditera/devagent-skills --skill computer-use --global

当某个 agent 需要检查和操作本地桌面应用窗口时使用它。参见 Computer use。

orca-linear

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

agent 在变更 ticket 前应加载 devcore skills get orca-linear。它涵盖 issue --full、save-issue、list-issues、relation、完成时的 attach+comment 流程，以及不可信 ticket 规则。已有的 linear-tickets 安装仍可解析。参见 CLI reference → Linear。

orca-emulator

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

当某个 agent 需要从 DevAgent 内部通过 devcore emulator 命令控制 iOS Simulator 时使用它。

orca-emulator-android

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

用于通过 adb 连接的 Android AVD/设备：列出/启动、点击/滑动/输入、硬件按键、安装/启动、权限、accessibility 树、logcat。用 devcore skills get orca-emulator-android 加载详情。

orca-per-workspace-env

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

当在 orca.yaml 中设置或调试按 workspace 划分的环境配方时使用它。参见 Ways to run DevAgent。

发现来源

DevAgent 的 skill UI 会扫描 Claude、Codex、Agent Skills 以及 OMP（~/.omp/agent/skills）的已安装 skill 主目录，因此放置在那里的 skill 无需手动 symlink 就会显示出来。

添加你自己的 skill

任何带有 skills/<name>/SKILL.md 文件的 repo 都可以通过 npx skills add 安装。让你的 agent 指向内部 repo，从而赋予它公司专属的能力。

MCP servers

Model Context Protocol (MCP) 服务器向兼容的 agent 暴露外部工具。在 设置 → 集成 → MCP 下注册 MCP 端点；这些工具会出现在支持 MCP 的 agent CLI 内部。