claude-automation-recommender

Claude Automation Recommender

通过分析代码库的模式特征，在各类扩展选项中为用户量身推荐适合的 Claude Code 自动化配置。

本 Skill 为纯只读模式。 它仅分析代码库并输出推荐建议，绝不会创建或修改任何文件。用户可以自行根据建议手动配置，或单独要求 Claude 协助创建。

输出规范

• 每类精选 1~2 项：避免给用户带来信息过载，每个分类下仅精选并展示价值最高的 1~2 个自动化方案
• 若用户明确指定了某类方案：则仅聚焦该类型，并提供更丰富的选项（3~5 项推荐）
• 打破参考列表的限制：参考文件仅包含常见模式，请结合网络搜索，针对该代码库具体用到的工具、框架和依赖库，给出定制化的推荐
• 提示用户可获取更多：结尾处请告知用户，如果对某类方案感兴趣，可以随时要求提供更多细节或额外推荐

自动化类型一览

类型	适用场景
Hooks	基于工具事件触发的自动化操作（如保存时自动格式化、代码检查/Lint、拦截敏感编辑等）
Subagents	可并行运行的专业评审员/分析器
Skills	封装好的专业知识、工作流与可复用任务（由 Claude 自动调用或用户通过 /skill-name 手动触发）
Plugins	可一键安装的 Skills 拓展包集合
MCP Servers	外部工具集成（数据库、API、浏览器自动化、在线文档等）

工作流程

第一阶段：代码库分析

收集项目上下文信息：

# 检测项目类型与工具
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 SDK 等	context7 MCP（查阅在线文档）
测试框架	Jest、pytest、Playwright 配置	测试相关 Hooks、Subagents
CI/CD	GitHub Actions、CircleCI	GitHub MCP Server
Issue 追踪	Linear、Jira 相关引用	任务/Issue 追踪 MCP
文档规范	OpenAPI、JSDoc、docstrings	文档生成与维护 Skills

第二阶段：生成推荐方案

结合上述分析结果，在各个维度下生成推荐方案：

A. MCP Server 推荐

详见 references/mcp-servers.md 获取具体模式与细节。

代码库特征信号	推荐的 MCP Server
使用了热门第三方库（React、Express 等）	context7 - 实时在线文档检索
包含 UI 测试需求的前端项目	Playwright - 浏览器自动化与测试
使用了 Supabase	Supabase MCP - 数据库直接读写与管理
使用了 Convex	Convex MCP - 部署状态实时审查、执行 Query/Mutation、环境变量与日志管理
PostgreSQL/MySQL 数据库	Database MCP - 数据库查询与 Schema 查看工具
GitHub 托管仓库	GitHub MCP - 处理 Issue、PR 及 Actions 工作流
使用 Linear 管理 Issue	Linear MCP - 项目与 Issue 追踪管理
AWS 云基础设施	AWS MCP - 云资源管理与运维
Slack 工作区	Slack MCP - 团队消息与通知联动
上下文/记忆持久化需求	Memory MCP - 跨 Session 记忆与上下文保留
Sentry 错误追踪	Sentry MCP - 线上报错排查
Docker 容器化项目	Docker MCP - 容器生命周期管理

B. Skills 推荐

详见 references/skills-reference.md 了解更多细节。

在 .claude/skills/<name>/SKILL.md 中创建 Skill。部分 Skill 也可以直接通过安装对应 Plugin 获得：

代码库特征信号	Skill 名称	对应 Plugin
开发/扩展插件	skill-development	plugin-dev
Git Commit 提交规范	commit	commit-commands
React/Vue/Angular 前端	frontend-design	frontend-design
自动化规则配置	writing-rules	hookify
新功能开发规划	feature-dev	feature-dev

可定制创建的专属 Skills（附带模板、脚本或示例）：

代码库特征信号	建议创建的 Skill	调用方式 (Invocation)
API 路由/接口项目	api-doc（搭配 OpenAPI 模板）	双向调用 (Both)
数据库相关项目	create-migration（搭配校验脚本）	仅限用户 (User-only)
包含测试用例的项目	gen-test（搭配测试示例）	仅限用户 (User-only)
组件库项目	new-component（搭配模版）	仅限用户 (User-only)
PR/代码合并工作流	pr-check（搭配检查清单）	仅限用户 (User-only)
发版与 Release 流程	release-notes（搭配 Git 上下文）	仅限用户 (User-only)
代码规范/风格约束	project-conventions	仅限 Claude (Claude-only)
环境搭建/新成员入职	setup-dev（搭配前置依赖检查脚本）	仅限用户 (User-only)

C. Hooks 推荐

详见 references/hooks-patterns.md 获取具体配置方案。

代码库特征信号	推荐配置的 Hook
已配置 Prettier	PostToolUse：编辑文件后自动格式化
已配置 ESLint / Ruff	PostToolUse：编辑文件后自动执行 Lint 代码检查
TypeScript 项目	PostToolUse：编辑文件后自动类型检查
存在测试目录	PostToolUse：自动运行相关的单元测试
存在 .env 敏感文件	PreToolUse：拦截对 .env 文件的编辑修改
存在 Lock 包锁文件	PreToolUse：拦截对 Lock 文件的修改
包含安全敏感代码	PreToolUse：做修改前强制需要用户二次确认

D. Subagents 推荐

详见 references/subagent-templates.md 获取模板参考。

代码库特征信号	推荐的 Subagent
大型代码库（>500 个文件）	code-reviewer - 并行代码评审
鉴权/支付模块代码	security-reviewer - 专项安全审计
API 接口类项目	api-documenter - 自动化生成 OpenAPI 文档
性能敏感型应用	performance-analyzer - 性能瓶颈分析与检测
偏重前端的项目	ui-reviewer - 无障碍与 UI 交互审查
缺乏测试用例的项目	test-writer - 批量生成测试用例

E. Plugins 推荐

详见 references/plugins-reference.md 查看可用的插件列表。

代码库特征信号	推荐 Plugin
通用日常提效	anthropic-agent-skills - 核心 Skill 拓展包
包含文档处理工作流	安装包含 docx、xlsx、pdf 处理能力的 Skills
前端开发项目	frontend-design 插件包
构建 AI 工具/拓展	mcp-builder（用于开发 MCP 服务）

第三阶段：输出推荐报告

以清晰易读的格式输出推荐内容。每个分类下仅需展示 1~2 个最关键的推荐方案（即针对当前代码库最有价值的方案），无关或无匹配特征的分类可直接跳过。

## Claude Code 自动化配置推荐报告

通过对当前代码库的深度分析，已为你精选出各维度下性价比最高的自动化方案。以下是各分类下最推荐的 1~2 项配置：

### 代码库概览 (Codebase Profile)
- **项目类型 (Type)**: [识别出的语言/运行时]
- **核心框架 (Framework)**: [识别出的应用框架]
- **关键依赖库 (Key Libraries)**: [识别出的核心依赖库]

---

### 🔌 MCP Servers

#### context7
**推荐理由**: [基于已识别出的第三方库给出具体原因]
**安装命令**: `claude mcp add context7`

---

### 🎯 Skills

#### [Skill 名称]
**推荐理由**: [具体的推荐依据与使用场景]
**文件创建路径**: `.claude/skills/[名称]/SKILL.md`
**调用权限 (Invocation)**: User-only / Both / Claude-only
**可替代的 Plugin**: [插件名称] plugin（如适用）
```yaml
---
name: [skill-name]
description: [功能描述]
disable-model-invocation: true  # 仅限用户手动调用 (User-only)
---

---

⚡ Hooks

[Hook 名称]

推荐理由: [结合代码库现有配置给出的具体原因]
配置文件路径: .claude/settings.json

---

🤖 Subagents

[Subagent 名称]

推荐理由: [结合代码库结构模式给出的具体原因]
文件创建路径: .claude/agents/[名称].md

---

想了解更多？ 如果希望探索某个分类下的更多推荐，随时告诉我（例如：“展示更多 MCP Server 选项”或“还有哪些实用的 Hook 推荐？”）。

需要帮您配置上线？ 只要告诉我你相中了哪个方案，我可以立即协助你安装和配置上述任何一项内容。

### 决策判定框架

#### 何时推荐 MCP Servers
- 需要对接外部服务（数据库、第三方 API）
- 需要实时检索各类库/SDK 的官方最新文档
- 包含浏览器自动化控制或端到端测试需求
- 需要协同工具集成（GitHub、Linear、Slack 等）
- 需要管理云端基础设施与资源

#### 何时推荐 Skills

- 需要生成各类文档（docx、xlsx、pptx、pdf 等，部分也可通过插件安装）
- 存在高频重复的 Prompt 提示词或固定工作流
- 需要传入参数并针对项目特定逻辑执行的任务
- 需要配合模板文件或脚本协同完成的任务（Skill 可打包同级支持文件）
- 希望通过 `/skill-name` 快速触发快捷指令
- 需要在独立隔离环境中运行的工作流（`context: fork`）

**调用权限控制说明：**
- `disable-model-invocation: true` — **仅用户可用**（适用于涉及部署、Git 提交、发消息等破坏性/副作用操作）
- `user-invocable: false` — **仅 Claude 可用**（用于注入背景知识或辅助规范）
- 默认缺省 — **两者均可触发调用**

#### 何时推荐 Hooks
- 编辑文件后的重复性自动补救动作（代码格式化、自动 Lint 修复）
- 安全防护规则（拦截对敏感或核心配置文件的编辑）
- 自动校验检查（编辑完成后即时运行测试或类型检查）

#### 何时推荐 Subagents
- 需要特定领域的深度专家知识（如专项安全审计、性能分析）
- 需要并行不阻塞的代码评审工作流
- 离线/后台运行的代码质量抽查

#### 何时推荐 Plugins
- 需要一次性组合使用多个关联 Skill
- 倾向于开箱即用、一键安装的预包装自动化方案
- 团队内部需要统一分发与标准化配置

---

### 配置技巧与实用建议

#### MCP Server 配置要点

**团队共享**: 将 `.mcp.json` 提交至 Git 仓库，确保整个团队共享同一套 MCP Server 配置

**排查调试**: 启动时使用 `--mcp-debug` 标志，可以快速定位 MCP Server 的连接与配置异常

**推荐前的先决条件检查：**
- 建议先安装 GitHub CLI (`gh`)，以启用原生 GitHub 交互
- 使用浏览器类型 MCP Server 前需准备好 Puppeteer/Playwright CLI

#### 无头模式/Headless Mode（适用于 CI 或自动化流水线）

在 CI/CD 自动化流水线中，推荐使用无头模式（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:*)"]
  }
}