claude-automation-recommender

Claude Automation Recommender

コードベースのパターンを分析し、あらゆる拡張オプションに対応した Claude Code の自動化を提案します。

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

出力ガイドライン

• 各タイプにつき1～2件を提案する：候補を絞り、カテゴリごとに特に価値の高い自動化を1～2件提示します
• ユーザーが特定のタイプを指定した場合：そのタイプのみに絞り、より多くの候補（3～5件）を提示します
• 参考リストの範囲を超える：参考ファイルには一般的なパターンが記載されていますが、ウェブ検索を活用し、コードベースで使用されているツール、フレームワーク、ライブラリに特化した提案を行います
• 追加の提案を依頼できることを伝える：最後に、特定のカテゴリについて追加の提案を依頼できることを伝えます

自動化タイプの概要

タイプ	最適な用途
フック	ツールのイベントに対する自動アクション（保存時のフォーマット、リンティング、編集のブロック）
サブエージェント	並行して実行される、専門的なレビュー担当や分析担当
スキル	パッケージ化された専門知識、ワークフロー、繰り返し実行できるタスク（Claude またはユーザーが /skill-name で呼び出します）
プラグイン	インストール可能なスキルのコレクション
MCP サーバー	外部ツールとの連携（データベース、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|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、インポートパターン	フック、MCP サーバー
フロントエンドスタック	React、Vue、Angular、Next.js	Playwright MCP、フロントエンドスキル
バックエンドスタック	Express、FastAPI、Django	API ドキュメントツール
データベース	Prisma、Supabase、生 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 - データベースを直接操作
PostgreSQL／MySQL データベース	Database MCP - クエリとスキーマのツール
GitHub リポジトリ	GitHub MCP - 課題、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：編集時に自動リント
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
---

---

⚡ フック

[hook name]

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

---

🤖 サブエージェント

[agent name]

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

---

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

これらの実装を手伝いましょうか？ お尋ねいただければ、上記の推奨事項の設定をお手伝いします。

関連スキル

• dependency-upgrade：依存関係マネージャー、ロックファイル、または CI のアップグレードツールが検出された場合に、依存関係を強化するワークフローを推奨して有効化します

## 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:*)"]
  }
}