コードベース分析ツール

本番環境で機能が正しく動作していない理由を特定するため、コードベース全体とデプロイメントパイプラインの包括的な深層分析を実行します。アーキテクチャ、認証、ファイルレベルの接続、デプロイメント、CI/CDパイプライン、安定性向上など、アプリケーションのすべての側面にわたって体系的な調査を実施します。

このスキルを使用する場合

以下の場合にこのスキルを使用してください:

• 本番環境にデプロイされたアプリケーション機能が正しく動作していない
• コードベース全体の包括的な深層分析が必要
• 本番環境での認証システムの問題
• デプロイメントパイプラインのデバッグが必要
• 自動テストのためのCI/CDセットアップが必要
• 安定性向上とリファクタリング提案が必要
• ファイルレベルおよび行レベルの接続監査が必要

スキルの実行方法

フェーズ1: コードベースアーキテクチャの完全分析を実施

1. プロジェクト構造全体を分析
2. 以下を特定:
   • フロントエンドフレームワークとアーキテクチャ
   • バックエンドフレームワークとアーキテクチャ
   • データベースタイプと接続方法
   • 認証システムの実装
   • API通信パターン
   • 環境設定(.envの使用)
   • デプロイメント設定
3. 以下を示す明確なアーキテクチャマップを作成:
   • フロントエンドがバックエンドと通信する方法
   • バックエンドがデータベースと通信する方法
   • 認証がシステム全体でどのように流れるか

フェーズ2: 認証システムの深層トレースを実行

1. 以下を特定:
   • ログインルート
   • 登録ルート
   • トークン生成ロジック
   • トークン検証ミドルウェア
   • セッションまたはJWT処理
   • パスワードハッシュ方法
   • Cookie処理(存在する場合)
2. 認証フローをステップバイステップでトレース:
   • ユーザーがログインフォームを送信(フロントエンド)
   • バックエンドにリクエスト送信
   • バックエンドが認証情報を処理
   • トークンを作成
   • トークンをフロントエンドに返却
   • トークンを保存(localStorage/cookies)
   • 保護されたルートにアクセス
3. 以下をチェック:
   • CORSの問題
   • fetch/axiosで認証情報が不足している
   • ベースURLが間違っている
   • 環境変数の設定ミス
   • 本番環境と開発環境の違い
   • ミドルウェアが不足している
   • トークン期限切れ
   • シークレットキーが間違っている
   • APIルートのミスマッチ

フェーズ3: ファイルレベルおよび行レベルの接続監査を実行

1. すべてのimport/exportをチェック
2. 以下を確認:
   • すべてのAPIルートがフロントエンドの呼び出しと一致している
   • すべてのコントローラーが適切に接続されている
   • すべてのミドルウェアが適用されている
   • データベースモデルが適切に登録されている
   • 循環依存が存在しない
3. デッドコードや未使用関数を特定
4. 実行時のみ本番環境で発生するエラーを検出

カテゴリ分けした問題リストを提供:

• 重大
• 主要
• 軽微

フェーズ4: デプロイメント・本番環境デバッグを実行

以下を分析:

• ビルドプロセス
• ホスティングプラットフォーム内の環境変数
• バックエンドサーバー設定
• リバースプロキシ(存在する場合)
• ポートバインディング
• 本番環境ログ
• CORS本番環境ポリシー
• HTTPSの問題

ローカルでは動作するが、デプロイ後に失敗する理由を説明してください。

フェーズ5: 自動テスト用CI/CDパイプラインセットアップの実装

以下を実装するCI/CDソリューション:

1. 以下のタイミングで自動的にテストを実行:
   • すべてのプッシュ時
   • すべてのプルリクエスト時
2. テスト内容:
   • APIエンドポイント
   • 認証フロー
   • データベース接続
   • 環境変数の検証
   • フロントエンドビルド成功
3. テスト失敗時はデプロイメントを中止
4. リンティングと型チェックを実行
5. バックエンドが正常に起動できることを確認
6. フロントエンドがエラーなくビルドできることを確認

以下を提供:

• GitHub Actions(またはCI プロバイダー)の推奨設定
• ワークフローYAMLファイルの例
• テスト構造の提案
• テストライブラリの提案

フェーズ6: 安定性向上計画を作成

以下を作成:

1. リファクタリング提案
2. セキュリティ向上
3. ロギング向上
4. 監視提案
5. エラーハンドリング向上
6. 推奨される本番環境グレードのベストプラクティス

利用可能なリソース

• 自動コードベース分析にはscripts/codebase_analysis.pyを実行
• 一般的な本番環境の問題とデバッグパターンについてはreferences/production_debugging.mdを参照
• CI/CDワークフローのテンプレートとしてassets/github-workflow.ymlを使用

重要なガイドライン

• 一般的なアドバイスは提供しない
• 実際のコードを深く分析する
• 根本原因を明確に説明する
• コード例を含めて修正を提供する
• 体系的かつ構造化されている
• 本番環境固有の問題に焦点を当てる
• 機能を妨げる重大な問題を優先する
• 環境固有の設定を特定する
• すべてのシステムコンポーネントの包括的なカバレッジを確保する