SuperAPI AI 工具集

rtk-skill

编程与开发

查看项目

更新于 10-16 09:30

技能介绍

用途:RTK 是一个 CLI 代理,在命令输出到达 LLM 之前进行过滤和压缩,通常可节省 60%–90% token。适用于 git、测试、构建、lint、包管理器、docker/kubectl、ls/grep/find、gh 等会产生大量输出的 shell 命令。

主要能力:对冗长输出做压缩;测试类输出聚焦失败信息(约 90% 节省);保留退出码;失败时输出中会给出完整输出日志路径(如 ~/.local/share/rtk/tee/....log),可读取该日志获取未过滤内容。提供 read / grep / find / ls / diff 等文件与搜索命令,用来替代智能体自带、会绕过 Bash 钩子的原生 Read/Grep/Glob 工具,其中 read 支持 -l aggressive 只读签名。还有 err 仅显示错误,以及 gain、gain --history、discover 等分析命令。全局标志示例:-u、-v。

使用方式:先解析 rtk 命令,只用通用路径,不要用机器相关的绝对路径。优先级为:1) ~/.terrain/bin/rtk(Terrain 环境集成或桌面应用);2) bunx @terrain-ai/rtk(无 Terrain 安装、需一次网络);3) npx @terrain-ai/rtk(无 Bun 时)。Windows 下部署到 %USERPROFILE%.terrain\bin\,二进制带 .exe。可选清单 .terrain/env/agent-tools.json(本地、已 gitignore)。存在性检查:bash / zsh / Git Bash 用 [ -x ~/.terrain/bin/rtk ] || [ -x ~/.terrain/bin/rtk.exe ];PowerShell 用 Test-Path "$HOME.terrain\bin\rtk.exe";cmd 用 if exist "%USERPROFILE%.terrain\bin\rtk.exe"。以 ~/.terrain/bin/rtk <cmd> 形式调用(波浪号在词首展开);不要把 rtk 路径存入变量后加引号调用,也不要假设裸 rtk 在 PATH 中。验证:~/.terrain/bin/rtk gain || bunx @terrain-ai/rtk gain。黄金法则:任何输出超过几行的 shell 命令,都用 <rtk-prefix> <cmd> 代替裸命令。例外:.terrain/agent/context.md 和较短的 knowledge/*.md 直接读取。

限制:不要运行 rtk init 或 rtk init -g(Terrain 通过 AGENTS.md 管理智能体指引);不要假设钩子会自动改写命令,必须手动输入 rtk 前缀;RTK 已汇总后不要重复运行相同冗长命令;注意别用错 rtk 包。绕过:RTK_DISABLED=1 git status。架构知识用 terrain-knowledge-skill / context.md,符号关系用 codegraph-skill,结构化索引用 repomix-context-skill;工作流顺序为 Terrain knowledge → codegraph → repomix slices → rtk 处理剩余 shell 工作。