mcpField
R
rtk-token-saver

rtk-token-saver

github.com/x-saikat-93エージェントワークフロー139 回インストール19 週間前に更新
リポジトリ

rtk-token-saver について

コーディング作業で RTK を標準の出力削減手段として使うスキルです。リポジトリの調査や対象を絞った検証を案内し、RTK が使えない場合や情報が不足する場合の安全な直接コマンドへの切り替え方も定めています。

主な機能

  1. 01RTK を優先するコマンド選択
  2. 02対象を絞った検索とファイル読み込み
  3. 03限定的なビルドとテスト検証
  4. 04直接コマンドへの切り替え規則
  5. 05破壊的操作に関する安全指針

活用シーン

  1. 01ビルド、テスト、ログの出力をモデルコンテキスト内で削減
  2. 02大規模リポジトリを全体読み込みせずに調査
  3. 03RTK で必要な情報を得られない場合に直接コマンドを使用

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/x-saikat-93/opencode-rtk-skill --skill rtk-token-saver

インストール後、Claude Code で/rtk-token-saverを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
assets/
icon.svg
references/
COMMAND_MAP.md
SAFETY.md
scripts/
check-rtk.sh

詳細

RTK トークンセーバー

目標

コーディング作業中は、RTK をデフォルトのターミナル出力方針として使用します。

RTK は、モデルのコンテキストに入る前に、ノイズの多いコマンド出力を削減します。このスキルは、大規模なリポジトリ、ビルドログ、テスト出力、Git の差分、再帰的なファイル一覧、依存関係の出力、実行時ログ、JSON レスポンスに役立ちます。

最優先ルール

シェルコマンドを実行する前に、必ず次のことを自分に問いかけてください。

このコマンドは 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 のビルド、テスト、リント、型チェック用コマンドで検証します。
  5. 対応が必要なエラーや警告、変更したファイル、次の手順のみを報告します。

リポジトリ全体をコンテキストに読み込まないでください。

多くのファイルをむやみに開かないでください。

大量出力の方針

大量の出力が見込まれるコマンドでは、RTK を使用してください。

次のものが含まれます。

  • 再帰的なファイル一覧
  • 依存関係の出力
  • 生成ファイル
  • ロックファイル
  • テストスイート
  • ビルドログ
  • リントレポート
  • 実行時ログ
  • JSON レスポンス
  • Git の差分
  • 検索結果

RTK を使っても出力が多すぎる場合は、要約してから、より小さな範囲を調べてください。

フォールバック方針

次の条件のうち、少なくとも 1 つに該当する場合に限り、生のコマンドを使用してください。

  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

まず、ドライラン、ステータス確認、プレビュー、バックアップ用のコマンドを優先してください。

検証

RTK がインストールされていることを確認します。

rtk --version

RTK の使用状況が記録されているか確認します。

rtk gain

有用なスモークテストは次のとおりです。

rtk git status
rtk deps

コメント

Markdown 対応