Tool Install

内置小助理在当前设备上安装、补齐、升级或修复独立本地工具、CLI 与运行环境时使用。用户直接要求“帮我安装某个工具”、 收到 Space 自定义工具的安装请求,或启用 MCP 时发现缺少本地命令,都应使用本 Skill。负责核对来源、选择适合当前系统的安装方式、 避免污染用户项目、控制高权限与敏感信息风险,并在完成后实际验证。MCP 配置导入、MyAgents Skill/Plugin 安装、项目依赖管理和 Agent-CLI 工具注册不使用本 Skill。

hAcKlyc 0dc5b4b 3.2 KB Updated

File contents

本地工具安装

把用户或 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 粘贴进持久对话。需要登录时使用工具自己的安全登录流程。
  • 不为了“装成功”反复尝试不相关包名、第三方镜像或随机命令。来源或目标不确定时,停下来说明还缺什么。
  • 清理仅限本次创建并已确认的临时目录,不删除用户原有文件或安装。

完成回复

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

hAcKlyc/MyAgents/tree/main/bundled-agents/myagents_helper/.claude/skills/tool-install commit 0dc5b4b63d

Frequently asked questions

npx skillmds@latest add hacklyc/tool-install