mcpField

Pre-Commit Guard

精选事件触发
测试

关于 Pre-Commit Guard

该循环由事件触发，在 Cursor 中于提交前运行 npm test。只有测试以退出码 0 结束，提交才可继续；否则提交保持被阻止。

主要功能

  1. 01事件触发，无需手动启动
  2. 02以 npm test 的退出码作为放行依据
  3. 03测试失败时阻止提交
  4. 04支持 Cursor

适用场景

  1. 01防止带着失败测试的代码进入提交历史
  2. 02让 Agent 每次提交前自动验证改动
  3. 03多人或多次迭代修改中保持主干测试通过
目标
每次 git 提交之前，npm test 都以退出码 0 结束。
退出条件
提交前 npm test 退出码为 0 时放行提交。
每轮之间运行
npm test

启动提示词

在 Cursor 中粘贴运行，Agent 会按下面的步骤循环执行，直到满足退出条件。

prompt.md
开始运行“Pre-Commit Guard”循环。
目标：每次 git 提交之前，npm test 都以退出码 0 结束。
第 1 步：运行测试 — 在提交前执行 npm test，并读取其退出码和输出。 `npm test`
第 2 步：判断是否放行 — 退出码为 0 则允许提交继续；非 0 则阻止提交，并根据失败信息修复后再重新验证。
每轮之间运行：`npm test`
退出条件：提交前 npm test 退出码为 0 时放行提交。

步骤

每一轮按顺序执行；未满足退出条件会进入下一轮，最多重复 1 轮。

01
运行测试

在提交前执行 npm test，并读取其退出码和输出。

$npm test
02
判断是否放行

退出码为 0 则允许提交继续；非 0 则阻止提交，并根据失败信息修复后再重新验证。

未通过 → 下一轮满足条件即退出

支持的 Agent

可以直接运行这个 Loop 的编码 Agent。

Cursor
Claude Code

评论

支持 Markdown