用途
install-missing-tool 用于在智能体执行任务时,shell 返回 “command not found”“not recognized”“no such file or directory” 等信息,或脚本依赖的工具未安装、任务因缺少实用工具而被阻塞的情况下,指导智能体如何安装缺失工具。它不用于项目内的 Python/Node.js 导入依赖(这些应写入 requirements.txt、package.json 等)。
核心规则
技能明确规定:绝不自动安装软件,任何安装操作都必须先询问用户并获得许可,即使是“显而易见”的工具或带 --yes 参数也不例外。若安装需要 sudo 或管理员权限,应请用户自行运行命令,或由用户明确授权智能体使用其密码执行。
主要流程
- 识别缺失工具:运行失败命令或查看错误信息,确认所需的准确二进制名称。
- 映射包名:通过技能内置对照表查找正确包名;未列出时用首选包管理器搜索(如 brew search <tool>、apt search <tool>)。
- 确定可用包管理器:按优先级依次检查 Homebrew、系统原生包管理器(apt/apt-get、dnf/yum、pacman、zypper、apk、winget/chocolatey)以及语言专用工具(uv、npm、cargo、go)。
- 询问用户许可:向用户说明工具名、包管理器、将执行的精确命令以及是否需要提权。
- 执行安装:用户批准后运行对应安装命令。
- 验证安装:用 which <tool> 或 <tool> --version 确认工具在 PATH 中且命令正常输出。
包名对照(资料提供)
常见工具在 Homebrew / apt / dnf / pacman / winget 下的映射包括:jq、fzf、rg(ripgrep)、fd(apt/dnf 为 fd-find)、bat、tree、httpie、curl、wget、tmux、neofetch、htop、yq、diff-so-fancy、shellcheck、pandoc。语言专用工具:Python 包优先使用 uv tool install <package>(全局)或 uv add <package>(项目本地);Node.js 使用 npm install -g <package>;Rust 使用 cargo install <package>;Go 使用 go install <package>@latest。
适用场景
- 任务执行中所需命令不存在,需要补齐环境。
- 脚本或工具依赖未安装的实用程序。
- 需要以统一、可审计的方式记录并征得用户同意的安装流程。
限制与注意事项
- 禁止未经询问自动安装,禁止静默提权。
- 二进制名与包名常不相同(如 fd-find 与 fd、ripgrep 与 rg),须先核对包名。
- Python 工具安装优先使用 uv,仅在 uv 不可用时回退到 pip。
- 部分包管理器可能静默失败或安装到非 PATH 位置,安装后必须验证。
- 若没有包管理器可提供该工具,需向用户说明,提出自定义安装脚本(下载、解压、配置 PATH),并在运行任何下载或脚本前获得明确许可;不得运行未经用户审查的下载脚本。