Claude 自動化建議工具
分析程式碼庫模式，為所有擴充性選項推薦量身訂製的 Claude Code 自動化功能。
此技能為唯讀。 它會分析程式碼庫並產出建議。它不會建立或修改任何檔案。使用者需自行實作建議，或另外請 Claude 協助建立。
輸出指南
- 每種類型推薦 1-2 個：不要讓使用者負擔過重，每個類別只呈現最實用的 1-2 個建議。
- 如果使用者要求特定類型：只專注於該類型，並提供更多選項（3-5 個建議）。
- 超越參考清單：參考檔案包含常見模式，但請使用網路搜尋來尋找與程式碼庫中使用的工具、框架和函式庫相關的特定建議。
- 告知使用者可以要求更多：最後提醒他們可以針對任何特定類別要求更多建議。
自動化類型總覽
| 類型 | 最適合用於 |
|---|---|
| 鉤子 (Hooks) | 工具事件上的自動動作（儲存時格式化、Lint、封鎖編輯） |
| 子代理 (Subagents) | 可平行運作的專門審查者/分析器 |
| 技能 (Skills) | 封裝的專業知識、工作流程和可重複任務（由 Claude 或使用者透過 /skill-name 調用） |
| 插件 (Plugins) | 可安裝的技能集合 |
| 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, 匯入模式 | 鉤子, MCP 伺服器 |
| 前端技術棧 | React, Vue, Angular, Next.js | Playwright MCP, 前端技能 |
| 後端技術棧 | Express, FastAPI, Django | API 文件工具 |
| 資料庫 | Prisma, Supabase, Convex, 原始 SQL | 資料庫 / 後端 MCP 伺服器 |
| 外部 API | Stripe, OpenAI, AWS SDK | context7 MCP 用於文件查詢 |
| 測試 | Jest, pytest, Playwright 設定 | 測試鉤子, 子代理 |
| 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 - 查詢和 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. 技能建議
詳情請參閱 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
**也可從**：[plugin-name] 插件取得（如適用）
```yaml
---
name: [skill-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
# Pre-commit 鉤子範例
claude -p "修正 src/ 中的 lint 錯誤" --allowedTools Edit,Write
# 帶有結構化輸出的 CI 管道
claude -p "<提示>" --output-format stream-json | your_command
鉤子的權限
在 .claude/settings.json 中設定允許的工具：
{
"permissions": {
"allow": ["Edit", "Write", "Bash(npm test:*)", "Bash(git commit:*)"]
}
}