hirokimry/audit-cost

💰 週次コスト監査

[!IMPORTANT] このスキルは CFO エージェントを呼び出し、直近 1 週間の変更から コスト影響を分析 する。 監査レポートは knowledge/buffer worktree 経由で main に反映する（作業ブランチ直書きは protect-knowledge-direct-writes.sh フックで deny）。 full プリセット専用。モデル指定の自動変更は行わない（CFO は警告のみ）。

CFO エージェントによる週次コスト監査を自動化する。監査レポートは knowledge/accounting/ に保存する。異常検出時は Issue を起票する。

📋 前提条件

| 項目 | 条件 | |---|---| | プリセット | full プリセット専用（CFO エージェントが必要） | | エージェント | CFO エージェント定義（.claude/agents/cfo.md）が配置済み | | テンプレ | knowledge/accounting/cost-audit-template.md が存在 |

🔄 ワークフロー

1. プリセット確認

awk '/^preset:[[:space:]]*/ { sub(/^preset:[[:space:]]*/, ""); print; exit }' .claude/vibecorp.yml

full 以外の場合は「/vibecorp:audit-cost は full プリセット専用です」と報告して終了する。

1.5. buffer worktree の準備

監査レポートは knowledge/buffer worktree 経由で main に反映する（docs/specification.md の「自動反映フロー」原則）。作業ブランチへの直書きは protect-knowledge-direct-writes.sh フックで deny される。

. "$CLAUDE_PROJECT_DIR/.claude/lib/knowledge_buffer.sh"
knowledge_buffer_ensure || { echo "[audit-cost] buffer 準備失敗。作業ブランチへの直書きはフックで deny されるため処理を中止" >&2; exit 1; }
knowledge_buffer_lock_acquire || { echo "[audit-cost] ロック取得失敗（${VIBECORP_LOCK_TIMEOUT:-60}s）" >&2; exit 2; }
trap knowledge_buffer_lock_release EXIT
BUFFER_DIR="$(knowledge_buffer_worktree_dir)"

2. 監査範囲取得

直近 7 日間の変更を取得する。

git log --since="7 days ago" --oneline

git diff "@{7 days ago}"..HEAD --stat

コミット数が 0 件の場合は「監査対象期間に変更なし」とレポートし、空の監査ファイルを生成して終了する。

3. CFO エージェント起動

CFO エージェントに以下を渡して起動する（Agent ツール）。プロンプトは skills/audit-cost/prompts/agent-call-cfo-monthly-audit.md を参照する。

🔍 モデル指定監査の判定ガイド

走査対象: agents/*.md（配布元・優先）および .claude/agents/*.md（導入先上書き）。 各エージェントの YAML フロントマター model: 行を抽出し、役割と単価（docs/cost-analysis.md の「モデル単価」表）を突き合わせる。判定区分は以下のとおり。

判断品質が存在意義のロール（C-suite + 合議制の分析員 + プロセス管理）

対象エージェント: cfo, cto, cpo, clo, ciso, accounting-analyst, legal-analyst, security-analyst, sm

sm（Scrum Master）は .claude/rules/roles.md で「並列/直列の実行判定・ブロッカー検出・次タスク提案」を担うプロセス管理の専門家として定義されており、判断品質が存在意義のロールに含める。

| 指定 | 判定 | |---|---| | 推奨: Opus または Sonnet | 妥当 | | Haiku 指定 | Major 指摘（品質劣化リスク。メタレビュー・合議・プロセス判断の品質が落ちる） | | Sonnet 指定で Opus が望ましいケース | Minor 指摘（CFO が文脈で判定） | | モデル未指定（親から継承） | Minor 指摘（明示推奨） |

定型作業ロール（自動化エージェント）

対象エージェント: branch, commit, pr, plan-architect, plan-cost, plan-dx, plan-legal, plan-performance, plan-security, plan-testing

| 指定 | 判定 | |---|---| | 推奨: Sonnet または Haiku | 妥当（定型作業に十分） | | Opus 指定 | Major 指摘（過剰指定。docs/cost-analysis.md の「プリセット別の想定運用モード」で full プリセットの並列度が高くコスト超過リスクが大きい） | | モデル未指定 | Minor 指摘 |

直近 7 日間の Diff 抽出

model: 行が変更された箇所をレポートに添付する。

git log --since="7 days ago" -p -- 'agents/*.md' '.claude/agents/*.md' | grep -E '^[+-]model:|^diff --git'

判定が「妥当」のロールはサマリ件数のみ記載し、警告対象（Major / Minor）のみ詳細を出力する。

4. レポート保存（四半期集約 + index 追記）

CFO の出力を buffer worktree 内 の ${BUFFER_DIR}/.claude/knowledge/accounting/audit-log/YYYY-QN.md に 追記 する（既存 entry の末尾に追記）。さらに audit-log-index.md に 1 行サマリを追記する。

today=$(date -u +%Y-%m-%d)
year=$(date -u +%Y)
month=$(date -u +%m)
# 10#$month で 8 進数解釈を回避（08/09 が無効になる問題対策）
quarter=$(( (10#$month - 1) / 3 + 1 ))
target="${year}-Q${quarter}"

mkdir -p "${BUFFER_DIR}/.claude/knowledge/accounting/audit-log"
audit_file="${BUFFER_DIR}/.claude/knowledge/accounting/audit-log/${target}.md"
index_file="${BUFFER_DIR}/.claude/knowledge/accounting/audit-log/audit-log-index.md"

# 四半期ファイルがなければ初期化（初回作成時）
if [ ! -f "$audit_file" ]; then
  printf '# 経理監査ログ — %s\n\n`/vibecorp:audit-cost` および `accounting-analyst` 合議結果のアーカイブ。\n\n---\n\n' "$target" > "$audit_file"
fi

# index がなければ templates から初期化
# 既存導入先（.claude/）を優先し、無ければ配布元（templates/）から複製する。
# `2>/dev/null || cp ...` のフォールバックは docs/design-philosophy.md のフォールバック
# 禁止ルール違反のため、明示的な存在チェックで分岐する。
if [ ! -f "$index_file" ]; then
  installed_index=".claude/knowledge/accounting/audit-log/audit-log-index.md"
  template_index="templates/claude/knowledge/accounting/audit-log/audit-log-index.md"
  if [ -f "$installed_index" ]; then
    if ! cp "$installed_index" "$index_file"; then
      echo "[audit-cost] index 初期化失敗: ${installed_index} → ${index_file}（権限・容量等を確認）" >&2
      exit 4
    fi
  elif [ -f "$template_index" ]; then
    if ! cp "$template_index" "$index_file"; then
      echo "[audit-cost] index 初期化失敗: ${template_index} → ${index_file}（権限・容量等を確認）" >&2
      exit 4
    fi
  else
    echo "[audit-cost] audit-log-index.md テンプレートが見つかりません。導入先と配布元の両方を確認してください: ${installed_index} / ${template_index}" >&2
    exit 4
  fi
fi

その後、CFO の出力内容を ${audit_file} に統一書式（## YYYY-MM-DD — Issue #N — /vibecorp:audit-cost 見出し）で追記し、${index_file} の ## 索引 セクション直後に 1 行サマリを追加する。

追記書式:

## YYYY-MM-DD — Issue #N — /vibecorp:audit-cost

### 監査範囲
（CFO 出力の本文）

index 1 行サマリ書式:

- YYYY-MM-DD — Issue #N — `/vibecorp:audit-cost` Critical N / Major N / Minor N

4.5. C*O フォールバック警告の検知

CFO の出力に ### 判断記録（記録先取得失敗） セクションが含まれる場合、CFO の自前 buffer 取得が失敗している。判断内容を結果レポート末尾の「⚠️ 手動反映が必要な判断記録」ブロックに転記し、ユーザーに docs/migration-knowledge-buffer.md の手順での手動反映を促す。

# 現在実行分の CFO 出力のみを検査する。
# 四半期集約後は audit_file に過去 fallback エントリが残っている可能性があるため、
# audit_file 全体走査による誤検知を避ける。
if echo "$cfo_output" | grep -q '^### 判断記録（記録先取得失敗）$'; then
  fallback_warning=1
fi

4.6. buffer commit + push

knowledge_buffer_commit は差分なしを成功扱い（exit 0）するため || true は不要。実際の git エラーを握り潰さないために、commit 失敗時は push を中止する。

push_status="success"
if ! knowledge_buffer_commit "chore(knowledge): audit-cost ${today}"; then
  echo "[audit-cost] commit 失敗。push は中止します。buffer 内容を確認してください: ${BUFFER_DIR}" >&2
  push_status="failed (commit 失敗)"
elif ! knowledge_buffer_push; then
  echo "[audit-cost] push 失敗。commit は ${BUFFER_DIR} に保持。手動 push: git -C ${BUFFER_DIR} push origin knowledge/buffer" >&2
  push_status="failed (worktree に保持)"
fi

5. 異常検出時の Issue 起票

Critical または Major 指摘がある場合、/vibecorp:issue スキルで Issue を起票する。

| 項目 | 値 | |---|---| | ラベル | audit, cost | | タイトルプレフィックス | [audit-cost] | | 本文 | 監査レポートのサマリ + レポートファイルへのリンク |

Minor のみの場合は起票しない（レポート保存のみ）。

6. 結果レポート

## /vibecorp:audit-cost 完了

### 監査範囲
- 期間: YYYY-MM-DD 〜 YYYY-MM-DD
- コミット数: N
- 変更ファイル数: N

### 指摘サマリ
- Critical: N 件
- Major: N 件
- Minor: N 件

### 出力
- レポート: ${BUFFER_DIR}/.claude/knowledge/accounting/audit-log/YYYY-QN.md（追記）
- index: ${BUFFER_DIR}/.claude/knowledge/accounting/audit-log/audit-log-index.md（1 行サマリ追記）
- 起票 Issue: {URL} / なし

### 出力ステータス
- レポート保存: 成功 / 失敗
- buffer commit: 成功 / 失敗（差分なしスキップ）
- buffer push: 成功 / 失敗（失敗時は ${BUFFER_DIR} に保持。手動 push 手順を出力）

### ⚠️ 手動反映が必要な判断記録（CFO フォールバック発動時のみ）
{CFO 出力の「### 判断記録（記録先取得失敗）」セクションをここに転記}
→ docs/migration-knowledge-buffer.md の手順で手動反映してください

⏰ 定期実行

/schedule または cron で週次実行する。

# 毎週月曜 09:00 JST に実行
/schedule weekly "0 0 * * 1" /vibecorp:audit-cost

⚠️ 制約

• コード変更は一切行わない — 監査レポートと Issue 起票のみ。
• モデル指定の自動変更は行わない — CFO は警告のみ。model: 行の書き換えは人間または /vibecorp:ship 経由で行う。
• git add / git commit / git push は knowledge_buffer_* ヘルパー経由でのみ実行する（buffer worktree 内に限定）。
• 作業ブランチには直書きしない（protect-knowledge-direct-writes.sh フックで deny される）。
• --force、--hard、--no-verify は使用しない。
• jq では string interpolation \(...) を使わない — 必ず + で結合する。
• コマンドをそのまま実行する — 2>/dev/null、|| echo、; echo 等のリダイレクトやフォールバックを付加しない。

🔗 関連ルール

• 自律実行不可領域: .claude/rules/autonomous-restrictions.md
• レビュー観点（intent 別）: .claude/rules/review-observations.md
• プロンプト作成基準: .claude/rules/prompt-writing.md
• マークダウン規約: .claude/rules/markdown.md
• シェル規約: .claude/rules/shell.md