Kodo Analyzer スキル

既存プロジェクト向けの包括的なコードベース分析方法論。

目的

Kodo Analyzer システムは、体系的なコードベース分析を提供して、以下を実現します:

• 既存機能の推論とドキュメント化
• ギャップ、バグ、セキュリティ問題の識別
• カテゴリ別のヘルススコア計算
• 実行可能な推奨事項の生成
• 時間経過に伴うヘルスの傾向追跡

使用シーン

• 新規プロジェクトのオンボーディング(既存コードベース)
• 定期的なヘルスチェック
• リファクタリング前の評価
• セキュリティ監査
• ドキュメント生成
• 主要リリース前

アーキテクチャ

+-------------------------------------+
|     /kodo analyze Command           |
+-----------------+-------------------+
                  |
+-----------------v-------------------+
|   kodo-codebase-analyzer (Main)     |
|   - Orchestrates sub-agents         |
|   - Aggregates results              |
|   - Calculates health scores        |
+-----------------+-------------------+
                  |
    +-------------+-------------+
    |             |             |
+---v---+   +----v----+   +---v---+
| Group |   |  Group  |   | Group |
|   1   |   |    2    |   |   3   |
+---+---+   +----+----+   +---+---+
    |            |            |
+---v-------+ +--v--------+ +v------------+
| database  | | deps      | | security    |
| api       | | analytics | | performance |
| frontend  | | docs      | |             |
+-----------+ +-----------+ +-------------+

分析カテゴリ

1. データベース分析

• スキーマの品質と関連性
• RLS ポリシーカバレッジ
• インデックス最適化
• 未使用のテーブル/カラム検出
• マイグレーションのヘルス

2. API 分析

• エンドポイントインベントリ
• 認証カバレッジ
• エラーハンドリングパターン
• エッジ関数の候補
• ドキュメントのギャップ

3. フロントエンド分析

• コンポーネントインベントリ
• アクセシビリティコンプライアンス
• ステート管理パターン
• パフォーマンス上の懸念事項
• UI 一貫性

4. 依存関係分析

• 古いパッケージ
• セキュリティ脆弱性
• より良い代替案
• 未使用の依存関係
• ライセンスコンプライアンス

5. アナリティクス分析

• イベントカバレッジ
• 命名の一貫性
• フィーチャーフラグの使用
• ファネルの完全性
• ユーザー識別

6. ドキュメント分析

• カバレッジ評価
• コード-ドキュメント精度
• 陳腐化検出
• 品質メトリクス

7. セキュリティ分析

• 認証フロー
• 認可パターン
• 入力検証
• シークレット管理
• CORS 設定

8. パフォーマンス分析

• データベースクエリ最適化
• バンドルサイズ分析
• キャッシング戦略
• レンダリングパフォーマンス
• アセット最適化

出力構造

./docs/analysis/
├── summary.md           # 概要
├── database/
│   └── report.md
├── api/
│   └── report.md
├── frontend/
│   └── report.md
├── dependencies/
│   └── report.md
├── analytics/
│   └── report.md
├── documentation/
│   └── report.md
├── security/
│   └── report.md
└── performance/
    └── report.md

ヘルススコアリング

詳しい方法論は references/health-scoring.md を参照してください。

カテゴリ	ウェイト	スコア要因
Database	15%	RLS、インデックス、未使用検出
API	15%	認証、エラー、ドキュメント
Frontend	15%	A11y、ステート、パフォーマンス
Dependencies	10%	新規性、セキュリティ
Analytics	10%	カバレッジ、一貫性
Documentation	10%	カバレッジ、精度
Security	15%	認証、検証、シークレット
Performance	10%	クエリ、バンドル、キャッシング

問題分類

重大度の定義については references/issue-categories.md を参照してください。

• Critical: セキュリティ脆弱性、データ損失リスク
• High: バグ、認証なし、アクセシビリティ失敗
• Medium: パフォーマンス問題、コード品質
• Low: スタイルの不一貫性、軽微な改善

ワークフロー

ステップ 1: 初期化

kodo analyze              # 標準分析
kodo analyze --deep       # ディープモード: docs/ からの完全なコンテンツ + 学習の抽出
kodo analyze --deep --auto  # すべての検出結果を自動承認

ディープモード (--deep): 標準分析に加えて、ドキュメントから学習を抽出します:

• docs/ ディレクトリを再帰的にスキャン
• ルール、決定事項、テック・スタック選定、ワークフロー、ドメイン用語、規約を抽出
• .kodo/context-tree/ にコンテキストエントリを作成
• .kodo/learnings/ に学習を作成(カテゴリ別にグループ化)
• 設計ドキュメント(docs/plans/)に HIGH 信頼度を、継承ドキュメントに MEDIUM を割り当て

ステップ 2: 概要の確認

全体のヘルススコアと重大な問題を確認します。

ステップ 3: ドリルダウン

./docs/analysis/ のカテゴリ別レポートを確認します。

ステップ 4: 優先順位付け

優先順位付けマトリックスを使用します:

• 高インパクト + 低労力 = まず実施
• 重大な問題 = 直ちに対応

ステップ 5: 進捗追跡

# 傾向追跡のためコンテキストに保存
kodo curate --category analysis --title "Health Report $(date)"

ステップ 6: 再分析

定期的に分析を実行して改善を追跡します:

kodo analyze --quick  # 毎週
kodo analyze          # 毎月

統合

Kodo コンテキストストレージ

分析結果は .kodo/context/analysis/ に保存されます:

# 過去の分析をクエリ
kodo query "health score"
kodo query "security issues"
kodo query "performance bottlenecks"

機能ドキュメント

分析で機能を推論し、./docs/features/ に入力できます:

kodo analyze  # 機能ドキュメントも生成

設定

.kodo/config.json で分析設定を行います:

{
  "analyzer": {
    "analyzers": {
      "database": { "enabled": true },
      "api": { "enabled": true },
      "frontend": { "enabled": true },
      "dependencies": { "enabled": true },
      "analytics": { "enabled": true },
      "documentation": { "enabled": true },
      "security": { "enabled": true },
      "performance": { "enabled": true }
    },
    "output": {
      "directory": "./docs/analysis",
      "populateFeatureDocs": true
    },
    "thresholds": {
      "critical": 50,
      "warning": 70
    }
  }
}

ベストプラクティス

1. 新規プロジェクトで完全分析を実行 - ベースラインの確立
2. 毎週クイック分析を実行 - 回帰の検出
3. 重大な問題を直ちに修正 - セキュリティを最優先
4. 推奨事項をレビュー - すべてが適用されるわけではありません
5. ヘルストレンドを追跡 - 時間経過で比較
6. 高インパクト修正に焦点を当てる - 優先順位付けマトリックスを使用

エージェントモデル割り当て

エージェント	モデル	理由
kodo-codebase-analyzer	sonnet	オーケストレーション、複雑な判断
kodo-security-analyzer	sonnet	重大なセキュリティ分析
kodo-performance-analyzer	sonnet	複雑なパフォーマンスパターン
kodo-database-analyzer	haiku	直接的なスキーマ分析
kodo-api-analyzer	haiku	パターンベースのエンドポイント分析
kodo-frontend-analyzer	haiku	コンポーネントスキャン
kodo-dependencies-analyzer	haiku	パッケージチェック
kodo-posthog-analyzer	haiku	イベントトラッキング分析
kodo-documentation-analyzer	haiku	ドキュメントカバレッジチェック

関連コマンド

• /kodo analyze - 分析を実行
• /kodo analyze --deep - 完全なコンテンツ抽出 + 学習を含む分析を実行
• /kodo extract <file> - 単一ファイルから学習を抽出
• /kodo curate - コンテキストに分析を保存
• /kodo query - 過去の分析を検索
• /kodo reflect - 分析から学習をキャプチャ

参考資料

• references/health-scoring.md - スコア計算方法論
• references/issue-categories.md - 問題の重大度定義
• references/analysis-templates.md - 出力テンプレート