SuperAPI AI 工具集

claude-automation-recommender

编程与开发

查看项目

更新于 11-12 06:46

技能介绍

用途

Claude Automation Recommender 用于分析代码库,并为 Claude Code 推荐量身定制的自动化方案,覆盖各种可扩展性选项。该技能为只读:它分析代码库并输出建议,不创建、不修改任何文件。用户需自行实施方案,或另行请求 Claude 协助搭建。

主要能力

技能围绕五类自动化给出建议:

  • Hooks:在工具事件上触发自动动作(保存时格式化、lint、阻止编辑)。
  • Subagents:并行运行的专用审查者/分析器。
  • Skills:打包的专业知识、工作流和可重复任务(可由 Claude 或用户通过 /skill-name 调用)。
  • Plugins:可安装的技能集合。
  • MCP Servers:外部工具集成(数据库、API、浏览器、文档)。

输出规范:每类默认推荐 1–2 个最有价值的自动化,避免信息过载;若用户指定某一类型,则只聚焦该类型并给出 3–5 个建议;鼓励超出参考清单,结合网页搜索给出针对代码库工具、框架和库的方案;结尾提示用户可对任意类别索取更多建议。

工作流程

阶段一:代码库分析

收集项目上下文:检测项目类型与工具(package.json、pyproject.toml、Cargo.toml、go.mod、pom.xml 等);检查依赖(react、vue、angular、next、express、fastapi、django、prisma、supabase、stripe 等)以支撑 MCP server 建议;查看已有 Claude Code 配置(.claude/、CLAUDE.md);分析项目结构(src/、app/、lib/、tests/、components/、pages/、api/ 等)。

需捕获的关键指标及各指标影响的建议方向:

  • 语言/框架(package.json、pyproject.toml、import 模式)→ Hooks、MCP servers
  • 前端栈(React、Vue、Angular、Next.js)→ Playwright MCP、前端技能
  • 后端栈(Express、FastAPI、Django)→ API 文档工具
  • 数据库(Prisma、Supabase、原生 SQL)→ 数据库 MCP servers
  • 外部 API(Stripe、OpenAI、AWS SDK)→ context7 MCP 查文档
  • 测试(Jest、pytest、Playwright 配置)→ 测试 hooks、subagents
  • CI/CD(GitHub Actions、CircleCI)→ GitHub MCP server
  • 问题跟踪(Linear、Jira)→ 问题跟踪 MCP
  • 文档模式(OpenAPI、JSDoc、docstrings)→ 文档技能

阶段二:生成建议

A. MCP Server 建议(详见 references/mcp-servers.md),例如:使用流行库→context7 实时文档查询;前端需 UI 测试→Playwright 浏览器自动化/测试;使用 Supabase→Supabase MCP;PostgreSQL/MySQL→数据库 MCP;GitHub 仓库→GitHub MCP;使用 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-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. Hooks 建议(详见 references/hooks-patterns.md):配置 Prettier→PostToolUse 编辑时自动格式化;配置 ESLint/Ruff→PostToolUse 编辑时自动 lint;TypeScript 项目→PostToolUse 编辑时类型检查;存在测试目录→PostToolUse 运行相关测试;存在 .env 文件→PreToolUse 阻止 .env 编辑;存在锁文件→PreToolUse 阻止锁文件编辑;安全敏感代码→PreToolUse 需确认。

D. Subagent 建议(详见 references/subagent-templates.md):大型代码库(>500 文件)→code-reviewer 并行代码审查;认证/支付代码→security-reviewer 安全审计;API 项目→api-documenter OpenAPI 生成;性能关键→performance-analyzer 瓶颈检测;前端为主→ui-reviewer 可访问性审查;测试不足→test-writer 测试生成。

E. Plugin 建议(详见 references/plugins-reference.md):通用生产力→anthropic-agent-skills 核心技能包;文档工作流→安装 docx、xlsx、pdf 技能;前端开发→frontend-design 插件;构建 AI 工具→mcp-builder。

阶段三:输出建议报告

以清晰格式输出,每类仅保留 1–2 个针对该代码库最有价值的建议,跳过不相关类别。报告包含代码库概况(类型、框架、关键库),然后按 MCP Servers、Skills、Hooks、Subagents 分节列出建议,每项说明理由及安装/创建位置,Skill 示例给出含 name、description、disable-model-invocation 的 YAML 头。结尾提示用户可对特定类别索取更多建议,或请求协助实施。

决策框架

  • 何时推荐 MCP Servers:需要外部服务集成(数据库、API)、库/SDK 文档查询、浏览器自动化或测试、团队工具集成(GitHub、Linear、Slack)、云基础设施管理。
  • 何时推荐 Skills:文档生成(docx、xlsx、pptx、pdf,也在插件中)、频繁重复的提示或工作流、带参数的项目专属任务、将模板或脚本应用于任务(技能可捆绑支持文件)、通过 /skill-name 触发的快捷动作、需隔离运行的工作流(context: fork)。调用控制:disable-model-invocation: true 表示仅用户(用于部署、提交、发送等副作用操作);user-invocable: false 表示仅 Claude(用于背景知识);两者省略表示双方均可调用。
  • 何时推荐 Hooks:重复的编辑后动作(格式化、lint)、保护规则(阻止敏感文件编辑)、校验检查(测试、类型检查)。
  • 何时推荐 Subagents:需要专用专长(安全、性能)、并行审查工作流、后台质量检查。
  • 何时推荐 Plugins:需要多个相关技能、想要预打包的自动化组合、团队范围标准化。

配置提示

  • MCP Server 设置:将 .mcp.json 提交到仓库,让全团队获得相同的 MCP servers;使用 --mcp-debug 标志排查配置问题;建议的前置条件包括 GitHub CLI(gh)以支持原生 GitHub 操作、Puppeteer/Playwright CLI 以支持浏览器 MCP servers。
  • 无头模式(用于 CI/自动化):为自动化流水线推荐无头 Claude,例如预提交钩子 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:*)"]}}。

适用场景

用户希望在特定代码库中引入 Claude Code 自动化、需要了解 hooks/subagents/skills/plugins/MCP servers 的落地建议、或想针对项目技术栈获得外部集成与工作流优化方案时适用。

限制

该技能为只读,不创建或修改文件,实施需用户自行完成或另行请求 Claude;其建议依赖对代码库的实际分析以及参考文件与网页搜索结果。资料未说明具体的收费、价格或平台支持范围,暂未提供。