claude-automation-recommender

Claude Automation Recommender

分析程式碼的架構與模式，針對所有擴充選項推薦量身打造的 Claude Code 自動化方案。

本 Skill 僅具唯讀權限（Read-only）。 它只會分析程式碼庫並輸出建議，不會建立或修改任何檔案。使用者可自行實作建議內容，或另外請 Claude 協助建置。

輸出準則（Output Guidelines）

• 每種類型推薦 1-2 個：避免資訊過載——各類別僅精選出最符合效益的 1-2 個自動化方案
• 若使用者指定特定類型：專注於該類型並提供更多選項（3-5 個推薦）
• 超越參考清單：參考檔案雖然包含常用模式，但應善用網路搜尋（web search），尋找專屬於該程式碼庫所用工具、框架與函式庫的推薦
• 提醒使用者可要求更多：結尾時附註說明，若需要任何特定類別的更多推薦，可隨時提出

自動化類型總覽（Automation Types Overview）

類型	最適合情境
Hooks	工具事件觸發的自動化動作（存檔時自動格式化、Lint 檢查、阻擋檔案編輯）
Subagents	可平行執行的專任審查員 / 分析工具
Skills	封裝好的專業知識、工作流程與可重複執行的任務（由 Claude 或使用者透過 /skill-name 觸發）
Plugins	可供安裝的 Skills 組合包
MCP Servers	外部工具整合（資料庫、API、瀏覽器、文件）

工作流程（Workflow）

第一階段：程式碼庫分析（Phase 1: Codebase Analysis）

收集專案上下文資訊：

# 偵測專案類型與工具
ls -la package.json pyproject.toml Cargo.toml go.mod pom.xml 2>/dev/null
cat package.json 2>/dev/null | head -50

# 檢查相依套件以推薦 MCP Server
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 模式	Hooks、MCP Servers
前端技術棧	React, Vue, Angular, Next.js	Playwright MCP、前端 Skills
後端技術棧	Express, FastAPI, Django	API 文件工具
資料庫	Prisma, Supabase, Convex, 原生 SQL	資料庫 / 後端 MCP Servers
外部 API	Stripe, OpenAI, AWS SDKs	用於查閱文件的 context7 MCP
測試	Jest, pytest, Playwright 設定	測試相關 Hooks、Subagents
CI/CD	GitHub Actions, CircleCI	GitHub MCP Server
議題追蹤	Linear, Jira 相關引用	議題追蹤 MCP
文件模式	OpenAPI, JSDoc, docstrings	文件類 Skills

第二階段：產生推薦（Phase 2: Generate Recommendations）

根據分析結果，針對所有類別產生推薦：

A. MCP Server 推薦

詳細模式請參閱 references/mcp-servers.md。

程式碼庫特徵	推薦的 MCP Server
使用熱門函式庫（React、Express 等）	context7 - 即時文件查閱
具 UI 測試需求的前端專案	Playwright - 瀏覽器自動化 / 測試
使用 Supabase	Supabase MCP - 直接進行資料庫操作
使用 Convex	Convex MCP - 即時部署內省、執行查詢 / 變更、管理環境變數與日誌
PostgreSQL / MySQL 資料庫	Database MCP - 查詢與 Schema 工具
GitHub 儲存庫	GitHub MCP - Issues、PRs、Actions
使用 Linear 管理議題	Linear MCP - 議題管理
AWS 基礎設施	AWS MCP - 雲端資源管理
Slack 工作區	Slack MCP - 團隊通知
跨會話記憶 / 上下文持久化	Memory MCP - 跨會話記憶
Sentry 錯誤追蹤	Sentry MCP - 錯誤調查
Docker 容器	Docker MCP - 容器管理

B. Skills 推薦

詳細說明請參閱 references/skills-reference.md。

請於 .claude/skills/<name>/SKILL.md 建立 Skill，部分也可透過 Plugin 取得：

程式碼庫特徵	Skill	Plugin
開發 Plugins	skill-development	plugin-dev
Git 提交	commit	commit-commands
React / Vue / Angular	frontend-design	frontend-design
自動化規則	writing-rules	hookify
功能規劃	feature-dev	feature-dev

建議建立的自訂 Skills（含模板、腳本、範例）：

程式碼庫特徵	欲建立的 Skill	觸發方式
API 路由	api-doc（附 OpenAPI 模板）	兩者皆可
資料庫專案	create-migration（附驗證腳本）	僅限使用者
測試套件	gen-test（附測試範例）	僅限使用者
元件庫	new-component（附模板）	僅限使用者
PR 工作流程	pr-check（附檢查清單）	僅限使用者
版本釋出	release-notes（附 Git 上下文）	僅限使用者
程式碼風格	project-conventions	僅限 Claude
專案引導	setup-dev（附前置需求驗證腳本）	僅限使用者

C. Hooks 推薦

詳細設定請參閱 references/hooks-patterns.md。

程式碼庫特徵	推薦的 Hook
已設定 Prettier	PostToolUse：編輯後自動格式化
已設定 ESLint / Ruff	PostToolUse：編輯後自動執行 Lint 檢查
TypeScript 專案	PostToolUse：編輯後自動執行型別檢查
存在測試目錄	PostToolUse：執行相關測試
存在 .env 檔案	PreToolUse：阻擋 .env 檔案編輯
存在 Lock 檔案	PreToolUse：阻擋 Lock 檔案編輯
資安敏感程式碼	PreToolUse：需二次確認

D. Subagent 推薦

詳細模板請參閱 references/subagent-templates.md。

程式碼庫特徵	推薦的 Subagent
大型程式碼庫（>500 個檔案）	code-reviewer - 平行程式碼審查
身份驗證 / 付款程式碼	security-reviewer - 資安審計
API 專案	api-documenter - 產生 OpenAPI 文件
效能關鍵專案	performance-analyzer - 瓶頸偵測
重度前端專案	ui-reviewer - 無障礙功能審查
需要更多測試	test-writer - 自動產生測試

E. Plugin 推薦

可用 Plugin 請參閱 references/plugins-reference.md。

程式碼庫特徵	推薦的 Plugin
一般生產力工具	anthropic-agent-skills - 核心 Skill 組合包
文件工作流程	安裝 docx、xlsx、pdf 等 Skills
前端開發	frontend-design plugin
開發 AI 工具	用於 MCP 開發的 mcp-builder

第三階段：輸出推薦報告（Phase 3: Output Recommendations Report）

格式化輸出推薦結果。每個類別僅需包含 1-2 個推薦——挑選最符合該程式碼庫效益的項目。若某類別不相關則直接跳過。

## Claude Code 自動化推薦報告

我已分析您的程式碼庫，並為各類別篩選出最優質的自動化方案。以下是每種類型精選的 1-2 個推薦：

### 程式碼庫概況（Codebase Profile）
- **類型**：[偵測到的語言 / 執行階段]
- **框架**：[偵測到的框架]
- **核心函式庫**：[偵測到的相關函式庫]

---

### 🔌 MCP Servers

#### context7
**推薦原因**：[根據偵測到的函式庫說明具體原因]
**安裝方式**：`claude mcp add context7`

---

### 🎯 Skills

#### [skill 名稱]
**推薦原因**：[具體原因]
**建立路徑**：`.claude/skills/[name]/SKILL.md`
**觸發管道**：僅限使用者 / 兩者皆可 / 僅限 Claude
**亦可透過以下取得**：[plugin-name] plugin（若適用）
```yaml
---
name: [skill-name]
description: [功能說明]
disable-model-invocation: true  # 用於僅限使用者觸發的情境
---

---

⚡ Hooks

[hook 名稱]

推薦原因：[根據偵測到的設定說明具體原因]
設定位置：.claude/settings.json

---

🤖 Subagents

[agent 名稱]

推薦原因：[根據程式碼庫模式說明具體原因]
設定位置：.claude/agents/[name].md

---

想要瞭解更多？ 您可以要求提供特定類別的附加推薦（例如：「請提供更多 MCP Server 選項」或「還有哪些 Hooks 能幫上忙？」）。

需要協助實作上述設定？ 只要提出需求，我即可協助您設定上述任何一項推薦內容。

### 決策架構（Decision Framework）

#### 何時推薦 MCP Servers
- 需要整合外部服務（資料庫、API）
- 查閱函式庫 / SDK 的官方文件
- 瀏覽器自動化或測試
- 團隊工具整合（GitHub、Linear、Slack）
- 雲端基礎設施管理

#### 何時推薦 Skills

- 產生文件（docx, xlsx, pptx, pdf ——亦包含於外掛中）
- 高頻率重複的提示詞或工作流程
- 包含自訂引數的專案特定任務
- 將模板或腳本套用至任務中（Skills 可封裝附屬檔案）
- 透過 `/skill-name` 快速呼叫的動作
- 需獨立執行的工作流程（`context: fork`）

**觸發控制（Invocation control）：**
- `disable-model-invocation: true` — 僅限使用者（用於具副作用的操作：部署、提交、發送）
- `user-invocable: false` — 僅限 Claude（用於背景知識）
- 預設（省略兩者） — 兩者皆可觸發

#### 何時推薦 Hooks
- 編輯後的重複性動作（格式化、Lint 檢查）
- 保護機制（阻擋敏感檔案編輯）
- 驗證檢查（執行測試、型別檢查）

#### 何時推薦 Subagents
- 需要特定領域的專業知識（安全性、效能）
- 平行程式碼審查工作流程
- 背景品質檢查

#### 何時推薦 Plugins
- 需要多個相關的 Skills
- 希望取得預先封裝好的自動化組合包
- 團隊全域標準化

---

### 設定技巧（Configuration Tips）

#### MCP Server 設定

**團隊共享**：將 `.mcp.json` 簽入 Git 儲存庫，讓全團隊共享相同的 MCP Servers 設定

**除錯方式**：使用 `--mcp-debug` 旗標找出設定問題

**建議前置需求：**
- GitHub CLI (`gh`) - 支援原生 GitHub 操作
- Puppeteer / Playwright CLI - 用於瀏覽器 MCP Servers

#### Headless 模式（用於 CI / 自動化）

在自動化流水線中推薦使用無頭模式（headless）的 Claude：

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

# 具結構化輸出的 CI 流水線
claude -p "<prompt>" --output-format stream-json | your_command

Hooks 權限設定

在 .claude/settings.json 中設定允許使用的工具：

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