Nexus Lab 开源了 ack-is-not-done-guard，这是一个微型工具，旨在防止 Claude Code 基于文件的智能体（agents）在达到经过验证的“proven done”状态之前，就声称任务已完成。厌倦了“虚假完成”的开发者现在可以在其流水线中加入一个具体的防护机制。

为什么该工具很重要

Claude Code 智能体通过读写文件进行工作，这种工作流很容易将流程的开始与结束混淆。

工作原理

该工具定义了四个明确的状态：

  • Acknowledged – 任务已被识别。
  • Working – 智能体正在积极处理。
  • Artifact delivered – 所需输出已写入。
  • Proven done – 所有完成条件均已满足。

只有当智能体达到“proven done”状态时，该防护机制才会允许其通过“任务已完成”的声明。该检查非常轻量；它不会监控无关进程，也不会作为一个全规模的编排框架。它可以直接接入 Claude Code 所预期的基于文件的流程。

谁受益，谁被排除在外

由于该防护机制仅专注于基于文件的状态，因此它无法帮助使用其他智能体架构或需要更广泛工作流监督的项目。这些团队仍需依赖外部监控或自定义逻辑。

总结

ack-is-not-done-guard 证明了，一个精简且定义良好的状态模型可以填补 AI 驱动的文件工作流中长期存在的可靠性漏洞，为开发者提供一种清晰、低开销的方式，让他们能够确信智能体的“完成”确实意味着任务已真正结束。