用途 connect-tool 的目标是为用户的智能体接入一个新工具，并把它做成可全局调用的 <tool>-cli 技能，这样用户在任意文件夹下都能通过命令操作该工具。
主要能力
- 确认要接入的工具，并纠正拼写错误（例如把“mtoin”识别为 Notion）。
- 检查 ~/.agents/skills/<tool>-cli/ 是否已存在；若存在先读取，并在修改前征得用户同意。
- 优先查找厂商自己发布的 CLI（从其文档、域名或 GitHub 组织判断），并用 command -v 检查是否已安装。
- 找到官方 CLI 时：用文档给出的方式安装，macOS 优先 brew，其次厂商的 npm i -g、pipx 或 uv tool install，再到其安装脚本；使用 sudo 前先询问；用 <cli> --version 校验，找不到则修复 shell PATH 并说明；有浏览器登录就用浏览器登录，需要密钥的由用户自行在 ~/.zshrc 添加 export <VAR>=...；阅读 <cli> --help 及主要子命令帮助。
- 没有官方 CLI 时：阅读官方 API 文档，确认 base URL、认证头、子域名或工作区 id 等额外值，以及用户最常用的 5 至 10 个操作对应的端点；把 scripts/cli_template.py 复制到 ~/.agents/skills/<tool>-cli/scripts/<tool>.py，仅用已确认的端点填写常量、auth_headers、SETTINGS 和 COMMANDS（check 为轻量只读操作，仅用标准库）；告知用户在何处创建密钥、使用满足需求的最小权限，并在终端执行 python3 ~/.agents/skills/<tool>-cli/scripts/<tool>.py login（隐藏输入）；若用户直接在对话中粘贴密钥，则用 printf 管道传入，不重复、不另写他处。
- 验证：先运行一条只读命令，再做一次真实读取（列出少量条目），直到两者都成功。
- 编写 ~/.agents/skills/<tool>-cli/SKILL.md，不超过 30 行，只写入实际运行过或在 --help／文档中见过的命令；<run> 为 <cli> 或 python3 ~/.agents/skills/<tool>-cli/scripts/<tool>.py。文件包含 name、description、运行与认证说明、子命令列表，以及“先读后写、删除/发布/发送/花钱前先询问”的提醒和文档地址。
- 为 Claude Code 建立链接：若 ~/.claude/skills 尚未指向 ~/.agents/skills，则执行 mkdir -p ~/.claude/skills && ln -s ~/.agents/skills/<tool>-cli ~/.claude/skills/<tool>-cli。
- 最后用三行说明：连接了什么（CLI 与账户）、新会话中会显示 /<tool>-cli、以及现在可以尝试的一件事。
使用方式 通过技能链接获取时，不要从仓库安装其他内容；仅在某个步骤需要时用 curl 下载其链接的文件（例如 scripts/cli_template.py），仅在到达某一步时读取它提到的其他技能。全程与用户用其语言交流，一次一个问题，不使用术语。
适用场景 需要让智能体在任意目录中操作某个第三方 SaaS 工具（如 Notion、Stripe、ClickFunnels），且该工具提供官方 CLI 或公开 API 时。
限制 只使用厂商官方 CLI 或官方 API 文档中确认的端点，不编造功能；安装第三方包前必须得到用户同意；不执行未经确认的删除、发布、发送或付费操作。密钥由用户自行在终端输入或自行加入 shell 配置，不在对话中重复输出。