Boffin (npm: boffinit) 是AI编码代理的员工工程师控制层：它为代理提供正在编辑的确切文件的架构约束，并让其验证结果 -- DuckDB案例研究：一次指导性的重构实现了+17 / -17行，2,104个断言通过。你要求15行的修复；代理却带来了500行的重构。Boffin为代理提供适用于其即将修改的文件的架构约束，然后让其验证结果。这不是另一个AGENTS.md，也不是一个提示包。这些格式通常为整个代码库提供一个静态的指令块；Boffin仅路由与当前编辑相关的约束。 由ParselFire Core驱动。npx boffinit cursor Boffin不是 - 不是一个静态的全仓库规则文件（AGENTS.md 形式的一个块适用于所有）； - 不是提示包或系统提示技巧； - 不是静态分析工具或CI门槛 -- 它在编辑前后起作用； - 不是一个速度工具 -- 该框架是审查安全的。 Boffin的功能 - 选择与代理眼前编辑相关的约束； - 要求与更改成比例的验证； - 通过一个npm包支持Cursor，Claude Code，Codex和OpenCode； - 提供由ParselFire Core驱动的签名可移植包。 它的不同之处（诚实比较） - 静态规则文件（AGENTS.md） - Boffin交付：通常为整个仓库提供一个静态块； - 约束路由到当前编辑； - 验证：格式不要求； - 根据变化的要求进行； - 证据：通常没有； - 记录的案例研究和数字； - 证明，而非承诺。 公共案例研究记录这些在真实开源代码上的指导性重构： - DuckDB：+17 / -17；2,104个断言通过；保存了不同的继续和恢复路径。 - FastAPI：+16 / -33；49个测试通过；没有公共API变化。 - LangChain：同步/异步边界得以保留；4个测试通过。 这些是可重复的案例研究，而不是受控的A/B基准。 安装Boffin需要Node.js 18或更高版本。 Cursor 从你的项目运行：npx boffinit cursor Claude Code 在Claude Code中运行这些：/plugin marketplace add MicSm/boffin /plugin install boffin@boffin Codex 从终端运行这些：codex plugin marketplace add MicSm/boffin codex plugin add boffin@boffin Codex不自动信任插件钩子。在Codex中运行/hooks一次，以审查和信任Boffin的钩子；在此之前，插件的技能可以工作，但自动的每个会话激活仍然关闭。 OpenCode 从你的项目运行：npx boffinit opencode 然后在OpenCode中打开项目。始终在线的指导通过opencode.json -> .boffin/AGENTS.md到达。 按需：/boffin，/boffin-review或boffin / boffin-review技能。 安装细节、命令和故障排除：OpenCode交付。 想了解机制吗？阅读ParselFire Core的工作原理。 Boffin对什么苛刻 相似代码不总是相同的代码。Boffin给代理提供理由，在合并真实特例之前停止，混淆同步/异步边界，使状态远离其所有者，或将集中任务变成代码库的游览。对于专注的更改，它保持请求的范围小，并要求最小的检查来证明编辑。对于开放式重构或审查，它首先需要一次只读审计，之后逐个验证发现。当清理与早期正确性规则冲突时，正确性取胜。要点不是让代理变得胆怯，而是让昂贵的细节在它们变成一个有趣的下午之前变得明确。 常见问题 Boffin与AGENTS.md有什么不同？ AGENTS.md通常是整个代码库的一个静态指令文件。Boffin仅路由与代理即将编辑的文件相关的架构约束，然后要求与更改成比例的检查。 约束从何而来？ 每条规则都作为可读的版本化markdown文件在此代码库中以 packs/ 形式分发，并且这些包是GPG签名的。在安装时没有隐藏的东西：打开任何一个包并在信任之前阅读每条规则。在编辑时，Boffin选择适用于被修改文件的规则。查看ParselFire Core的工作原理以了解路由图。 为什么我的编码代理将小修复变为巨大的重写？ 你请求一个小修复；代理却带来了重构。Boffin在编辑之前注入当前文件的承载约束并强制验证。lite、full和max变化是什么？ 它们调整清理的雄心，而不是正确性：lite保持清理压力低，并偏向最小的有效更改。full是平衡的默认设置。max在任务合理时施加最强的清理压力。在插件主机上，使用/boffin lite、/boffin full或/boffin max选择一个配置文件。没有关闭的配置文件。配置文件改变安全底线吗？ 不。每个配置文件保持相同的初始正确性阶段和拒绝规则，包括信任边界验证、数据丢失预防、安全性和可访问性要求。