Orca Skills 注册表与 MCP 集成

安装方式

# 通用安装（带 --global 装到全局）
npx skills add https://github.com/stablyai/orca --skill orca-cli --global

默认的 Agent 初始化通常已装 orca-cli、computer-use、orchestration 三个。

可安装的技能清单

技能	用途
orca-cli	工作树、终端、文件、定时任务、内置浏览器
orchestration	多 Agent Runs、任务、监督式 worker、消息、决策门
computer-use	通过可访问性树驱动桌面应用
orca-linear	读写 Linear 工单
orca-emulator	控制 iOS 模拟器
orca-emulator-android	通过 adb 控制 Android 模拟器/设备
orca-per-workspace-env	每工作区环境配方（orca.yaml）

---

混合存根 vs 完整指南

npx skills add 之后 Agent 看到的是短存根，它指示 Agent：

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 --full
orca skills get orca-linear --json

命令参数都编译在二进制里，永远不会和应用版本漂移——这就是「混合存根」的意义。

---

保持技能更新

Orca 检测到较新的技能包时：

• 显示 update available 提示
• Update skills 对话框列出安装位置与跳过原因，然后无头运行 npx --yes skills update <names> --global -y
• 可以放后台：关掉对话框不取消更新，状态栏显示进度

手动等价命令：

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

无头环境（SSH、容器、CI、orca serve）没有设置界面，用本地 CLI 包装器：

orca skills install                          # 列出可装名称
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 的目标是主机上检测到的 Agent（外加共享的 .agents/skills 目录）；--agent <name> 可覆盖；检测不到 Agent 时 --agent 必填。

---

分享私有技能

• Skills → Share skills：把单个或一组技能发布为不公开、可撤销的链接（需 Orca 账号）
• 每个发布版本不可变；接收方审查版本后按 global / workspace 作用域安装到本机、配对运行时、WSL 或 SSH 主机
• 链接就像凭据：持有者无需登录即可查看和安装
• CLI 发布（需在设置里开启允许）：orca skills share --skill frontend --skill testing --bundle-name "Team Toolkit" --json；orca skills installed --json 先查安全选择器

---

落地练习：装一套技能

1. npx skills add https://github.com/stablyai/orca --skill orca-cli --global
2. 在 Agent 终端问它：你有哪些 Orca 技能？让它跑 orca skills list
3. 让 Agent 加载 orca skills get orca-cli，观察它如何用 --json
4. 在无头 shell 里跑 orca skills install --all --dry-run 看预演
5. 尝试分享一个技能链接，然后撤销它

怎么判断做对了？——你能解释「混合存根为什么不会过时」（参数在二进制里、指南从运行时取），并完成一次安装 + 让 Agent 使用。

卡住了怎么办？ 安装失败：确认网络能访问 GitHub 与 npx；Agent 不会用技能：确认它读的是 orca skills get 而非记忆里的旧命令。

---

小结

1. 技能 = Agent 的 Orca 能力清单，npx skills add 安装
2. 混合存根：短 SKILL.md + orca skills get 实时加载完整指南
3. 参数编译在二进制中，版本永不漂移
4. 无头环境用 orca skills install/update 包装器，支持 --dry-run 与 --agent
5. 私有技能可发布为可撤销链接，团队分发

下一节，四种运行方式。