Claude自動化レコメンダー

Claude自動化レコメンダー は何をしますか？

コードベースのパターンを分析し、すべての拡張性オプションにわたってテーラーメイドのClaude Code自動化を推奨します。

このスキルは読み取り専用です。 コードベースを分析し、推奨事項を出力します。ファイルを作成したり変更したりすることはありません。ユーザーは推奨事項を自分で実装するか、別途Claudeに実装を依頼します。

出力ガイドライン

• 各タイプにつき1〜2件を推奨: ユーザーを圧倒しないよう、カテゴリごとに最も価値の高い自動化を上位1〜2件表示します
• 特定のタイプをユーザーが要求した場合: そのタイプにのみ焦点を当て、より多くのオプション（3〜5件）を提供します
• リファレンスリストを超えて: リファレンスファイルには一般的なパターンが含まれていますが、コードベースのツール、フレームワーク、ライブラリに固有の推奨事項を見つけるためにウェブ検索を使用します
• ユーザーにさらに尋ねられることを伝える: 特定のカテゴリについてさらに推奨事項をリクエストできることを最後に記載します

自動化タイプ概要

タイプ	最適な用途
フック	ツールイベント時の自動アクション（保存時フォーマット、lint、編集ブロック）
サブエージェント	並行実行される専門レビューアー/アナライザー
スキル	パッケージ化された専門知識、ワークフロー、繰り返し可能なタスク（Claudeまたはユーザーが/skill-nameで呼び出し）
プラグイン	インストール可能なスキルコレクション
MCPサーバー	外部ツール統合（データベース、API、ブラウザ、ドキュメント）

ワークフロー

フェーズ1: コードベース分析

プロジェクトコンテキストを収集します:

# プロジェクトタイプとツールを検出
ls -la package.json pyproject.toml Cargo.toml go.mod pom.xml 2>/dev/null
cat package.json 2>/dev/null | head -50

# MCPサーバー推奨のための依存関係を確認
cat package.json 2>/dev/null | grep -E '"(react|vue|angular|next|express|fastapi|django|prisma|supabase|convex|stripe)"'

# 既存のClaude Code設定を確認
ls -la .claude/ CLAUDE.md 2>/dev/null

# プロジェクト構造を分析
ls -la src/ app/ lib/ tests/ components/ pages/ api/ 2>/dev/null

キャプチャすべき主要指標:

カテゴリ	探すもの	推奨事項への影響
言語/フレームワーク	package.json, pyproject.toml, importパターン	フック, MCPサーバー
フロントエンドスタック	React, Vue, Angular, Next.js	Playwright MCP, フロントエンドスキル
バックエンドスタック	Express, FastAPI, Django	APIドキュメントツール
データベース	Prisma, Supabase, Convex, raw SQL	データベース/バックエンドMCPサーバー
外部API	Stripe, OpenAI, AWS SDK	context7 MCP（ドキュメント用）
テスト	Jest, pytest, Playwright設定	テストフック, サブエージェント
CI/CD	GitHub Actions, CircleCI	GitHub MCPサーバー
課題管理	Linear, Jiraの参照	課題トラッカーMCP
ドキュメントパターン	OpenAPI, JSDoc, docstring	ドキュメンテーションスキル

フェーズ2: 推奨事項の生成

分析に基づき、すべてのカテゴリにわたって推奨事項を生成します:

A. MCPサーバー推奨事項

詳細なパターンについてはreferences/mcp-servers.mdを参照してください。

コードベースシグナル	推奨MCPサーバー
人気ライブラリ（React, Expressなど）を使用	context7 - ライブドキュメントルックアップ
UIテストが必要なフロントエンド	Playwright - ブラウザ自動化/テスト
Supabaseを使用	Supabase MCP - 直接データベース操作
Convexを使用	Convex MCP - ライブデプロイメントイントロスペクション、クエリ/ミューテーション実行、env変数とログ管理
PostgreSQL/MySQLデータベース	Database MCP - クエリとスキーマツール
GitHubリポジトリ	GitHub MCP - Issue、PR、アクション
Linearを課題管理に使用	Linear MCP - 課題管理
AWSインフラ	AWS MCP - クラウドリソース管理
Slackワークスペース	Slack MCP - チーム通知
メモリ/コンテキスト永続化	Memory MCP - セッション間メモリ
Sentryエラートラッキング	Sentry MCP - エラー調査
Dockerコンテナ	Docker MCP - コンテナ管理

B. スキル推奨事項

詳細についてはreferences/skills-reference.mdを参照してください。

スキルは.claude/skills/<name>/SKILL.mdに作成します。一部はプラグインでも利用可能です:

コードベースシグナル	スキル	プラグイン
プラグイン構築	skill-development	plugin-dev
Gitコミット	commit	commit-commands
React/Vue/Angular	frontend-design	frontend-design
自動化ルール	writing-rules	hookify
機能計画	feature-dev	feature-dev

作成するカスタムスキル（テンプレート、スクリプト、例付き）:

コードベースシグナル	作成するスキル	呼び出し方法
APIルート	api-doc（OpenAPIテンプレート付き）	両方
データベースプロジェクト	create-migration（検証スクリプト付き）	ユーザーのみ
テストスイート	gen-test（テスト例付き）	ユーザーのみ
コンポーネントライブラリ	new-component（テンプレート付き）	ユーザーのみ
PRワークフロー	pr-check（チェックリスト付き）	ユーザーのみ
リリース	release-notes（gitコンテキスト付き）	ユーザーのみ
コードスタイル	project-conventions	Claudeのみ
オンボーディング	setup-dev（前提条件スクリプト付き）	ユーザーのみ

C. フック推奨事項

設定についてはreferences/hooks-patterns.mdを参照してください。

コードベースシグナル	推奨フック
Prettier設定済み	PostToolUse: 編集時に自動フォーマット
ESLint/Ruff設定済み	PostToolUse: 編集時に自動lint
TypeScriptプロジェクト	PostToolUse: 編集時に型チェック
testsディレクトリが存在	PostToolUse: 関連テストを実行
.envファイルが存在	PreToolUse: .env編集をブロック
ロックファイルが存在	PreToolUse: ロックファイル編集をブロック
セキュリティ重要コード	PreToolUse: 確認を要求

D. サブエージェント推奨事項

テンプレートについてはreferences/subagent-templates.mdを参照してください。

コードベースシグナル	推奨サブエージェント
大規模コードベース（500ファイル以上）	code-reviewer - 並列コードレビュー
認証/支払いコード	security-reviewer - セキュリティ監査
APIプロジェクト	api-documenter - OpenAPI生成
パフォーマンス重要	performance-analyzer - ボトルネック検出
フロントエンド主体	ui-reviewer - アクセシビリティレビュー
より多くのテストが必要	test-writer - テスト生成

E. プラグイン推奨事項

利用可能なプラグインについてはreferences/plugins-reference.mdを参照してください。

コードベースシグナル	推奨プラグイン
一般的な生産性向上	anthropic-agent-skills - コアスキルバンドル
ドキュメントワークフロー	docx, xlsx, pdfスキルをインストール
フロントエンド開発	frontend-designプラグイン
AIツール構築	mcp-builder（MCP開発用）

フェーズ3: 推奨事項レポートの出力

推奨事項を明確にフォーマットします。カテゴリごとに1〜2件のみ含め、この特定のコードベースに最も価値のあるものを選びます。関連しないカテゴリはスキップします。

## Claude Code自動化推奨事項

あなたのコードベースを分析し、各カテゴリの最適な自動化を特定しました。タイプごとの上位1〜2件の推奨事項は以下の通りです:

### コードベースプロファイル
- **タイプ**: [検出された言語/ランタイム]
- **フレームワーク**: [検出されたフレームワーク]
- **主要ライブラリ**: [検出された関連ライブラリ]

---

### 🔌 MCPサーバー

#### context7
**理由**: [検出されたライブラリに基づく具体的な理由]
**インストール**: `claude mcp add context7`

---

### 🎯 スキル

#### [スキル名]
**理由**: [具体的な理由]
**作成場所**: `.claude/skills/[name]/SKILL.md`
**呼び出し方法**: ユーザーのみ / 両方 / Claudeのみ
**利用可能なプラグイン**: [プラグイン名]（該当する場合）
```yaml
---
name: [スキル名]
description: [動作説明]
disable-model-invocation: true  # ユーザーのみの場合
---

---

⚡ フック

[フック名]

理由: [検出された設定に基づく具体的な理由] 設定場所: .claude/settings.json

---

🤖 サブエージェント

[エージェント名]

理由: [コードベースパターンに基づく具体的な理由] 設定場所: .claude/agents/[name].md

---

さらに欲しいですか？ 特定のカテゴリについて追加の推奨事項をリクエストできます（例: 「MCPサーバーのオプションをもっと見せて」や「他にどのようなフックが役立つ？」）。

これらの実装に助けが必要ですか？ お聞きいただければ、上記の推奨事項の設定をお手伝いできます。

## 判断フレームワーク

### MCPサーバーを推奨するタイミング
- 外部サービス統合が必要な場合（データベース、API）
- ライブラリ/SDKのドキュメントルックアップ
- ブラウザ自動化またはテスト
- チームツール統合（GitHub、Linear、Slack）
- クラウドインフラ管理

### スキルを推奨するタイミング

- ドキュメント生成（docx、xlsx、pptx、pdf — プラグインでも利用可能）
- 頻繁に繰り返されるプロンプトやワークフロー
- 引数を持つプロジェクト固有のタスク
- テンプレートやスクリプトをタスクに適用（スキルはサポートファイルをバンドル可能）
- `/skill-name`で呼び出すクイックアクション
- 分離して実行すべきワークフロー（`context: fork`）

**呼び出し制御:**
- `disable-model-invocation: true` — ユーザーのみ（副作用あり: デプロイ、コミット、送信）
- `user-invocable: false` — Claudeのみ（バックグラウンド知識用）
- デフォルト（両方省略） — 両方が呼び出し可能

### フックを推奨するタイミング
- 繰り返し行われる編集後のアクション（フォーマット、lint）
- 保護ルール（機密ファイルの編集をブロック）
- 検証チェック（テスト、型チェック）

### サブエージェントを推奨するタイミング
- 専門的な知識が必要な場合（セキュリティ、パフォーマンス）
- 並列レビューワークフロー
- バックグラウンド品質チェック

### プラグインを推奨するタイミング
- 複数の関連スキルが必要な場合
- 事前パッケージ化された自動化バンドルを希望する場合
- チーム全体での標準化

---

## 設定のヒント

### MCPサーバー設定

**チーム共有**: `.mcp.json`をリポジトリにチェックインすると、チーム全体が同じMCPサーバーを取得します

**デバッグ**: `--mcp-debug`フラグを使用して設定の問題を特定します

**推奨する前提条件:**
- GitHub CLI (`gh`) - ネイティブのGitHub操作を有効化
- Puppeteer/Playwright CLI - ブラウザMCPサーバー用

### ヘッドレスモード（CI/自動化用）

自動化パイプラインにはヘッドレスClaudeを推奨:

```bash
# プリコミットフックの例
claude -p "fix lint errors in src/" --allowedTools Edit,Write

# 構造化出力を使用したCIパイプライン
claude -p "<prompt>" --output-format stream-json | your_command

フックの権限

.claude/settings.jsonで許可ツールを設定:

{
  "permissions": {
    "allow": ["Edit", "Write", "Bash(npm test:*)", "Bash(git commit:*)"]
  }
}