kunchenguid/gnhf

Before I go to bed, I tell my agents: good night, have fun

它解决了什么问题

gnhf 是一个用于编码代理的自主编排器,它允许代理在长时间(例如通宵)内处理代码库,而无需持续的人工监督。它通过确保代理朝着目标进行小规模、已提交且有文档记录的增量更改,而不是尝试一次巨大且有风险的飞跃,从而解决了“一觉醒来一无所获”的问题。

工作原理

该工具在一个循环中封装了现有的编码代理 CLI。对于每次迭代,它会:

  1. 提示代理:注入一个目标和一个 notes.md 文件(作为跨迭代的共享内存)。
  2. 执行:以非交互模式运行代理。
  3. 验证并提交:如果代理成功,gnhf 会创建一个 git 提交并追加到笔记中。如果失败,它会使用 git reset --hard 回滚更改(除非是提交失败,这种情况下它会保留以供修复)。
  4. 处理限制:它通过在恢复前等待重置时间,自动管理速率限制(例如 Claude 的使用窗口)。
  5. 管理状态:它可以在专门的 gnhf/ 分支、当前分支或隔离的 git 工作树中运行,以允许多个代理同时在同一个仓库上工作。

适用人群

使用 AI 编码代理并希望自动化长时间运行的重构、功能实现或代码库清理,而无需每隔几分钟监控终端的开发者。

亮点

  • 代理无关:适用于流行的编码代理 CLI 和任何 ACP 目标。
  • 增量进度:每一步成功的操作都会提交到 git,便于轻松进行 cherry-pick 或回滚。
  • 工作树支持:在隔离的目录中同时在同一个仓库上运行多个代理。
  • 智能速率限制处理:自动在 API 使用窗口期间休眠并在之后恢复工作。
  • 恢复能力:如果中断,可以从现有分支接续之前的运行。

相关

  • 项目
  • 项目
  • 项目
  • Dispatch
  • 项目