use-rtk 是一个面向 LLM 智能体的技能指令集,核心用途是让模型在环境中存在 rtk 命令时,改用 RTK(Rust Token Killer)包装终端命令。RTK 被描述为一个高性能 CLI 代理:它在命令输出进入 LLM 上下文之前先做过滤和摘要,从而降低 token 消耗(宣称 60–90%),同时不改变工作流程或结果。
主要能力与规则 技能规定了激活条件:rtk 命令可用(可通过 which rtk 或 rtk --version 检查);即将运行的命令输出可能很长、重复或样板化;任务涉及 git 操作、运行测试、lint、构建、读文件、搜索文件、检查依赖或日志。也明确了不适用场景:用户有意需要完整原始输出的命令、没有 RTK 等价形式且用 rtk bypass 无价值的命令,以及 RTK 无法重写的 shell 结构(如 $(...) 子命令替换与文件重定向),这些应原样运行。
决策规则为:运行前先查是否存在 RTK 子命令或代理;有则用 RTK 形式;不确定则运行 rtk rewrite <command> 询问是否有重写;没有等价形式则原样运行;若输出不可用(预期有输出却为空、与退出码矛盾、乱码),改用 rtk bypass <command> 重跑。
命令映射 资料给出了按生态分类的映射,例如文件系统 ls→rtk ls、find→rtk find、tree→rtk tree、cat→rtk read、grep→rtk grep、rg→rtk rg;Git 与托管平台 git/gh/glab/gt 对应 rtk git/gh/glab/gt;JavaScript/TypeScript 覆盖 npm、npx、pnpm、bun、bunx、tsc、eslint、prettier、jest、vitest、next build、ng build/test、prisma,其中 yarn 建议按情况改用 rtk npm 或 rtk pnpm;Python 覆盖 pytest、mypy、ruff、pip、uv run;Rust 为 cargo;Go 为 go 与 golangci-lint;PHP 覆盖 php、phpunit、phpstan、pint、pest、paratest、ecs;Ruby/Rails 覆盖 rspec、rubocop、rake;Java/JVM 覆盖 mvn、mvnd、sbt、gradlew;.NET 覆盖 dotnet、ctest;基础设施覆盖 docker、kubectl、oc、aws、psql;SQL lint 为 sqlfluff;其他包括 curl、wget、wc、playwright、deno、ast-grep。
无专用子命令时可用通用包装器:rtk test <完整测试命令>(只显示失败)、rtk err <完整命令>(只显示错误与警告)、rtk summary <完整命令>(显示启发式摘要)、rtk pipe -f <过滤器>(通过命名过滤器处理 stdin,如 cargo test 2>&1 | rtk pipe -f cargo-test)。管道模式下可用的命名过滤器包括 cargo-test、pytest、phpunit、phpstan、pint、grep、find、git-log。
恢复与校验 若压缩结果不可用,可用 rtk bypass <command> 不过滤执行(仍记录用量),或用 rtk recall <hash> 按 RTK 恢复提示中的内容哈希取回被省略的完整输出。rtk rewrite <command> 用于在运行前检查重写结果,是钩子重写的唯一事实来源;其退出码含义:0 表示已打印重写且 allow 规则覆盖全部命令,可安全自动放行;1 表示无重写,原样运行;2 表示命中 deny 规则,应阻止;3 表示已打印重写但需宿主审批。
统计与初始化 任务后可查看节省情况:rtk gain、rtk gain --project、rtk gain --daily、rtk gain --weekly,还可用 rtk discover 发现未走 RTK 的命令、rtk session 查看采用情况。若已安装但未初始化,可运行 rtk init -g --agent <agent>(如 antigravity),rtk init --dry-run 预览变更,rtk verify 校验钩子完整性;--agent 支持的代理包括 claude、cursor、trae、windsurf、cline、kilocode、antigravity、kimi、pi、hermes、droid、vibe、omp。
高级功能 资料还提到可选的透明 LLM 代理,用于压缩 LLM 请求本身的输入 token,与基于钩子的输出过滤相互独立,命令包括 rtk llm-proxy setup/start/status/stop;以及管道检查命令 rtk pipeline show/validate/explain。
适用场景与限制 该技能适用于让 AI 编程助手在开发流程中减少上下文 token 占用,覆盖测试、构建、lint、git、文件搜索、依赖与日志查看等场景。限制方面:不应把 RTK 用于完整输出本身就是产物的命令(如通过重定向生成文件的命令),也不应用于依赖精确可解析输出的脚本或 CI 流水线——RTK 面向 LLM 上下文而非下游解析;不要不必要地重复 rtk bypass;若已安装且钩子生效,不应重复安装或初始化。资料未提供价格、收费与具体性能数据之外的量化指标。