token-saver-codex

Codex 向けトークン節約

このスキルには、2 つの役割があります。

1. 有効な間は、以下の基本ルールに従って無駄なく作業します。
2. ユーザーから監査やセットアップを依頼された場合、または制限に何度も達した場合は、「監査とセットアップ」のワークフローを実行して環境を調整します。

基本ルール：無駄なく、正確に作業する

これらのルールの理由：リクエストのたびにコンテキスト全体が再送信されるため、コストはコンテキストのサイズとリクエスト数の積に応じて増加します。出力トークンのコストは入力トークンの数倍です。やり直しのコストはその中で最も高くなります。最初の2つを削減するのは、3つ目が決して起きない方法に限ります。

作業に取りかかる前

• 結果が変わる可能性のある曖昧さがある場合は、推測せず、短い質問を1つします。複数ファイルにまたがる変更やリスクの高い変更では、編集前に計画を示します。
• 作業に十分な情報が得られたら、それ以上の調査はやめます。範囲の狭い依頼で、コードベース全体を調べないでください。

読み取り

• まず場所を特定し（grep、glob、シンボル検索、LSP）、大きなファイルは関連箇所だけを読みます。すでにコンテキストに含まれていて変更されていないファイルを読み直さないでください。
• ロックファイル、生成物、圧縮ファイル、ビルド出力、ベンダー依存関係、ログ全体は読まないでください。必要な情報は検索してください。

ツール出力

• 要約形式を優先します。全差分の前に git status -s と git diff --stat を実行し、git log --oneline -n 20 を使い、再帰的なツリーではなく1つのディレクトリの ls を使います。
• 変更を確認できる最小限のチェックを、静かなフラグを付けて実行します（テストファイルまたはケースを1つ、変更箇所の型チェックなど）。出力が長い場合は tail -n 40 または grep -E "FAIL|Error|error:" に通します。必要な場合は最後に全テストを一度だけ実行します。
• 独立したツール呼び出しは1回のターンにまとめ、1つのファイルへの編集は一度に行います。

委任：基本的には自分で行う

• サブエージェントは無料ではありません。新しいコンテキストから開始し、指示ファイルを再読み込みし、すでに把握している内容を再調査するため、時間がかかり、トークンも同じ制限に加算されます。また、要約では後で必要になる詳細が失われることがあります。
• 次のいずれかに該当する場合に限り、委任します。多数（およそ10個以上）のファイルを読む必要がある場合、または後で必要としない大規模な出力（テスト実行結果、ログ、長いドキュメント）があり、それを短い要約にまとめられる場合、並行して実行できる独立した読み取り専用の作業が3つ以上ある場合、または新しいコンテキストで独立したレビューを行いたい場合。
• 小規模または短時間の作業、前の手順の結果に依存する作業、やり取りが必要な作業、そしてすべての編集はメインスレッドで行います。書き込みは1つのスレッドにまとめ、同じファイルを複数のエージェントに編集させないでください。
• 委任する場合は、より低コストのモデルを使い、目的、パス、返してほしい内容、長さの上限を明確に伝えます。path:line 形式の参照を添えて結論を求め、サブエージェントが読んだ内容を自分で読み直さないでください。

回答

• 結果から先に述べます。依頼を言い換えたり、変更しなかった内容を振り返ったり、編集または path:line 参照で済むのにファイル全体を貼り付けたりしないでください。
• 質問に見合う長さで回答します。任意の追加事項（ドキュメント、リファクタリング、追加テスト）は省略し、必要であれば1行で提案します。

節約しすぎない

• 難しいバグ、セキュリティ、データ損失のリスク、アーキテクチャに関わる問題では、必要なだけ読み、考えます。正しい対応を一度で行うほうが、手早く誤った対応を2回行うより低コストです。
• トークン節約のために検証を省略しないでください。必要な範囲に絞って実行します。

セッションに関するアドバイス（自然な区切りで1行のみ、区切りごとに最大1回）

• 無関係な作業に切り替える際は、新しいセッションを提案します。1つの作業について長時間続けている場合は、焦点を示してコンテキストの圧縮を提案します。
• フラッグシップモデルまたは高い推論設定で定型作業をする場合は、より低コストの設定を提案します。小型モデルで難しい問題に取り組む場合は、上位モデルへの切り替えを提案します。

Codex 固有の事項

コアのルールに加えて、以下を適用してください。

• ローカルとクラウドで利用枠を共有します。 クラウドタスクを実行しても利用可能な容量が増えるわけではありません。実際の作業を削減できる場合にのみ実行してください。
• タスクごとの労力を最も大きく左右するのは、推論の労力です。 範囲が明確な編集には low を、デバッグや複数ファイルにまたがる変更には medium または high を使い、xhigh は長時間かかる推論負荷の高い作業にのみ使ってください。
• AGENTS.md のサイズ上限は project_doc_max_bytes（デフォルトでは 32 KiB）です。上限を超えると、Codex は残りを警告なしで破棄します。簡潔に保ち、ディレクトリ固有のガイダンスはネストした AGENTS.md ファイルに記載してください。
• ユーザーへの提案（実行するのはユーザーです。あなたには実行できません）：

状況	提案
関連のない作業を始める	/new
同じタスクでセッションが長くなった	区切りのよいところで /compact
このスレッドを失わずに別案を試したい	/fork
高い労力設定または大規模モデルで定型タスクを行う	/model を実行し、より小さいモデルまたは低い労力設定を選ぶ
残りの利用枠がわからない	/status を実行し、5時間および週ごとの上限をステータス行に追加する
速度が必要ない	高速モードをオフにする（リクエストごとに消費クレジットが増えます）

監査とセットアップ

ユーザーが監査、セットアップ、または利用量の削減を依頼した場合や、上限に何度も達する場合：

1. プロジェクトのルートから node <this skill's directory>/scripts/audit.mjs --agent codex を実行してください。これは読み取り専用で、修正方法とともに警告を出力します。Node.js がない場合は、references/levers.md を参照して同じ項目を手動で確認してください。
2. 期待される削減量の大きい順に、見つかった問題をそれぞれ数行で報告してください。
3. references/levers.md に記載されたキーを使って、~/.codex/config.toml（またはプロジェクトの .codex/config.toml）への具体的な変更を提案してください。設定はユーザーのものです。差分を提示し、同意を得てから適用してください。
4. 常時有効にするスニペットの追加を提案してください。スキルは呼び出された場合にのみ読み込まれるため、作業量を抑えるルールを常設する必要があります。同等のセクションがすでに存在しない場合は、assets/always-on.md の内容をプロジェクトの AGENTS.md または ~/.codex/AGENTS.md に追記してください。

参考資料

• references/levers.md：利用量に影響する config.toml のキー、コマンド、習慣、および簡潔な設定例。設定を変更する前に読んでください。
• references/facts.md：上限、クレジット、料金に関する情報とその出典・日付。ユーザーが上限や料金について尋ねた場合に読み、回答の正確性が重要であればリンク先で確認してください。
• references/budget.md：5時間および週ごとの利用枠に合わせて作業ペースを調整する方法。