nwiizo AWS FinOps Investigation Skill
FinOps 調査で実践で躓いた学びのみを記載。一般的な AWS / FinOps 知識は含まない。
Trigger
- AWS コスト削減・棚卸し調査
- 前回調査との差分確認、定期レビュー
- RI / Savings Plans 購入判断、未使用リソース特定
参照するサブファイル
今回の調査に必要なファイルだけ読む。認証済みの継続調査で認証手順をやり直したり、単発の確認で全サービスの棚卸しを始めたりしない。
- best_practices_2026.md — FinOps Foundation 2026 Framework、業界ベンチマーク、クラウド非依存の原則
- auth.md — MFA + AssumeRole の非対話環境での突破手順と罠
- cost_analysis.md — Cost Explorer の読み方、異常値の解釈、数値の分母混在回避
- detection_patterns.md — 孤児リソース・隠れ課金の検出パターン
- ri_sp_gotchas.md — RI/SP の誤認パターンと判断基準
- reporting.md — レポート出力規律、history ファイル運用、優先度付け
Core Principles
- ReadOnly 厳守: 提案のみ、変更系操作は自動実行しない
- 数値の分母統一: 月平均 / 月末換算 / N日実績を混ぜない。外部共有は月平均ベースを基準にする
- production タグのリソースは慎重扱い: 停止中でも DNS/SG/外部許可リストで参照されている前提で担当者確認を必須にする
- 権限は時間経過で変化する: 前回使えた API が今回 NG のことがある。調査冒頭で必ず再検証する
- 重複計上・警告漏れ・計算矛盾を検証する。独立レビューは依頼または適用される運用手順が求める場合に行う
- 学びは調査結果に残す。CLAUDE.md / memory への反映は、その編集が依頼に含まれる場合に限る
調査の進め方
次は広い調査の流れ。依頼範囲と現在の証拠に合わせて必要な段階を選ぶ。 既存の認証経路を優先し、下記の MFA 手順はそれが必要な環境で使う。
- 認証確立（MFA + AssumeRole、対話シェルで JSON 生成→Claude が読む）
- 権限検証（使える/使えない API を冒頭で明示）
- Cost Explorer で大枠把握（月次推移 → USAGE_TYPE 内訳 → 異常値解釈）
- リソース棚卸し（並列で describe 系 API を叩いて JSON 保存）
- 削減候補抽出（検出パターンを機械的に適用）
- レポート作成（テンプレート、3段階優先度、重複除外）
- 数値と対象の検証。独立レビューを行った場合も、指摘を証拠と照合して妥当なものを反映
Anti-Patterns（やらかしがち）
- いきなり describe 系 API を全件取得 → 先に Cost Explorer で金額の大枠を押さえる
- 期間や費用の定義を示さず削減額を提示 → 主指標の分母を明示し、判断に必要な補助指標だけ併記する
- RI 購入直後の月を「異常」と警告 →
HeavyUsage:*USAGE_TYPE を確認 - Savings Plans が RDS に効くと誤案内 → 専用 RI が必要
- 停止中 EC2 を「課金ゼロ」と報告 → EBS / EIP / AWS Backup は課金継続
- 孤児スナップショット削除で親 AMI を見ずに deregister → 関連エラーになる
- production タグを見ずに「解放可能」と提案 → 外部疎通断の事故
- 削減額を施策間で重複計上（Snapshot 系が特に重なる）
- レポートを前回の上書きで消す → 履歴ファイルを別途運用して差分追跡可能にする
Output Discipline
以下は継続調査での配置例。依頼先の形式・保存先があればそちらに合わせ、不要なファイルや外部向け文面を自動追加しない。
- レポート:
docs/cost_analysis_YYYYMMDD.md（日付付き、上書き禁止） - 生データ:
output/<resource>_YYYYMMDD.json（再分析時のベースライン） - 履歴:
docs/finops_history.md追記式、完了チェックボックス付き - 優先度: 既存の分類を優先する。例は
reporting.mdを参照し、未確認の候補を実行可能と断定しない - 追加権限が調査を妨げる場合: 必要な操作と対象を示す。ポリシー JSON や依頼文は、依頼または運用手順に必要なものを用意する