connect-tool 是一个用于将第三方工具接入 agent 的技能。它的目标是为用户的 agent 增加一个新工具,使其能在任意文件夹中通过 <tool>-cli 技能使用。
用途 把 Notion、Stripe、ClickFunnels 等工具以命令行技能的形式接入 agent,让 agent 能通过统一命令访问该工具的主要资源。
主要能力
- 确认目标工具,纠正拼写(如把 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 及主要子命令的 --help。
- 没有官方 CLI 时,阅读官方 API 文档,确认 base URL、认证头、子域名或 workspace 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 '%s' '<key>' | python3 .../<tool>.py login --<setting> <value> 直接传入,不重复、不写入其他位置。
- 验证:先运行一条只读命令,再执行一次真实读取(列出少量条目),二者都通过为止。
- 编写 ~/.agents/skills/<tool>-cli/SKILL.md,不超过 30 行,只包含实际运行过或在 --help 或文档中看到的命令。
- 为 Claude Code 建立链接:若 ~/.claude/skills 尚未链接到 ~/.agents/skills,则创建符号链接。
- 结束时用三行说明:连接了什么(CLI 和账户)、新会话中会显示 /<tool>-cli、以及现在可以尝试的一件事。
使用方式 该技能以对话方式运行,用用户的语言逐个简短提问。若技能来自链接而非本地文件夹,不安装仓库中的其他内容,只在某步需要时用 curl -fsSL https://raw.githubusercontent.com/Melvynx/ai-sprint-skills/main/skills/connect-tool/<path> -o <scratch>/<file> 下载其链接的文件(例如 scripts/cli_template.py),并在到达时从 https://raw.githubusercontent.com/Melvynx/ai-sprint-skills/main/skills/<skill-name>/SKILL.md 读取它提到的其他技能。
适用场景 需要让 agent 通过命令行访问某个第三方工具的主要资源,例如查询、列出或操作该工具中的数据,并希望这一能力在所有目录和会话中可用。
限制
- 不安装未经用户同意的第三方包。
- 删除、发布、发送或花钱等操作前必须先询问。
- 写入前先读取。
- 密钥不重复、不写入其他位置。
- 具体支持的工具有赖于该工具是否有官方 CLI 或公开 API 文档;资料未提供固定的工具清单、收费信息或价格。