SuperAPI AI 工具集

tg

编程与开发

查看项目

更新于 10-16 02:35

技能介绍

用途:tg 是面向 Tangled(https://tangled.org,基于 ATProto 的联邦化 git 托管平台)的命令行技能,用于在 Claude 环境中查看和操作仓库、issue 与 PR。

主要能力:读操作无需认证,包括 tg repo list <handle>、tg repo view <owner>/<name>、tg issue list/view、tg pr list/view/patch(patch 输出最新一轮 diff)。写操作需已认证会话,包括 tg issue create/comment/close、tg pr comment/create、tg ssh-key add。

使用方式:任何 tg 命令前先运行 bash skills/tg/auth.sh。该脚本会把自带的 bin/tg 软链到 $PATH,将 BSKY_HANDLE/BSKY_APP_PASSWORD 映射为 tg auth login 读取的 ATPROTO_* 变量,并在无活动会话时执行登录。之后 tg auth status 应显示 handle/DID/PDS,否则应停止并报告错误,不要盲目重试。标识符使用 rkey(at-uri 末尾 13 位片段),不要使用网页 UI 中的顺序编号 #N。克隆仓库应放入 ./.spokes/<name>:tg repo clone <owner>/<name> .spokes/<name>。

限制:不支持 pr merge/close/reopen、pr checkout;repo create 仅支持 --source <https-url>,不支持 SSH 推送创建。git push 需 22 端口 SSH 出网,多数 Claude 环境会阻止,建议用 tg pr create(基于 patch、仅 HTTPS)。tg 通过所有者 PDS 解析读取,自托管 PDS(如 pds.mitchellh.com)在受限代理环境中不可达,会报错并提示改用网页 UI;此类仓库中自托管贡献者的记录会被跳过。遇到用户粘贴带数字 ID 的网页 URL、写操作涉及非本人仓库、或未认证且无 *_APP_PASSWORD 时,应先询问确认。