auditing-agent-token-usage について
auditing-agent-token-usageは、決定論的なスクリプトでエージェントのトークン使用状況を分析し、結果の解釈を支援するスキルです。Claude Codeのトランスクリプト指標と、Codexの記録トークン数を区別します。
主な機能
- 01使用状況監査スクリプトの実行
- 02分析期間の設定
- 03データのあるソースの報告
- 04根拠のある使用コストの特定
- 05出力に基づく改善案の提示
活用シーン
- 01指定期間のエージェント使用状況の確認
- 02利用可能なClaude CodeとCodexのデータ比較
- 03監査結果に基づく使用傾向の把握
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ bostonaholic/ skills --skill auditing-agent-token-usageインストール後、Claude Code で/auditing-agent-token-usageを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yamlscripts/audit-token-usage.sh
詳細
エージェントのトークン使用量を監査する
決定論的な監査を実行し、その結果を説明してください。このスクリプトが測定値です。独自にログを読み取って代用しないでください。
"<skill-dir>/scripts/audit-token-usage.sh" <days>
<days> は正の整数で、ユーザーが別の期間を指定しない限り、デフォルトは7日間です。このスクリプトには jq が必要で、ホームディレクトリ内の Claude Code のトランスクリプトと Codex のロールアウトを読み込みます。終了コードが0以外の場合は、標準エラー出力を伝えて終了してください。
分析
- 対象期間と、データがあったソースを明記してください。Claude Code のセクション[1]〜[5]では、ターン数や文字数などのトランスクリプトの代理指標を測定します。Codex のセクション[6]では、記録されたトークン数を使用します。
- 証拠から確認できる最大のコスト要因を特定してください。高コストなモデルの使用、継承されたサブエージェントへのルーティング、長時間のセッション、コンパクション、コンテキストの再読み込み、過大なツール結果、セクション[5]に存在しない設定済み MCP サーバーが含まれます。
- 出力によって裏付けられる変更のみを推奨してください。最大3つまで、期待される影響の大きい順に並べ、それぞれの根拠となる件数または割合を示してください。
- Claude Code の代理指標の値を、測定済みトークン数として提示してはいけません。
- ソースが存在しない場合、またはスクリプトが失敗した場合は、不足しているデータまたは前提条件を報告してください。使用状況を推測してはいけません。
コメント
Markdown 対応