ecc-tools-cost-audit

ecc-tools-cost-audit スキルの概要

ecc-tools-cost-audit の用途

ecc-tools-cost-audit は、ECC Tools GitHub App でコストが本来ではない理由で増えているときに使う、証拠重視の監査スキルです。たとえば、PR の作成が暴走している、usage limit を回避している、ジョブが重複実行されている、premium model が漏れている、といったケースを想定しています。Webhook から worker、そして billing 判定までの流れを追い、どこで支出が発生しているかを証明したい Backend Development 作業に最適です。

どんな人が使うべきか

姉妹リポジトリの ECC-Tools で挙動を調査していて、広いコードレビューではなく、コストや billing に絞った調査が必要な場合に ecc-tools-cost-audit skill を使ってください。すでに特定の失敗モードを疑っていて、経路・ゲート・顧客影響を必ず確認するワークフローがほしいときに向いています。

何が違うのか

このスキルは、範囲を限定した監査を前提に設計されています。つまり、正確なコードパスを特定し、コスト発生の引き金を切り分け、アプリの挙動と billing 計算を分離して確認します。そのため、webhook、queue retry、entitlement、PR 自動化ループが絡む障害では、一般的なプロンプトよりも有効です。

ecc-tools-cost-audit スキルの使い方

まず導入して、適切なファイルを開く

ディレクトリツールチェーンから ecc-tools-cost-audit install の手順で導入し、最初に SKILL.md を開いてください。このリポジトリには補助スクリプトや reference フォルダはないため、読む順序として最も価値が高いのは SKILL.md、その次に webhook、queue worker、PR creation、usage reservation、paid-gate check を担当する ECC-Tools 側のコードパスです。

曖昧な問題を、使えるプロンプトに変える

ecc-tools-cost-audit usage は、症状・対象範囲・証明したいゴールを明示すると最も効果を発揮します。たとえば、「free-tier ユーザーが webhook worker で premium analysis に到達してしまう理由を監査し、gating の不具合を特定したうえで、最小修正と検証手順まで示してください」のような入力が有効です。「billing の問題を見つけて」のような曖昧な依頼では、ルーティングの解釈余地が大きすぎます。

スキルスタックは意図して使い分ける

ecc-tools-cost-audit guide では、問題がレイヤーをまたぐ場合に、周辺の ECC ネイティブスキルを組み合わせることが前提になっています。ヘルパーを勝手に作る前に search-first を使い、モジュールをまたぐ流れを追うときは agentic-engineering、ドル単位の影響を明確に数える必要があるときは customer-billing-ops、修正後に再実行しても安全な証拠が必要なときは verification-loop を使ってください。

Backend Development 向けの実践的ワークフロー

まず request path を図にし、そのうえで usage がどこで reserve されるか、retry によってどこで作業が重複しうるか、model selection や PR creation の判断がどこで行われるかを確認します。最初の確認で漏れが見えない場合は、「happy path」と「retry path」を分けて比較してください。ここでのコストバグは、exception handling、queue への再 प्रवेश、あるいは free user だけで失敗する条件の中に隠れていることが多いです。

ecc-tools-cost-audit スキル FAQ

ecc-tools-cost-audit は billing 問題だけのためのものですか？

いいえ。ECC Tools で不要な支出を生む backend の挙動全般が対象です。重複ジョブ、重複 PR、entitlement の迂回も含まれます。billing 計算は重要ですが、主な役割はコストを発生させているコードパスを見つけることです。

使うにはリポジトリ全体を把握している必要がありますか？

いいえ。ただし、関連する実行経路は必要です。このスキルは、ファイルをバラバラに読むより、webhook handler、worker、billing または gating ロジックをまとめて確認できるときに最も効果を発揮します。

どんなときに使わないほうがいいですか？

大規模なアーキテクチャレビュー、frontend のバグ、あるいは「アプリを安くして」という一般的な依頼には使わないでください。問題が ECC Tools のコスト挙動に結びついていないなら、より一般的な debugging か refactoring のスキルのほうが適しています。

初心者向けですか？

具体的な症状を説明できるなら、はい。スキル自体が調査をガイドしてくれますが、完全に自由度の高い依頼よりも、イベント例、疑わしいトリガー、観測された cost spike を提示したほうがうまく機能します。

ecc-tools-cost-audit スキルの改善方法

監査対象を測定可能にする

ecc-tools-cost-audit skill は、「悪い状態」を具体的に示すと結果が良くなります。たとえば、webhook あたりの余分な PR 数、想定外の premium-model 呼び出し、limit check の失敗、retry 後の重複処理などです。数値、タイムスタンプ、イベント ID の例を入れると、推測が減り、最初の確認精度が上がります。

できるだけ狭い経路を指定する

関係する backend surface を正確に名指ししてください。たとえば、webhook receiver、queue consumer、reservation logic、PR creation flow、entitlement gate です。もし経路が「free user + retry + premium model selection」だと分かっているなら、その 3 つをすべて含めてください。その組み合わせのほうが、一般的な不満よりもはるかに価値があります。

パッチではなく、証拠を求める

最適な ecc-tools-cost-audit usage では、トレースされた root cause、最小限のコード変更、検証計画まで求めます。そうすることで、回答が観測可能な挙動に根ざし、修正によって別の場所にコストが移っていないかも確認しやすくなります。

最初の確認後は、失敗モードを絞り込んで反復する

最初の結果が広すぎる場合は、想定される failure mode に沿って絞り直してください。たとえば、queue の重複実行、idempotency の不足、誤った model choice、回避された reservation check などです。このスキルは監査範囲が狭く、期待結果が明確なほど強いので、反復ごとに曖昧さを減らしていくのが重要です。