bruhook

Claude Code 的编程伙伴,自动审查代码、追踪计划、防止跑偏。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:bruhook。
它的用途是:Claude Code 的编程伙伴,自动审查代码、追踪计划、防止跑偏。
完整的 Skill 内容见:https://321skill.com/skills/bruhook/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'/plugin install github:geakstr/bruhook' 安装插件,然后设置 `export BRUHOOK_ENABLED=true`。当你开始一个复杂的重构任务时,先让 Claude 制定一个计划。之后 bruhook 会在后台自动工作,如果你离开后回来,使用 `/resume` 命令,它会自动帮你恢复之前的计划和审查记录,确保开发不跑偏。

介绍

bruhook 是专为 Claude Code 设计的插件,旨在解决长时间编码会话中常见的痛点。在复杂或长时间的开发任务中,开发者常面临上下文丢失、开发计划偏离、AI过早宣告完成等问题,导致效率低下和返工。

该插件通过一组自动化的钩子(hooks)无缝集成到 Claude Code 的工作流中。启用后,它会自动关联会话与计划文件,在代码变更时进行后台审查,检查是否符合既定计划,并在会话恢复时自动注入之前的上下文和审查日志。当 Claude 试图结束任务时,它还会检查计划是否真正完成,从而确保任务的完整性。

它非常适合依赖 Claude Code 进行中大型项目开发、重构或复杂功能实现的开发者,尤其是那些需要保持开发方向一致性和上下文连续性的全栈或后端工程师。

使用时,建议在开始复杂任务前先制定清晰的计划文件。虽然插件能有效防止计划偏离,但其审查基于文件整体对比,在频繁进行微小修改时可能带来额外开销。对于快速原型或简单脚本编写,可以考虑暂时禁用。

核心特点

与普通的代码审查或计划管理工具不同,bruhook 深度集成到 Claude Code 的会话生命周期中,能自动检测并阻止 AI 在任务未完成时停止,并能主动恢复因会话中断或压缩而丢失的上下文,这是其核心的防跑偏和连续性保障能力。

注意事项

目前其代码审查机制在每次文件编辑时都会检查整个文件,对于频繁进行微小修改的场景可能效率不高。

常见问题

bruhook 会影响 Claude Code 的响应速度吗?

后台审查和检查会在独立会话中运行,通常不影响主会话的响应,但频繁的文件变更可能会增加系统负载。

如何查看 bruhook 生成的审查日志?

在项目目录下的 `.bruhook/reviews/` 文件夹中,或直接在 Claude Code 会话中使用 `/bruhook:log` 命令查看。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/bruhook/raw/index.md 读取 bruhook 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。