Skills、MCP 与工具

Skills：把经验变成可复用的资产

一个 skill 是一份命名的、可复用的说明，例如测试如何运行、部署流程是什么、迁移脚本应当怎么写。任务需要时智能体会自行加载它。借助 skill，那些积累不易的具体做法不再只存在于你的记忆和历史指令中。

在输入区输入 / 会列出当前会话可用的内容：你的 skills 与智能体的内置命令并列显示。安装时可以选择全局作用域（各处都可用）或工作区作用域，后者保存在 <工作区>/.mirasim 下，与项目放在一起，因此可以像其他代码一样比对、评审和版本管理。

mirasim ui-cli --port 4970 skill list                       # workspace + global
mirasim ui-cli --port 4970 skill install --source https://github.com/o/r --scope global
mirasim ui-cli --port 4970 skill create --name run-our-tests --scope workspace
mirasim ui-cli --port 4970 skill update --name run-our-tests
mirasim ui-cli --port 4970 skill remove --name run-our-tests

1. 写给一位有能力但不了解项目的读者

   假定读者熟悉软件开发，但不了解你的项目。写清命令、执行顺序、需要注意的地方，以及如何判断成功与失败，不必写更多。

2. 一个 skill 只负责一件事

   「运行测试套件」和「发布一个版本」应当是两个 skill。小的 skill 可以组合使用；写成一大份，加载时往往有一半内容并不适用。

3. 先让会话起草，再由你修改

   某次智能体完成得不错之后，例如一次复杂的部署或一次干净的迁移，可以让它把刚才的过程写成 skill。你的判断体现在随后的修改上。

MCP 服务

工具通过 MCP（Model Context Protocol，模型上下文协议）接入智能体。添加一个服务只需配置一次，可以是本机命令，也可以是一个地址，各自带有独立的环境变量。配置完成后，它的工具就与内置工具并列可用。服务按全局或工作区两种作用域解析，Mirasim 会同时显示由它管理的服务和智能体自带的服务。

mirasim ui-cli --port 4970 mcp list
mirasim ui-cli --port 4970 mcp add --name gh \
  --command npx --args "-y,@some/mcp-server" --scope global
mirasim ui-cli --port 4970 mcp toggle --name gh --enabled false
mirasim ui-cli --port 4970 mcp health --name gh     # live handshake probe

连接器

连接器是建立在 MCP 之上的一份精选目录。安装之后为它配置凭据，或者让它运行在远端，再按智能体分别启用；某个工具因此不会被强制加到每个会话上。安装是一个完整的生命周期：对照真实服务校验、令牌过期后重新完成 OAuth 授权，以及注销时干净地撤销并留下记录，而不是留下一条失效条目。

mirasim ui-cli --port 4970 connectors list
mirasim ui-cli --port 4970 connectors install SOME_ID --mode remote --secret KEY=value
mirasim ui-cli --port 4970 connectors enable SOME_ID --agent claude
mirasim ui-cli --port 4970 connectors validate SOME_ID    # records tool count / error
mirasim ui-cli --port 4970 connectors auth SOME_ID        # (re)start OAuth, prints the URL
mirasim ui-cli --port 4970 connectors search "issue tracker"   # the official registry

除精选目录之外，连接器搜索会查询官方 MCP 注册表，因此不常见的工具也可以在应用内找到。

本机已安装的命令行工具

智能体在真实环境中效果最好。Mirasim 会清点 PATH 上常见的开发命令行工具，例如 git、gh、docker，并显示各自是否已登录。这样「智能体推送失败」会明确落到「gh 从未登录」上，而不是停留在猜测。

mirasim ui-cli --port 4970 cli-tools    # dev CLIs on PATH + auth state
mirasim ui-cli --port 4970 clis         # agent CLIs: version / latest / update available

Computer Use

Computer Use 是一个工具，由当前会话的智能体调用，调用跟随你的会话，包括该会话的模型与账号。

打开设置 → Computer Use 并启用功能，默认关闭。开启你需要的连接，然后在会话里描述任务，例如检查页面或填写表单。

浏览器连接

三种连接可同时启用，各自保留浏览器状态与登录信息；复制登录只影响独立浏览器。智能体在每次调用时选择使用哪种连接。

macOS 应用

启用「macOS 应用」，点击「管理」检查权限。「辅助功能」用于读取控件和操作应用；「屏幕录制」用于截图和操作预览。按面板提示前往 macOS 系统设置授权，返回 Mirasim 后会重新检测。

智能体首次操作「始终允许的应用」名单以外的应用时，Mirasim 会请求授权。「允许本次任务」只授权当前任务；「始终允许」将应用加入名单，之后可在 Computer Use 设置中撤销。

Electron 应用

Computer Use 也可以操作开放了渲染进程调试端口的 Electron 应用。先为目标应用开启调试端口，再把连接地址告诉会话里的智能体。

操作预览

开启「操作预览」可以观看智能体正在操作的浏览器或应用，预览只读。关闭预览只是隐藏画面，会话仍会继续工作；停止任务请使用单独的停止控件，或停止会话轮次。

mirasim ui-cli --port 4970 computer-use
mirasim ui-cli --port 4970 config set computerUse.guiAgentEnabled=true