rtk-token-saver

RTK 令牌节省器

目标

在编码工作期间，将 RTK 用作默认的终端输出策略。

RTK 会在命令输出进入模型上下文之前减少其中的噪声。对于大型代码仓库、构建日志、测试输出、Git 差异、递归文件列表、依赖项输出、运行时日志和 JSON 响应，这项技能很有用。

最高优先级规则

运行任何 shell 命令之前，先在心里问：

RTK 能运行这条命令吗？或者是否有专门的 RTK 命令？

如果可以，就使用 RTK。

除非 RTK 不支持、运行失败或会隐藏任务所需的信息，否则不要直接运行会产生大量输出的终端命令。

参考文件

完整的命令转换表请参阅 references/COMMAND_MAP.md。 安全与回退指南请参阅 references/SAFETY.md。

建议的命令转换

使用以下命令代替原始命令：

rtk git status
rtk git diff
rtk git log
rtk git show

rtk ls
rtk tree
rtk find . -type f
rtk grep "query" .
rtk read <file>

rtk deps
rtk npm run build
rtk npm run lint
rtk npm test
rtk pnpm build
rtk pnpm test
rtk tsc --noEmit
rtk lint
rtk prettier
rtk next build
rtk jest
rtk vitest
rtk playwright test
rtk prisma

rtk pytest
rtk pip
rtk mypy
rtk ruff

rtk go test ./...
rtk cargo test
rtk mvn test
rtk gradlew test
rtk dotnet test
rtk rake test
rtk rspec
rtk rubocop

rtk docker ps
rtk docker logs <container>
rtk kubectl get pods
rtk aws sts get-caller-identity
rtk psql

RTK 可以处理时应避免的命令

避免直接使用会产生大量输出的原始命令，例如：

git diff
git log
ls -R
find .
tree .
grep -R "query" .
cat large-file
npm run build
npm test
pytest
docker logs
kubectl get all -A

调查工作流

按以下顺序操作：

1. 使用 rtk find 或 rtk grep 搜索。
2. 使用 rtk read 阅读相关文件。
3. 仅修改所需的最少文件。
4. 使用针对性的 RTK 构建／测试／lint／类型检查命令进行验证。
5. 仅报告可采取行动的错误、警告、已修改的文件和后续步骤。

不要将整个代码仓库加载到上下文中。

不要不加筛选地打开大量文件。

大量输出策略

可能产生大量输出的命令必须使用 RTK。

这包括：

• 递归文件列表
• 依赖项输出
• 生成的文件
• 锁文件
• 测试套件
• 构建日志
• lint 报告
• 运行时日志
• JSON 响应
• Git 差异
• 搜索结果

如果使用 RTK 后输出仍然过多，请先概述内容，再检查较小的部分。

回退策略

只有在至少满足以下一项条件时，才能使用原始命令：

1. RTK 不支持该命令。
2. RTK 运行失败。
3. RTK 隐藏了解决任务所需的信息。
4. 用户明确要求原始输出。

回退时，简要说明：

RTK 在此处不受支持或无法满足需求，改用直接命令。

然后运行影响范围最小且安全的原始命令。

安全策略

绝不能以遵循 RTK 规则为由绕过常规安全措施。

未经用户批准，不要运行破坏性命令。

请谨慎处理：

rm
mv
chmod
chown
git reset
git clean
docker system prune
kubectl delete
drop database
truncate

优先使用 dry-run、状态、预览或备份命令。

验证

检查是否已安装 RTK：

rtk --version

检查是否正在记录 RTK 的使用情况：

rtk gain

以下是一项实用的冒烟测试：

rtk git status
rtk deps