claude-automation-recommender

Claude Automation Recommender

コードベースのパターンを分析し、すべての拡張機能を活用した、Claude Code 向けの最適な自動化を提案します。

このスキルは読み取り専用です。 コードベースを分析し、提案を出力します。ファイルの作成や変更は行いません。提案はユーザー自身で実装するか、別途 Claude に作成を依頼してください。

出力ガイドライン

• 各タイプにつき1～2件を提案：提案が多すぎないよう、カテゴリごとに最も価値の高い自動化を1～2件紹介してください。
• ユーザーが特定のタイプを求めた場合：そのタイプだけに絞り、より多くの選択肢（3～5件）を提案してください。
• 参考リストにとどまらない：参考ファイルには一般的なパターンが記載されていますが、ウェブ検索を活用し、コードベースのツール、フレームワーク、ライブラリに特化した提案も探してください。
• 追加の提案を依頼できることを伝える：最後に、特定のカテゴリについてさらに提案を依頼できることを伝えてください。

自動化タイプの概要

タイプ	最適な用途
Hooks	ツールのイベント発生時に実行する自動アクション（保存時のフォーマット、Lint、編集のブロックなど）
Subagents	並行して実行する専門のレビュアーやアナライザー
Skills	パッケージ化された専門知識、ワークフロー、繰り返し可能なタスク（Claude またはユーザーが /skill-name で呼び出します）
Plugins	インストール可能なスキルのコレクション
MCP Servers	外部ツールとの連携（データベース、API、ブラウザー、ドキュメントなど）

ワークフロー

フェーズ1：コードベースの分析

プロジェクトの状況を把握します。

# Detect project type and tools
ls -la package.json pyproject.toml Cargo.toml go.mod pom.xml 2>/dev/null
cat package.json 2>/dev/null | head -50

# Check dependencies for MCP server recommendations
cat package.json 2>/dev/null | grep -E '"(react|vue|angular|next|express|fastapi|django|prisma|supabase|convex|stripe)"'

# Check for existing Claude Code config
ls -la .claude/ CLAUDE.md 2>/dev/null

# Analyze project structure
ls -la src/ app/ lib/ tests/ components/ pages/ api/ 2>/dev/null

確認すべき主な指標：

カテゴリ	確認する内容	推奨事項に反映する内容
言語／フレームワーク	package.json、pyproject.toml、import パターン	Hooks、MCP サーバー
フロントエンドスタック	React、Vue、Angular、Next.js	Playwright MCP、フロントエンドスキル
バックエンドスタック	Express、FastAPI、Django	API ドキュメントツール
データベース	Prisma、Supabase、Convex、raw SQL	データベース／バックエンド向け MCP サーバー
外部 API	Stripe、OpenAI、AWS SDKs	ドキュメント参照用 context7 MCP
テスト	Jest、pytest、Playwright の設定	テスト用 Hooks、subagents
CI/CD	GitHub Actions、CircleCI	GitHub MCP サーバー
課題管理	Linear、Jira の参照	課題管理 MCP
ドキュメントのパターン	OpenAPI、JSDoc、docstrings	ドキュメント作成スキル

フェーズ2：推奨事項の作成

分析に基づき、すべてのカテゴリについて推奨事項を作成します。

A. MCP サーバーの推奨事項

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

コードベースのシグナル	推奨する MCP サーバー
人気のあるライブラリ（React、Express など）を使用	context7 - 最新のドキュメントを検索
フロントエンドで UI テストが必要	Playwright - ブラウザーの自動化／テスト
Supabase を使用	Supabase MCP - データベースを直接操作
Convex を使用	Convex MCP - デプロイのリアルタイムな内部調査、クエリ／ミューテーションの実行、環境変数とログの管理
PostgreSQL／MySQL データベース	Database MCP - クエリおよびスキーマ用ツール
GitHub リポジトリ	GitHub MCP - Issue、PR、Actions
Issue 管理に Linear を使用	Linear MCP - Issue 管理
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：編集時に自動リンティング
TypeScript プロジェクト	PostToolUse：編集時に型チェック
テストディレクトリが存在する	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 開発向けの mcp-builder

フェーズ 3：推奨事項レポートを出力する

推奨事項をわかりやすくまとめてください。カテゴリごとに1～2件のみ記載してください。このコードベースに最も役立つものを選びます。該当しないカテゴリは省略してください。

## Claude Code Automation Recommendations

I've analyzed your codebase and identified the top automations for each category. Here are my top 1-2 recommendations per type:

### Codebase Profile
- **Type**: [detected language/runtime]
- **Framework**: [detected framework]
- **Key Libraries**: [relevant libraries detected]

---

### 🔌 MCP Servers

#### context7
**Why**: [specific reason based on detected libraries]
**Install**: `claude mcp add context7`

---

### 🎯 Skills

#### [skill name]
**Why**: [specific reason]
**Create**: `.claude/skills/[name]/SKILL.md`
**Invocation**: User-only / Both / Claude-only
**Also available in**: [plugin-name] plugin (if applicable)
```yaml
---
name: [skill-name]
description: [what it does]
disable-model-invocation: true  # for user-only
---

---

⚡ フック

[フック名]

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

---

🤖 サブエージェント

[エージェント名]

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

---

他にも必要ですか？ 特定のカテゴリについて、追加の推奨事項を尋ねてください（例：「他のMCP サーバーの選択肢を教えて」や「役立つフックは他にありますか？」）。

これらの実装を手伝ってほしいですか？ お気軽にお尋ねください。上記の推奨事項のセットアップをお手伝いします。

## Decision Framework

### When to Recommend MCP Servers
- External service integration needed (databases, APIs)
- Documentation lookup for libraries/SDKs
- Browser automation or testing
- Team tool integration (GitHub, Linear, Slack)
- Cloud infrastructure management

### When to Recommend Skills

- Document generation (docx, xlsx, pptx, pdf — also in plugins)
- Frequently repeated prompts or workflows
- Project-specific tasks with arguments
- Applying templates or scripts to tasks (skills can bundle supporting files)
- Quick actions invoked with `/skill-name`
- Workflows that should run in isolation (`context: fork`)

**Invocation control:**
- `disable-model-invocation: true` — User-only (for side effects: deploy, commit, send)
- `user-invocable: false` — Claude-only (for background knowledge)
- Default (omit both) — Both can invoke

### When to Recommend Hooks
- Repetitive post-edit actions (formatting, linting)
- Protection rules (block sensitive file edits)
- Validation checks (tests, type checks)

### When to Recommend Subagents
- Specialized expertise needed (security, performance)
- Parallel review workflows
- Background quality checks

### When to Recommend Plugins
- Need multiple related skills
- Want pre-packaged automation bundles
- Team-wide standardization

---

## Configuration Tips

### MCP Server Setup

**Team sharing**: Check `.mcp.json` into repo so entire team gets same MCP servers

**Debugging**: Use `--mcp-debug` flag to identify configuration issues

**Prerequisites to recommend:**
- GitHub CLI (`gh`) - enables native GitHub operations
- Puppeteer/Playwright CLI - for browser MCP servers

### Headless Mode (for CI/Automation)

Recommend headless Claude for automated pipelines:

```bash
# Pre-commit hook example
claude -p "fix lint errors in src/" --allowedTools Edit,Write

# CI pipeline with structured output
claude -p "<prompt>" --output-format stream-json | your_command

フックの権限

.claude/settings.jsonで許可するツールを設定します。

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