mcpField
A
analyzing-projects

analyzing-projects

github.com/cloudai-x開発1.4k294 回インストール4 週間前に更新
リポジトリ

analyzing-projects について

Analyzing Projectsは、エージェントが不慣れなコードベースを調査したり、新しいプロジェクトを理解したりするためのスキルです。リポジトリ概要から技術スタック、構造、開発ワークフローまで順に確認し、最後に要約と検証チェックリストを作成します。

主な機能

  1. 016段階のプロジェクト分析を案内
  2. 02プロジェクトファイルから技術スタックを検出
  3. 03ディレクトリ構造と主要パターンを整理
  4. 04開発ワークフロー関連の設定を確認
  5. 05要約と検証チェックリストを作成

活用シーン

  1. 01不慣れなコードベースへのオンボーディング
  2. 02プロジェクト構造に関する質問への対応
  3. 03技術スタックと開発手順の記録

インストール

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

$npx skills add https://github.com/cloudai-x/claude-workflow-v2 --skill analyzing-projects

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

詳細

プロジェクトの分析

読み込むタイミング
  • トリガー：新しいプロジェクトへの参加、「これはどのように動作しますか」といった質問、コードベースの探索、見慣れないコードの理解
  • スキップ：プロジェクトの構成とパターンをすでに把握している場合

プロジェクト分析ワークフロー

このチェックリストをコピーし、進捗を記録してください。

Project Analysis Progress:
- [ ] Step 1: Quick overview (README, root files)
- [ ] Step 2: Detect tech stack
- [ ] Step 3: Map project structure
- [ ] Step 4: Identify key patterns
- [ ] Step 5: Find development workflow
- [ ] Step 6: Generate summary report

ステップ 1：概要の把握

# Check for common project markers
ls -la
cat README.md 2>/dev/null | head -50

ステップ 2：技術スタックの検出

パッケージマネージャーと依存関係
  • package.json → Node.js／JavaScript／TypeScript
  • requirements.txt ／ pyproject.toml ／ setup.py → Python
  • go.mod → Go
  • Cargo.toml → Rust
  • pom.xml ／ build.gradle → Java
  • Gemfile → Ruby
フレームワーク（依存関係から確認）
  • React、Vue、Angular、Next.js、Nuxt
  • Express、FastAPI、Django、Flask、Rails
  • Spring Boot、Gin、Echo
インフラストラクチャ
  • Dockerfile、docker-compose.yml → コンテナ化
  • kubernetes/、k8s/ → Kubernetes
  • terraform/、.tf ファイル → IaC
  • serverless.yml → Serverless Framework
  • .github/workflows/ → GitHub Actions

ステップ 3：プロジェクト構成の分析

注釈を付けてツリー形式で示してください。

project/
├── src/              # Source code
│   ├── components/   # UI components (React/Vue)
│   ├── services/     # Business logic
│   ├── models/       # Data models
│   └── utils/        # Shared utilities
├── tests/            # Test files
├── docs/             # Documentation
└── config/           # Configuration

ステップ 4：主要なパターンの特定

次の項目を確認して報告してください。

  • アーキテクチャ：モノリス、マイクロサービス、サーバーレス、モノレポ
  • API スタイル：REST、GraphQL、gRPC、tRPC
  • 状態管理：Redux、Zustand、MobX、Context
  • データベース：SQL、NoSQL、使用している ORM
  • 認証：JWT、OAuth、セッション
  • テスト：Jest、Pytest、Go test など

ステップ 5：開発ワークフロー

次の項目を確認してください。

  • .eslintrc、.prettierrc → リント／フォーマット
  • .husky/ → Git フック
  • Makefile → ビルドコマンド
  • package.json の scripts/ → NPM スクリプト

ステップ 6：出力形式

次のテンプレートを使って要約を作成してください。

# Project: [Name]

## Overview

[1-2 sentence description]

## Tech Stack

| Category  | Technology |
| --------- | ---------- |
| Language  | TypeScript |
| Framework | Next.js 14 |
| Database  | PostgreSQL |
| ...       | ...        |

## Architecture

[Description with simple ASCII diagram if helpful]

## Key Directories

- `src/` - [purpose]
- `lib/` - [purpose]

## Entry Points

- Main: `src/index.ts`
- API: `src/api/`
- Tests: `npm test`

## Conventions

- [Naming conventions]
- [File organization patterns]
- [Code style preferences]

## Quick Commands

| Action  | Command         |
| ------- | --------------- |
| Install | `npm install`   |
| Dev     | `npm run dev`   |
| Test    | `npm test`      |
| Build   | `npm run build` |

分析の検証

分析が完了したら、次の項目を確認してください。

Analysis Validation:
- [ ] All major directories explained
- [ ] Tech stack accurately identified
- [ ] Entry points documented
- [ ] Development commands verified working
- [ ] No assumptions made without evidence

確認できない項目があれば、レポートに「要確認」と記載してください。

コメント

Markdown 対応