audit_driven_feedback_skill
IchikawaYoshihiro/audit_driven_feedback_skill
監査(audit)による リコンシリエーションループで継続的に検知・修正する方法論を、Claude Code / Claude Agent SDK の汎用スキルに落とし込んだものです。
Instalação
npx convez-ai IchikawaYoshihiro/audit_driven_feedback_skill1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
audit-driven-feedback skill
AI エージェント主体の開発で生じる silent integrity drift(沈黙の整合性ドリフト) ―― 配線漏れ・ドキュメントドリフト・設定ズレ・認可の付け忘れ・データ不変条件の破壊など、 テストもレビューも通るのに本番で静かに壊れる類の欠陥 ―― を、監査(audit)による リコンシリエーションループで継続的に検知・修正する方法論を、Claude Code / Claude Agent SDK の汎用スキルに落とし込んだものです。
言語・フレームワーク非依存。Laravel / Rails / FastAPI / Go / TypeScript いずれにも適用できます。
これは何をするスキルか
ユーザーが「整合性ガードレールを入れたい」「ポストモーテムを自動チェック化したい」 「AI に実装を任せると配線漏れが怖い」といった相談をしたときに発火し、次の一連を支援します。
- Inventory — 新しい監査を足す前に、既存の監査・テスト・CI ゲートを棚卸し
- Diagnose — 7分類(Parity / Wiring / Data / Docs / Config / Architecture / Process)で何を監査すべきか特定
- Prioritize — 監査を増やしすぎない。実際の事故から1本ずつ育てる
- Implement — 良い監査の5条件(全件列挙・決定的・非ゼロ終了・実行可能メッセージ・例外allowlist)
- Wire — CI(予防)+ 定期実行(回復)の二段配線
- Close the loop — 検知 → 修正 → 再監査。次の事故はまた監査になって返ってくる
設計思想は GitOps / Kubernetes コントローラの reconciliation(望ましい状態への収束)を、 インフラ運用からアプリ開発工程そのものへ拡張したものです。
構成
audit-driven-feedback/
├── SKILL.md # 方法論 + 6ステップのワークフロー(エントリポイント)
├── references/
│ ├── audit-types.md # 7分類ごとの検出レシピ(何を全件列挙し、何と比較するか)
│ └── audit-cookbook.md # 良い監査の作法・CI/定期の配線・運用アンチパターン
└── evals/
└── evals.json # 評価セット(4ケース × 4軸:分類精度/過剰監査抑制/ループ閉鎖/二段配線)
インストール(Claude Code)
パーソナルスキルとして使う場合、audit-driven-feedback/ ディレクトリを
スキル探索パス(~/.claude/skills/)に置きます。
方法 A: Release の zip を使う(推奨)
Releases
から最新の audit-driven-feedback-vX.Y.Z.zip をダウンロードし、展開して中の
audit-driven-feedback/ ディレクトリを skills フォルダへコピーします。
# 例: 展開後
# macOS / Linux
cp -r audit-driven-feedback ~/.claude/skills/
# Windows (PowerShell)
Copy-Item -Recurse audit-driven-feedback "$env:USERPROFILE/.claude/skills/"
方法 B: リポジトリを clone する
git clone git@github.com:IchikawaYoshihiro/audit_driven_feedback_skill.git
# macOS / Linux
cp -r audit_driven_feedback_skill/audit-driven-feedback ~/.claude/skills/
# Windows (PowerShell)
Copy-Item -Recurse audit_driven_feedback_skill/audit-driven-feedback "$env:USERPROFILE/.claude/skills/"
以後、整合性ドリフト・監査・ガードレール関連の相談で自動的に発火します。
背景記事
このスキルは Zenn 記事の方法論を実践手順化したものです。記事が思想、スキルが実践手順、
evals/ が再現性確認、という3点セットで構成されています。
📝 AIエージェント時代の品質保証 ― 監査駆動フィードバック開発という考え方
開発 / リリース
- lint:
tools/lint_skill.pyがスキルフォーマット(name/descriptionの制約、 enum・boolean フィールド、ディレクトリ名一致、本文の相対リンク参照切れ等)を検査します。 PR /mainへの push で CI が自動実行します。手元ではpython tools/lint_skill.py(要pip install pyyaml)。 - release:
vX.Y.Z形式のタグを push すると、CI が lint を通したうえでaudit-driven-feedback-vX.Y.Z.zipをビルドし、GitHub Release に添付します。 バージョンはタグで管理します(初回はv1.0.0)。
git tag v1.0.0
git push origin v1.0.0 # → Actions が Release を発行
ライセンス
MIT