Logical-codebase-audit-skill は何をしますか？
任意のコードベースの信頼性を監査し、12フェーズと21の書籍フレームワークを使って、幻の機能、スタブされた統合、誤った主張を検出するClaudeスキル。
概要
このスキルは、ソフトウェアプロジェクトのコードベースを体系的に検証し、以下の3つの主要な問題を特定します:
- 幻の機能: ドキュメントやプロモーション資料に記載されているが、コードベースに存在しない機能
- スタブされた統合: 外部サービスやAPIとの接続が宣言されているが、実際にはモックやスタブでしかない統合
- 誤った主張: コード内のコメント、変数名、関数名が実際の動作と矛盾している箇所
使用方法
Claude Code内で以下のコマンドを実行してください:
claude audit .
または、特定のディレクトリを指定:
claude audit path/to/project
監査フェーズ
監査は以下の12フェーズで構成されています:
- プロジェクトスキャン: コードベースの構造を分析
- ドキュメント分析: ドキュメントとコードの一致を確認
- 依存関係チェック: 使用されているライブラリの完全性を検証
- 関数シグネチャ検証: 関数の宣言と呼び出しの一致を確認
- API統合テスト: 外部APIとの統合が適切に実装されているか確認
- エラーハンドリング評価: エラー処理の一貫性を検証
- パフォーマンス監査: 性能に関する主張が実際の動作と一致するか確認
- セキュリティレビュー: セキュリティ上の問題を特定
- テストカバレッジ分析: テストとコードの対応を確認
- コメントとコードの一致検証: コメントが実際の動作を正しく説明しているか確認
- 設定ファイルの検証: 設定が実際の動作と一致するか確認
- 最終レポート生成: すべてのフェーズの結果をまとめたレポートを作成
フレームワーク
このスキルは以下の21の書籍から抽出されたフレームワークを基にしています:
- Clean Code - Robert C. Martin
- The Pragmatic Programmer - Andrew Hunt, David Thomas
- Refactoring - Martin Fowler
- Design Patterns - Gang of Four
- Working Effectively with Legacy Code - Michael Feathers
- Code Complete - Steve McConnell
- Test-Driven Development - Kent Beck
- Domain-Driven Design - Eric Evans
- Patterns of Enterprise Application Architecture - Martin Fowler
- Implementing Domain-Driven Design - Vaughn Vernon
- Building Microservices - Sam Newman
- The Art of Unit Testing - Roy Osherove
- Growing Object-Oriented Software, Guided by Tests - Steve Freeman, Nat Pryce
- Specification by Example - Gojko Adzic
- BDD in Action - John Ferguson Smart
- The DevOps Handbook - Gene Kim, Patrick Debois, John Willis
- Accelerate - Nicole Forsgren, Jez Humble, Gene Kim
- The Phoenix Project - Gene Kim
- The Unicorn Project - Gene Kim
- Site Reliability Engineering - Google
- The Checklist Manifesto - Atul Gawande
出力
監査結果は以下の形式で出力されます:
{
"phantom_features": [
{
"feature": "AI駆動の推奨エンジン",
"location": "docs/features.md:45",
"status": "実装されていません"
}
],
"stubbed_integrations": [
{
"integration": "Stripe決済",
"location": "src/payment/stripe.ts",
"status": "スタブ"
}
],
"misaligned_claims": [
{
"claim": "ユーザー認証はOAuth 2.0をサポート",
"location": "src/auth/README.md:12",
"actual": "基本認証のみ実装"
}
]
}
注意事項
- 監査には時間がかかる場合があります（コードベースのサイズ依存）
- 結果はあくまで静的解析に基づくものであり、動的テストの結果を保証するものではありません
- 誤検出（false positive）が発生する可能性がありますので、結果を注意深く確認してください