Jeffy Loop Skill：让 Claude Code 自动审计修复代码的自主循环

Skill超级捕获手 技术创作者 2026-08-21 15 阅读

Jeffy Loop 是一款为 Claude Code 打造的自主代码审计与修复循环工具。它让 Claude Code 以”资深工程师”的纪律运行：先全面审计代码库、再按优先级逐个执行任务、每个修复都通过项目自身的测试验证，只有当全新审计确认无遗留问题时才宣告完成——而非靠感觉。2026年7月底发布后即登上 Hacker News，GitHub 累计约 1,035 颗星（截至2026-08-21），已在 bat、fasthttp、chalk 等知名开源项目中实测发现并修复真实 Bug，甚至在 Anthropic 官方的 claude-code-action 中发现安全漏洞并被官方确认为有效报告。

功能与原则

Jeffy Loop 不是又一个代码生成工具，而是一套叠加在 Claude Code 之上的工程纪律层。它的核心设计原则：

  • 先审计，后行动：首次运行先对整个代码库做全面审计，生成带可执行验收条件的优先级 backlog
  • 一次一任务，验证通过再前进：每个任务单独执行，背后有 git checkpoint + verify gate，破坏测试就回滚
  • 收敛条件可验证：只有当全新审计报告无 High/Medium 问题、adversarial evaluator 双方签字确认，才算”完成”
  • 透明可查：所有运行记录公开，包含不收敛的尝试——18 次未收敛的记录也在 evals/ 目录

认可度

  • GitHub 星数：约 1,035（截至 2026-08-21）
  • 发布平台：2026年7月26日登陆 Hacker News
  • 外部验证：已在 37 个真实开源项目上运行，覆盖 13 种语言，每一轮运行记录全部公开可查
  • 行业认可：在 bat（安全 flag 未生效）、fasthttp（Content-Length 解析错误）、chalk（并发 Bug）中发现的修复已合并上游；chalk 维护者复现后自行写了修复并合并入 v6.0.0
  • 安全漏洞上报：在 Anthropic 官方 claude-code-action 中发现安全漏洞，于 2026-08-20 被 Anthropic 安全项目确认为有效报告（Low 级，2.3分）

链接

GitHub：https://github.com/lenamonj/jeffy-loop

原作者

Jeff Lenamon（GitHub: @lenamonj），技术博主/独立开发者。Jeffy Loop 的灵感来源是 Geoffrey Huntley’s Ralph technique——”把 agent 的输出作为下一轮 prompt 重新喂入”这一朴素的循环增强思路。

介绍

传统的 AI 编程工作流是：人类提示 → AI 生成 → 人类检查 → 再提示——人始终是那个”human loop”，被卡在检查和再提示之间。

Jeffy Loop 的出发点是：把人也解放出来。它在 Claude Code 的每次回复末尾插入一个 shell stop hook，让 Claude Code 重新读取自己的 plan、backlog 和 journal，用这些文件驱动下一轮迭代。这样一来，Claude Code 不再是单次问答，而是一个有记忆、有方向、有自我纠正能力的持续运行的代理。

第一轮迭代先对整个代码库做广度优先审计，把所有发现的问题按 High/Medium/Low 排序，写入 backlog，每条任务附一个可运行的验收检查。然后逐条执行：一次只做一件事，通过项目的测试套件后才算完成，Git 自动保存 checkpoint。若测试失败，自动回滚。

“完成”的定义不是感觉，而是双重确认：全新审计报告 + adversarial evaluator（持有与运行全程无关的全新上下文的评估子代理）双方签字，再加上一个纯 shell 脚本跑一遍所有验收条件。三者全部通过，收敛才算数。

特点

  • Checkpoint + Rollback：每次修复前 git commit，verify 失败自动回滚，代码库始终处于可用状态
  • Backlog 优先级明确：High → Medium → Low，所有决策有据可查，不是随机修
  • Adversarial Evaluator 双签：独立的评估子代理持有全新上下文，对运行自身的说服力免疫，必须独立验证通过才放行
  • 收敛可证明：不靠”感觉不错”，靠全新审计报告 + evaluator 双签字 + shell 验收三重复核
  • 全量透明记录：18 次不收敛的尝试也公开——包括用了多少预算、在哪一步卡住、为什么不收敛
  • 配套 32 页白皮书：从 ReAct → AutoGPT → Ralph Loop 讲起，逐条解释每条规则的第一性原理

使用方法

安装只需两步（installer 自动处理 jq 等依赖）：

# 1. 克隆仓库
git clone https://github.com/lenamonj/jeffy-loop

# 2. 运行安装脚本（macOS/Linux）
./install.sh
# Windows
./install.ps1

安装后在任意 Claude Code 会话中运行：

# 让 Jeffy Loop 对当前代码库运行审计+修复，最多 N 轮迭代
/jeffy 10

Jeffy 会立即开始第一轮：对项目做全面审计，生成 backlog，然后按优先级逐条执行和验证。执行完毕后会得到一份 plain report，说明”改了哪些文件、修了什么问题、还有什么遗留需要人工判断”。

也可以不设预算上限，让它自己跑到收敛：

/jeffy

使用场景与人群

  • 独立开发者：维护自己的开源项目，想系统性地过一遍代码质量但没时间手动逐文件审查
  • 团队技术负责人：在 Code Review 前让 Jeffy 先跑一轮，接收一个结构化的 backlog 而不是一堆随意发现的问题
  • AI Coding Agent 研究者：Jeffy 的 32 页白皮书 + 公开的全部运行记录是关于”如何让 agent loop 可信收敛”的完整一手资料
  • CI/CD 集成：stop hook 支持 Git Hook，可配置为每次 push 后自动触发一轮小型审计

输入与输出案例

输入（在任意 Claude Code 会话）：

/jeffy 8

输出（示例流程，基于 kenrethreitz/records 项目）：

  • 审计发现 4 个 High severity bug，全部藏在原本 green 的测试套件背后
  • Jeffy 为每个 bug 写了 repro.py + regression test，证明测试套件本身有盲区
  • 结构性修复：事务边界修复（rollback 后重新 raise），恢复了上游曾引入并 revert 的正确行为
  • 最终：37 个测试全部通过，4 个 High 修复合并上游，chalk 维护者独立复现并自行写了 fix 于 v6.0.0 发出

收敛报告片段：

converged ✓
- High: 0 remaining
- Medium: 0 remaining  
- Low: 0 (all fixed or declined with written reason)
- evaluator sign-off: PASS (×2)
- artifacts: repro.py, fixes.patch (~180 lines), journal of each iteration

GitHub: https://github.com/lenamonj/jeffy-loop

评论区

0 条评论

登录后可评论。

Skill超级捕获手 15 阅读