dff652/codex-token-saver

Codex Token Saver

正確性、検証、安全性、またはユーザーの要求結果を弱めずにワークフローを最適化します。トークン節約は二次的な制約として扱い、使用量を減らすためだけに必要なファイル、ソース、テスト、承認をスキップしないでください。

最も軽量な有効な介入を選択する

ワークフローを変更する前に、実際の無駄を特定します。

• 変更されていないプロジェクトコンテキストの繰り返し読み込み
• 別のプロセスがまだ実行中の頻繁なポーリング
• 時代遅れの決定を引きずる長い会話
• 能力がありコストのかかるモデルが制限された機械的な作業を行っている
• ドリフト、推測による拡張、繰り返しの手戻り

該当する対策のみを適用します。短く適切に範囲が限定されたタスクにプロセスのオーバーヘッドを追加しないでください。

再読み込みの代わりにコンテキストを再利用する

• 永続的なコンテキストと変化する証拠を分離します。永続的なコンテキストには、プロジェクトの目的、アーキテクチャ、コーディング規約、固定された制約、標準コマンドが含まれます。変化する証拠には、新しい要件、編集、障害、ログ、テスト結果が含まれます。
• すでに信頼できる場合は、簡潔な永続的な要約を再利用します。変更された可能性がある、または現在の決定が実際に依存しているファイルまたはセクションのみを再読み込みします。
• 大きなファイルを開く前に、シンボルとパスを検索します。広範なディレクトリまたはドキュメントの読み込みよりも、対象を絞った範囲と焦点を絞ったクエリを優先します。
• 正確性が現在のファイルの内容に依存する場合、メモリに依存しないでください。再読み込みが不要であると判断する前に、タイムスタンプ、差分、検索結果、または関連するソースを確認します。
• 大きなドキュメントでは、レイアウトが重要でない場合は、検索可能なテキストを一度抽出します。画像、テーブル、ページネーション、またはフォーマットがタスクに影響を与える場合は、オリジナルを保持して検査します。

長時間実行される作業を効率的に待機する

• 現在のツールでサポートされている最長の安全な待機間隔またはイベント駆動型の待機を、高速で空のポーリングループよりも優先します。
• 以前の操作ですでに再利用可能なセッションまたはセル識別子が返されている場合、空の入力/ポーリング操作を繰り返し呼び出さないでください。
• 外部の実行呼び出しが内部の待機をラップする場合、外部の呼び出しに内部の結果を受け取るのに十分な時間（合理的なバッファを含む）を与えます。プラットフォームの現在の最大値と優先度の高い指示を尊重します。アクティブな環境で禁止されている間隔をハードコードしないでください。
• 本当に長い待機中は、現在の環境で要求される周期で、簡潔なユーザー向け進捗状況を送信します。

長期プロジェクトのチェックポイントを作成する

多くのフェーズにわたる、または別のタスクで再開される可能性のある作業については、永続化が有用で、その作成がスコープ内にある場合にのみ、プロジェクトに DEV_STATE.md を作成または更新します。コンパクトで事実に基づいたものに保ちます。

# Development State

## Goal
## Verified current state
## Decisions and reasons
## Files changed
## Tests and results
## Next action
## Blockers or open questions

• トランスクリプトではなく、検証済みの状態を記録します。
• 蓄積するのではなく、置き換えられた計画を削除します。
• チェックポイントと矛盾する場合、リポジトリとテスト結果を信頼できる情報源として扱います。
• 再開時には、最初にチェックポイントを読み込み、その後、それがまだ最新であることを確認するために必要なファイルのみを検査します。

許可されている場合、難易度に応じて作業をルーティングする

モデルの選択または委譲が利用可能で許可されている場合：

• あいまいな目標の解釈、アーキテクチャ上の決定、タスクの分割、最終統合は、最も強力な適切なモデルに任せます。
• 低コストのモデルには、明示的な入力、出力、制約、受け入れチェックを伴う範囲が限定されたタスク（焦点を絞ったレビュー、独立した実装、テスト失敗のトリアージなど）を与えます。
• 調整や手戻りがより多くのコストを要する可能性が高い場合、単にトークンを節約するためだけに委譲しないでください。
• 現在のモデル価格やクォータ乗数を決して想定しないでください。コストが推奨事項の一部である場合は、現在の公式OpenAIドキュメントを使用して確認します。
• サブエージェントとモデル変更に関する環境の許可ルールに従います。このスキルは、エージェントを生成したりモデルを変更したりする権限を付与しません。

ドリフトと手戻りを防ぐ

• 実行がリクエストから逸脱した場合は、非生産的なブランチを停止し、目標と現在の証拠を再確認してから、最小の有効な次のステップから続行します。
• 製品が別のサイド会話を提供しており、その回答が主要な履歴に必要ない場合は、一時的なサイド質問をメインの実装コンテキストから離しておきます。
• 記載されたニーズを満たす最もシンプルな実装を優先し、オプションの拡張の前に実行可能な最小限のものを構築し、適切な場合は成熟した依存関係を使用し、予見可能なメンテナンス負債を生み出す近道を避けます。
• 失敗を検査してアプローチを変更せずに、同じ失敗したアクションを繰り返し再試行しないでください。

結果を報告する

完了時に、どの最適化がワークフローを実質的に変更したか、正確性のために何をまだ読み取りまたはテストしたか、そして残っている不確実性を簡潔に述べます。実際の使用データから測定しない限り、節約されたトークンのパーセンテージを主張しないでください。