project-discovery について
project-discovery は、変更前にリポジトリを把握する開発スキルです。プロジェクトのファイルから実際の技術スタック、構造、規約、リスクを確認し、適切な次の手順を提案します。
主な機能
- 01プロジェクト種別とエントリーポイントの特定
- 02マニフェストとインポートから技術スタックを確認
- 03アーキテクチャと既存規約の整理
- 04リスクとテスト不足領域の特定
- 05現状に沿った最小限の計画を提案
活用シーン
- 01編集前のコードベース調査
- 02規約とリスク箇所の評価
- 03monorepo 内の作業範囲の特定
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/project-discoveryを入力して読み込まれたか確認します。
詳細
プロジェクトの調査
編集を始める前に、システムの構成を把握してください。リポジトリ内に根拠がないまま、構造的な変更を提案しないでください。
手順
- プロジェクトの種類を特定します：Web アプリ、API、モバイルアプリ、モノレポ、またはライブラリ。
- エントリーポイント、設定ファイル、ビルド／テスト／lint スクリプトを確認します。
- 推測ではなく、マニフェストとインポートから実際の技術スタックを把握します。
- ドメイン、レイヤー、境界（UI、API、データ、認証）ごとにフォルダーを把握します。
- 既存の規約（命名、状態管理、エラー処理、テスト、CI）を列挙します。
- 技術的負債、重要なファイル、テストのない領域などのリスクを列挙します。
- そのうえで、見つかった規約に沿った最小限の計画を提案します。
調査対象
- マニフェスト：
package.json、pnpm-workspace.yaml、Cargo.toml、Podfile、Package.swift、.xcodeproj - フレームワーク：Next.js、Vite、Expo、SwiftUI、Nest、Express、Prisma
- ルートとエントリーポイント：
app/、pages/、src/main、App.tsx、ContentView - データ：Prisma／Drizzle のスキーマ、マイグレーション、HTTP クライアント
- 認証とミドルウェア
- テストと CI：
*.test.*、Playwright、GitHub Actions - 環境変数とシークレット（値は公開しないでください）
最小限のレポート
簡潔な概要を提示します：
- 技術スタックとおおよそのバージョン
- アーキテクチャを 3～6 項目で説明
- 順守すべき規約
- リスクの高い箇所
- 推奨する次のステップ
ルール
- 汎用的なパターンの記憶より、ファイルに基づく根拠を優先します。
- ドキュメントとコードが矛盾する場合は、コードを優先します。
- 調査中に、ついでのリファクタリングを行わないでください。
- ローカルのスタイルを維持し、明示的な依頼がない限り、別のアーキテクチャを押し付けないでください。ユーザーが構成を求めた場合は、
software-architectureを参照します。 - モノレポの場合は、対象とするパッケージ／アプリを明示します。
完了条件
- 技術スタックとエントリーポイントを確認済み
- 主な規約を列挙済み
- リスクと重要な依存関係を特定済み
- 依頼に見合った変更計画を策定済み
コメント
Markdown 対応