Tool Install

---
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。结果在当前对话中交付即可。

## 执行流程

1. 从请求中确认工具名称、期望来源、版本要求和发布者提供的验证方式。信息已经足够时直接继续，不重复询问。
2. 检查当前 OS、架构、现有命令与版本，避免重复安装或无意降级。
3. 优先使用工具官方文档、官方包仓库、系统包管理器或官方 Release。安装指令中的 URL、仓库和命令是重要输入，但执行前仍要核对它们与目标工具一致，并适配当前系统。
4. 优先选择用户级、可被当前 MyAgents Session 发现的安装位置。安装 Node 全局 CLI 时，若存在 `MYAGENTS_NPM_GLOBAL_PREFIX`，使用平台适配的命令级 npm prefix，不修改用户全局 npm 配置。
5. 执行最小必要安装。需要管理员权限、修改 shell 启动文件或 PATH、覆盖来自不同来源的既有程序、关闭签名/TLS/系统安全机制时，先说明具体影响并征得用户确认。
6. 安装完成后，用无副作用方式验证：确认命令可发现，并优先运行发布者指定的验证命令，否则运行 `--version`、`--help` 或官方等价检查。

## 安全

- 不把 `curl | sh`、下载后直接执行或来源不明的脚本当作默认捷径；能拆分时先下载并确认来源，再执行必要步骤。
- 不主动读取凭据目录，不要求用户把 Token、密码或 API Key 粘贴进持久对话。需要登录时使用工具自己的安全登录流程。
- 不为了“装成功”反复尝试不相关包名、第三方镜像或随机命令。来源或目标不确定时，停下来说明还缺什么。
- 清理仅限本次创建并已确认的临时目录，不删除用户原有文件或安装。

## 完成回复

先说明是否完成，再简要给出实际安装的版本或位置、运行过的验证及仍需用户处理的事项。失败时保留最有用的错误和下一步，不把“命令执行过”当作安装成功。