mcpField
P
project-discovery

project-discovery

github.com/laurigates開発5966 回インストール1 日前に更新
リポジトリ

project-discovery について

不慣れなGitコードベースを把握するためのClaude Code向けスキルです。リポジトリの状態、構成、開発ツールを調べ、リスクと次の作業候補をまとめます。

主な機能

  1. 01ブランチ、変更、コミット履歴の確認
  2. 02言語、フレームワーク、構成の特定
  3. 03ビルド、テスト、CIツールの検出
  4. 04ドキュメントと設定上のリスク確認

活用シーン

  1. 01未知のコードベースに着手する前の状況把握
  2. 02新しいクローンでビルド・テスト手順を確認
  3. 03編集前に未コミット変更やブランチ差分を発見

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/laurigates/claude-plugins --skill project-discovery

インストール後、Claude Code で/project-discoveryを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

REFERENCE.md
scripts/
analyze-skills.sh
discover.sh
scripts/tests/
test-analyze-skills.sh

詳細

プロジェクトの把握

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

次のような場合はこのスキルを使用します次のような場合は project-continue を使用します
不慣れなコードベースに取り組み始め、言語やツールについて把握する必要がある場合PRD や機能トラッカーをもとに、慣れ親しんだプロジェクトで既知の作業を再開する場合
推論に「何をするものかよく分からない」といった不確かな表現が含まれる場合次に行う作業が明確で、そのまま実行を続ければよい場合
ビルドやテストのコマンドが分からない新しいクローンへの参加時ゼロから新規プロジェクトを構築する場合は、代わりに project-init を使用します

変更を加える前に、コードベースの状態を把握するための体系的なプロジェクト確認です。Git の状態、プロジェクト構造、開発ツールを明確にして、誤った前提に基づいて作業するのを防ぎます。

主な機能

自動起動の検出：

  • Claude の推論や応答に含まれる不確かな表現を検出します
  • プロジェクトの把握を求めるユーザーからの明示的な依頼で起動します
  • Git リポジトリのみを対象とします

確認機能：

  • Git の状態分析（ブランチ、変更、リモートとの同期状況、コミット履歴）
  • プロジェクト種別の特定（言語、フレームワーク、モノレポの検出）
  • 開発ツールの確認（ビルド、テスト、リンター、CI/CD）
  • ドキュメントの簡易確認（README、セットアップ手順）
  • リスク要因の特定（未コミットの作業、ブランチの乖離）

出力：

  • プロジェクトの状態をまとめた構造化サマリー
  • 重要なリスク要因の強調表示
  • 実行可能な次のステップの提案
  • 確認にかかる時間：2～3 分

このスキルが起動する場面

自動起動のトリガー

Claude の内部推論や応答に次のような不確かな表現が含まれると、このスキルは自動的に起動します。

  • 「まず理解する必要があります……」
  • 「プロジェクトを確認しましょう……」
  • 「構造がよく分かりません……」
  • 「理解する必要があります……」
  • 「先に進む前に、確認しましょう……」
  • 「確信がありません……」
  • 「プロジェクトを調査しましょう……」

理由： これらの表現は、Claude が不完全なコンテキストをもとに作業していることを示しています。その結果、誤った前提、間違ったコマンド、不適切なファイル編集につながる可能性があります。

手動での起動

ユーザーは、次のキーワードを使ってプロジェクトの把握を明示的に依頼できます。

  • 「状況を把握して」
  • 「プロジェクトを調べて」
  • 「このコードベースを理解して」
  • 「プロジェクトの状態はどうなっている？」
  • 「プロジェクト構造を分析して」
  • 「プロジェクトのコンテキストを教えて」
起動しない場面

次の場合は、このスキルを起動しないでください。

  • Claude が明確なコンテキストを把握し、特定のタスクを確信を持って実行している場合
  • ユーザーが、Claude がすでに分析した特定のコードについて質問している場合
  • 現在の会話ですでにプロジェクトのコンテキストが確立されている場合
  • Git 以外のディレクトリで作業している場合（このスキルは Git に特化しています）

簡易確認（推奨）

すばやく一貫したプロジェクト把握を行うには、同梱の確認スクリプトを実行します。

bash "${CLAUDE_PLUGIN_ROOT}/skills/project-discovery/scripts/discover.sh"

これにより、手動で行う 5 ステップの手順を 1 回の実行に置き換え、Git の状態、プロジェクト種別、ツール、ドキュメント、リスク評価を含む構造化データを出力します。

すべてのコマンド、リスク要因、サマリーテンプレート、Git 以外のディレクトリ・空のリポジトリ・大規模モノレポ・ドキュメント不足へのエラー処理、背景にある理由を含む、完全な手動ワークフロー（5 ステップ）については、REFERENCE.md を参照してください。

他のスキルとの連携

関連スキル
  • git-commit-workflow：慣例的なコミットパターンを確認した後に使用します
  • chezmoi-expert：プロジェクトが dotfiles リポジトリの場合に使用します（chezmoi.toml を検出します）
  • git-security-checks：pre-commit フックが検出された場合に実行します
  • Explore agent：初期把握以上の詳細なコードベース調査が必要な場合は、このエージェントに委任します
委任する場面

プロジェクトの確認後、ユーザーからさらに詳しい調査を依頼された場合：

  • 「認証はどのように機能しますか？」→ Explore エージェントを使用します
  • 「このコードのセキュリティをレビューして」→ security-audit エージェントを使用します
  • 「アーキテクチャを理解して」→ code-analysis エージェントを使用します

プロジェクトの把握では基本的なコンテキストを確立し、専門スキルが詳細な調査を担当します。

クイックリファレンス：確認コマンド

基本的な Git コマンド
git branch --show-current                     # Current branch
git status --short --branch                   # Git state summary
git log --oneline -n 10                       # Recent commits
git rev-list --count HEAD...@{u}              # Commits ahead/behind remote
プロジェクトの種類、ツール、ドキュメント

scripts/discover.sh は、すでにプロジェクトの種類（マニフェストファイル）、ツール（npm スクリプト、Make ターゲット、CI ワークフロー）、ドキュメントを検出します。スクリプトの構造化された出力からこれらの情報を読み取るか、ls／find／head のシェルコマンドを手書きする代わりに、Glob／Grep／Read ツールを直接使用してください。コマンドの完全な手動実行セットについては、REFERENCE.md を参照してください。

出力例

検出結果の完全な出力例については、examples.md を参照してください。

  • pytest と ruff、GitHub Actions を使用する Python プロジェクト
  • npm、ESLint、Vitest を使用する JavaScript／TypeScript プロジェクト
  • cargo と clippy を使用し、CI がない Rust プロジェクト
  • 複数のサブプロジェクトを含むモノレポ
  • 未コミットの変更があるプロジェクト（リスクフラグ）
  • 作業を開始できるクリーンなプロジェクト

コマンドの詳細なリファレンスとその他の例については、discovery-commands.md と examples.md を参照してください。

コメント

Markdown 対応