agentsclimarketplace
Sign in

Audit cost

Skill hirokimry/vibecorp/skills/audit-cost

CFO による週次コスト監査。直近7日間の変更からコスト影響を分析し、 `knowledge/accounting/audit-log/YYYY-QN.md` に追記 + `audit-log-index.md` に 1 行サマリ追記する。full プリセット限定。 「/audit-cost」「コスト監査」と言った時に使用。From its SKILL.md

Install
npx -y skills add hirokimry/vibecorp --skill audit-cost

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

11.8 KB, as published. Nobody here has run it

💰 週次コスト監査

[!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

Keep looking

Skills are one crate of 627,801. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.