身为前端开发者,你是不是常常在完成代码编写后,还要手动进行 ESLint 检查、修复格式问题,接着执行 git add、commit、push 这些繁琐操作?这类重复机械工作不仅浪费开发时间,还很容易在忙碌的时候漏掉关键步骤。今天我带大家手把手,利用 Cursor 的 Custom Skills 和 SubAgent 功能,搭建一套从代码审查、自动修复到 Git 提交推送的完整自动化流水线。一次配置永久生效,Vue、React、原生 JS 所有前端项目都能直接适配复用。整体架构设计
我们按照单一职责的思路,先拆分出三个独立原子 Skill:前端 JS - 代码审查:只做代码规范检测,不改动项目任何文件。前端 JS - 代码自动修复:自动修复 ESLint 语法问题、Prettier 格式化排版。前端 JS - Git 提交推送:一键完成 git 暂存、提交、推送到远程仓库。再单独封装一个 SubAgent,固定按照 代码审查→代码修复→代码提交 的顺序,串行调用这三个 Skill。只要中间任意一步执行失败,整条流水线立刻终止并提醒用户。同时支持三种调用方式:手动对话触发、AI 自动调度、命令面板一键启动,所有前端项目都能无缝复用。第一步:创建 3 个独立原子 Skill
在 Cursor 里按这个路径打开配置:Settings → Features → Custom Skills → Add Skill,依次新建下面三个 Skill,照着填写即可。---name: frontend-code-reviewdescription: >- Reviews frontend changes (React/Vue/Svelte/TS/CSS) for correctness, UX, accessibility, performance, security, and ESLint/Prettier consistency. Use when the user asks for a frontend code review, UI PR review, or @@frontend-code-review; run alone without fixing or committing unless explicitly asked.disable-model-invocation: true---# 前端代码审查(独立执行)仅做审查与结论输出;**不自动改代码、不提交**,除非用户明确要求合并步骤。## 输入- 用户给出的路径、分支、`git diff` 范围,或「审查当前改动」。- 若无范围:优先 `git diff` / `git diff main...HEAD`,再补全文件列表。## 审查维度(按需覆盖)1. **正确性**:状态与副作用、条件渲染、边界与空值、路由与权限。2. **可维护性**:组件职责、重复逻辑、命名与类型(TS)、魔法数/字符串。3. **可访问性**:语义标签、`aria`、焦点与键盘、对比度与触控目标。4. **性能**:不必要重渲染、大列表/图表、图片与 bundle、懒加载。5. **安全**:`dangerouslySetInnerHTML`、拼接 URL/脚本、敏感信息进前端。6. **样式与响应式**:断点、溢出、暗色/主题 token 一致性。7. **ESLint / Prettier**:与仓库配置一致;规则冲突处注明「以 `.eslintrc` / `eslint.config` / `.prettierrc` 为准」。## 工具链(只读,不改文件)若项目存在 `package.json`:1. 优先读脚本名(如 `lint`、`lint:fix`、`format`、`format:check`),**审查阶段仅运行不写文件的命令**(例如 `eslint . --max-warnings 0`、或项目已有的 `lint`/`format:check`,避免 `fix`/`write` 污染审查)。2. 若无脚本:可对 **本次 diff 涉及文件** 运行 `npx eslint <paths>`、`npx prettier --check <paths>`(路径来自用户范围或 `git diff --name-only`)。3. 将 ESLint/Prettier 的 **error 级** 纳入「必须修复」;**warn** 与格式偏好纳入「建议」或「可选」,除非团队约定零 warning。## 运行命令示例(审查 / 只读)在项目前端根目录(含 `package.json` 与 ESLint/Prettier 配置)执行。**优先**使用仓库已有脚本;下列为无脚本或需针对改动文件时的兜底。**包管理器调用脚本(任选其一)**```bashnpm run lintnpm run format:check# 或pnpm run lintpnpm run format:check# 或yarn lintyarn format:check```**针对「工作区已改动文件」(不含未提交删除;可按需改成 `main...HEAD`)**```bash# 列出待检查路径(按需增删扩展名)git diff --name-only --diff-filter=ACM | grep -E '\.(js|jsx|mjs|cjs|ts|tsx|vue|svelte|css|scss|md|mdx|json|yaml|yml)$' || true``````bash# Prettier:仅检查、不写回npx prettier --check "**/*.{js,jsx,ts,tsx,mjs,cjs,vue,svelte,css,scss,md,json}"# 若需缩到本次 diff 文件,可先写入变量再传参(路径含空格时改用 -0 与 xargs -0)FILES="$(git diff --name-only --diff-filter=ACM | tr '\n' ' ')"[ -n "${FILES// }" ] && npx prettier --check $FILES``````bash# ESLint:检查(不写回);可按项目习惯加 --max-warnings 0npx eslint . --ext .js,.jsx,.ts,.tsx --max-warnings 0# 仅检查若干文件时:npx eslint "src/components/Foo.tsx" "src/hooks/useBar.ts"```路径含空格或文件很多时,改用 **eslint 的缓存与 `--no-error-on-unmatched-pattern`** 等选项以匹配项目配置;上述为最小可运行示例。## 输出格式按严重程度分组(与仓库惯例冲突时在结论中说明):```markdown## 摘要[1–3 句]## 必须修复(阻塞合并)- [文件:行] 问题 — 理由## 建议改进(非阻塞)- ...## 可选 / 风格- ...## 未覆盖范围(若有)- 例如未运行 ESLint/Prettier、未运行测试、未做视觉回归```## 约束- 不臆测业务:不确定处标注「需产品/后端确认」。- 引用代码用 Cursor 要求的代码引用格式;大块省略用 `...`。---name: frontend-code-fixdescription: >- Implements minimal, focused fixes for frontend issues from review or bug reports, then aligns changes with ESLint and Prettier. Use when the user asks to fix reviewed issues, patch UI/TS/CSS, run eslint --fix/prettier, or @@frontend-code-fix; does not perform review-from-scratch or git commit unless explicitly combined with other skills.disable-model-invocation: true---# 前端代码修复(独立执行)在**已明确问题列表**或**用户指定文件/行为**的前提下改代码;**不替代完整审查流程**,也不默认执行 `git commit`。## 输入- 问题列表(来自审查、issue、或用户描述);或- 具体文件 + 期望行为。缺省时先向用户确认范围,避免发散修改。## 修复原则1. **最小改动**:只改完成任务所需的行;不做顺手重构(除非用户要求)。2. **风格一致**:沿用目录内既有模式(hooks、状态库、CSS 方案、i18n)。3. **类型与安全**:TS 严格处理 `null`/`undefined`;避免放宽类型糊弄过关。4. **可验证**:改完后说明如何验证(命令、页面路径、关键交互);若项目有 `lint`/`test` 脚本则运行并处理与本改动相关的失败项。## ESLint 与 Prettier(修复阶段必做)在业务逻辑改完后、交付前,对 **本次修改范围内的文件** 执行格式化与 lint;优先使用项目脚本,避免与仓库配置冲突。1. **发现脚本**:读 `package.json` 的 `…