code-auditor

コード監査

アーキテクチャ、コード品質、セキュリティ、パフォーマンス、テスト、保守性を網羅したコードベース分析です。

使用する場面

• 「コードを監査して」
• 「コード品質を分析して」
• 「問題がないか確認して」
• 「コードベースをレビューして」
• 「技術的負債を見つけて」
• 「セキュリティ監査」
• 「パフォーマンスレビュー」

分析対象

1. アーキテクチャと設計

• 全体的な構造と構成
• 使用されている設計パターン
• モジュールの境界と関心の分離
• 依存関係の管理
• アーキテクチャ上の決定とトレードオフ

2. コード品質

• 複雑さのホットスポット（循環的複雑度）
• コードの重複（DRY 違反）
• 命名規則と一貫性
• ドキュメントの網羅率
• コードの臭いとアンチパターン

3. セキュリティ

• 一般的な脆弱性（OWASP Top 10）
• 入力の検証とサニタイズ
• 認証と認可
• シークレットの管理
• 依存関係の脆弱性

4. パフォーマンス

• アルゴリズムの計算量に関する問題
• データベースクエリの最適化
• メモリ使用パターン
• キャッシュの活用機会
• リソースリーク

5. テスト

• テストカバレッジの評価
• テストの品質と有効性
• 不足しているテストシナリオ
• テストのパターンとプラクティス
• 統合テストと単体テストのバランス

6. 保守性

• 技術的負債の評価
• 結合度と凝集度
• 将来的な変更のしやすさ
• 新規参加者にとっての使いやすさ
• ドキュメントの品質

アプローチ

1. Explore エージェントを使用して調査します（徹底モード）
2. Grep と Glob でパターンを特定します
3. 重要なファイルを読み、詳細に分析します
4. 利用可能であれば、静的解析ツールを実行します
5. 調査結果を実行可能なレポートにまとめます

詳細度

• クイック（15～30 分）：概要レベルで、重大な問題のみ
• 標準（30～60 分）：すべての観点を包括的に分析
• 詳細（60 分以上）：詳細な例を含む徹底的な分析

出力形式

# Code Audit Report

## Executive Summary
- Overall health score
- Critical issues count
- Top 3 priorities

## Findings by Category

### Architecture & Design
#### 🔴 High Priority
- [Finding with file:line reference]
  - Impact: [description]
  - Recommendation: [action]

#### 🟡 Medium Priority
...

### [Other categories]

## Prioritized Action Plan
1. Quick wins (< 1 day)
2. Medium-term improvements (1-5 days)
3. Long-term initiatives (> 5 days)

## Metrics
- Files analyzed: X
- Lines of code: Y
- Test coverage: Z%
- Complexity hotspots: N

使用ツール

• Task（Explore エージェント）：コードベースを徹底的に調査
• Grep：問題のパターンマッチング
• Glob：種類やパターンでファイルを検索
• Read：ファイルの詳細分析
• Bash：リンターやカバレッジツールを実行

成功基準

• 6 つすべての観点を包括的に網羅
• すべての調査結果に具体的なファイル名と行番号を記載
• 重大度／優先度の評価（重大／高／中／低）
• 実行可能な推奨事項（単なる所見ではない）
• 修正に必要な作業量の見積もり
• すぐに対応できる改善と長期的な改善の両方

連携

• feature-planning：技術的負債の削減を計画
• test-fixing：特定されたテストの不足に対処
• project-bootstrapper：品質管理ツールをセットアップ

設定

特定の領域に絞って分析できます。

• セキュリティのみの監査
• パフォーマンスのみの監査
• テストのみの評価
• 簡易アーキテクチャレビュー