eng-evaluation
概要
GitHub 上の PR・Issue・レビューコメントを分析し、エンジニアの四半期レビュー資料（Markdown）を自動生成する Claude Code Plugin。1on1 や評価面談の「たたき台」として使う。
前提条件
- Claude Desktop（最新版）または Claude Code CLI
- GitHub Personal Access Token（後述のスコープが必要）
- Node.js 18 以上（
@github/mcp-server の実行に必要）
セットアップ
1. GitHub Personal Access Token を取得する
- GitHub → Settings → Developer settings → Personal access tokens → Fine-grained tokens
- 「Generate new token」をクリック
- 以下の Repository permissions を付与：
Pull requests: Read-onlyIssues: Read-onlyMetadata: Read-only（自動付与）
- トークン文字列（
github_pat_...）をコピーして控えておく
Classic token を使う場合は repo スコープを付与する。
2. 環境変数を設定する
MCP サーバーが起動時に GITHUB_TOKEN を読み込む。Claude Desktop を起動する前に シェルに設定しておく。
macOS / Linux
# ~/.zshrc または ~/.bashrc に追記
export GITHUB_TOKEN=github_pat_xxxxxxxxxxxx
# 反映
source ~/.zshrc
Windows
システムのプロパティ → 環境変数 → ユーザー環境変数 に
GITHUB_TOKEN = github_pat_xxxxxxxxxxxx
を追加し、Claude Desktop を再起動する。
.mcp.json 内の "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}" が、
この環境変数を MCP サーバーに渡す仕組みになっている。
3. プラグインをインストールする
Claude Desktop の Plugin Manager から（推奨）
- Claude Desktop を開く
- 左サイドバーの Plugins パネルを開く
- 「Import from Directory」を選択し、このリポジトリのルートフォルダを指定
- インストール完了後、プラグイン一覧に
eng-evaluation が表示される
Claude Code CLI から
# このリポジトリをクローンしてからインストール
git clone https://github.com/your-org/eng-evaluation.git
claude plugin install ./eng-evaluation
# インストール確認
claude plugin list
ZIP から
- このリポジトリを ZIP でダウンロード（GitHub → Code → Download ZIP）
- ZIP を展開
- Claude Desktop の Plugin Manager → 「Import from ZIP」で指定
4. MCP サーバーの接続を確認する
Claude Desktop または Claude Code CLI を起動し、以下を入力：
/mcp
github サーバーが Connected と表示されれば設定完了。
表示されない・エラーが出る場合:
# 環境変数が設定されているか確認
echo $GITHUB_TOKEN
# npx で GitHub MCP サーバーが動くか確認
npx -y @github/mcp-server --help
# Claude Code CLI のデバッグモード
claude --debug
使い方
プラグインを有効にした状態でコマンドを実行する：
/eng-evaluation:quarterly-review <github-username> [owner/repo1,owner/repo2] [YYYY-QN]
| 引数 | 必須 | 説明 | 例 |
|---|
github-username | 必須 | 対象者の GitHub ユーザー名 | octocat |
owner/repo | 省略可 | リポジトリ（カンマ区切りで複数可） | anthropics/claude-code |
YYYY-QN | 省略可 | 期間（省略時は直近3ヶ月） | 2025-Q4 |
実行例:
# ユーザー名のみ
/eng-evaluation:quarterly-review octocat
# リポジトリ指定
/eng-evaluation:quarterly-review octocat anthropics/claude-code
# 期間指定
/eng-evaluation:quarterly-review octocat anthropics/claude-code 2025-Q4
# 複数リポジトリ
/eng-evaluation:quarterly-review octocat anthropics/claude-code,anthropics/anthropic-sdk-python 2025-Q4
出力ファイルは {ユーザー名}-review-{期間}.md として保存される。
ファイル構成
eng-evaluation/
├── .claude-plugin/
│ └── plugin.json # Plugin マニフェスト（名前・バージョン・説明）
├── .mcp.json # GitHub MCP サーバー接続設定
├── commands/
│ └── quarterly-review.md # /quarterly-review コマンド定義
└── skills/
└── SKILL.md # 評価観点と出力テンプレート（Claude が自動参照）
各ファイルの役割
| ファイル | 役割 |
|---|
.claude-plugin/plugin.json | プラグインの名前・バージョン・説明を定義する Manifest |
.mcp.json | GitHub MCP サーバーの接続設定 |
commands/quarterly-review.md | /quarterly-review コマンドの手順と引数定義 |
skills/SKILL.md | 評価軸・出力テンプレート・注意事項（コマンド実行時に自動参照） |
ZIP の作り方（claude.ai アップロード用）
claude.ai の Plugin Manager へアップロードする ZIP は、以下の構成が必要：
eng-evaluation/ ← トップレベルフォルダ必須
├── .claude-plugin/
│ └── plugin.json
├── .mcp.json
├── README.md
├── SKILL.md ← トップレベル直下に配置
└── commands/
└── quarterly-review.md
作成コマンド（macOS / Linux）:
# 作業ディレクトリを準備
mkdir -p /tmp/eng-evaluation/.claude-plugin /tmp/eng-evaluation/commands
# ファイルをコピー
cp .claude-plugin/plugin.json /tmp/eng-evaluation/.claude-plugin/
cp .mcp.json /tmp/eng-evaluation/
cp README.md /tmp/eng-evaluation/
cp skills/SKILL.md /tmp/eng-evaluation/SKILL.md
cp commands/quarterly-review.md /tmp/eng-evaluation/commands/
# ZIP を作成
cd /tmp && zip -r ~/Downloads/eng-evaluation.zip eng-evaluation
# 作業ディレクトリを削除
rm -rf /tmp/eng-evaluation
注意: zip -r は既存の ZIP に追記するため、事前に古い ZIP を削除しておく。
rm -f ~/Downloads/eng-evaluation.zip
カスタマイズ例
評価軸を追加する
skills/SKILL.md の「5つの評価軸」セクションに追記する：
### 6. テスト貢献
- テストファイルへの変更行数の比率
- CI 失敗率の変化
対象リポジトリをデフォルト固定する
commands/quarterly-review.md の引数説明を変更する：
- `$ARGUMENTS[1]`（省略可）: リポジトリ名（省略時は `your-org/your-repo` を対象）