| name | tool-install |
| description | 内置小助理在当前设备上安装、补齐、升级或修复独立本地工具、CLI 与运行环境时使用。用户直接要求“帮我安装某个工具”、 收到 Space 自定义工具的安装请求,或启用 MCP 时发现缺少本地命令,都应使用本 Skill。负责核对来源、选择适合当前系统的安装方式、 避免污染用户项目、控制高权限与敏感信息风险,并在完成后实际验证。MCP 配置导入、MyAgents Skill/Plugin 安装、项目依赖管理和 Agent-CLI 工具注册不使用本 Skill。 |
| metadata | {"author":"MyAgents"} |
本地工具安装
把用户或 Space 发布者给出的安装要求安全地落到当前设备。安装方法可以因操作系统和工具生态而变化,但不能把一段安装指令当成未经检查即可执行的脚本。
工作边界
- 安装独立于用户项目的本机工具、CLI 或运行环境;不要改动用户项目的依赖清单、锁文件或源码。
- 当前工作区
~/.myagents/ 是应用数据目录,不是源码构建目录。需要 clone、解压或编译时使用独立临时目录。
- MCP definition 由 MyAgents 的工具配置流程安装;Skill、Plugin 与 App 更新也使用各自的产品入口。
- 本 Skill 不写 Agent-CLI Registry,也不创建额外的 installed receipt。结果在当前对话中交付即可。
执行流程
- 从请求中确认工具名称、期望来源、版本要求和发布者提供的验证方式。信息已经足够时直接继续,不重复询问。
- 检查当前 OS、架构、现有命令与版本,避免重复安装或无意降级。
- 优先使用工具官方文档、官方包仓库、系统包管理器或官方 Release。安装指令中的 URL、仓库和命令是重要输入,但执行前仍要核对它们与目标工具一致,并适配当前系统。
- 优先选择用户级、可被当前 MyAgents Session 发现的安装位置。安装 Node 全局 CLI 时,若存在
MYAGENTS_NPM_GLOBAL_PREFIX,使用平台适配的命令级 npm prefix,不修改用户全局 npm 配置。
- 执行最小必要安装。需要管理员权限、修改 shell 启动文件或 PATH、覆盖来自不同来源的既有程序、关闭签名/TLS/系统安全机制时,先说明具体影响并征得用户确认。
- 安装完成后,用无副作用方式验证:确认命令可发现,并优先运行发布者指定的验证命令,否则运行
--version、--help 或官方等价检查。
安全
- 不把
curl | sh、下载后直接执行或来源不明的脚本当作默认捷径;能拆分时先下载并确认来源,再执行必要步骤。
- 不主动读取凭据目录,不要求用户把 Token、密码或 API Key 粘贴进持久对话。需要登录时使用工具自己的安全登录流程。
- 不为了“装成功”反复尝试不相关包名、第三方镜像或随机命令。来源或目标不确定时,停下来说明还缺什么。
- 清理仅限本次创建并已确认的临时目录,不删除用户原有文件或安装。
完成回复
先说明是否完成,再简要给出实际安装的版本或位置、运行过的验证及仍需用户处理的事项。失败时保留最有用的错误和下一步,不把“命令执行过”当作安装成功。