Community研究与数据分析github.com

mohamedzhioua/agent-done-or-not

捕捉AI代理关于「完成」的谎言。一个单文件证明门,适用于Claude Code、Cursor和Codex。代理必须验证后才能结束。

agent-done-or-not 是什么?

本技能旨在防止AI代理在未经验证的情况下谎称任务完成。它通过一个称为「证明门」(proof gate)的机制,强制代理在执行任何「已完成」声明之前,必须运行一个验证命令(如测试、构建、类型检查、lint、curl等),并记录命令的退出码和输出哈希值。只有在获得新的、通过的验证收据后,代理才能报告任务完成。该技能广泛支持Claude Code、Cursor和Codex等主流AI编程助手,并提供一个「停止门」(Stop gate)来进一步强化规则,即在未有通过证明时阻止代理结束当前轮次。开发者无需依赖直觉或记忆,只需让代理遵循「捕获-验证-报告」的严谨流程,从而大幅提升AI生成结果的可靠性和可信度。

兼容平台✓Claude Code✓Codex CLI✓Cursor
npx skills add mohamedzhioua/agent-done-or-not

Installed? Explore more 研究与数据分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

完成与否(done-or-not)

何时使用

当你即将告诉用户某个任务、构建、测试、修复或验证步骤已完成时,请使用此技能。完成声明需要来自门的证明,而不是信心或记忆。

如何使用

  1. 确定能够证明工作的命令。选择实际验证该声明的最小检查项:测试、构建、类型检查、lint、对运行中端点的curl请求,或其他具有明确通过/失败行为的命令。

  2. 通过证明门运行验证命令:

    bash done-gate.sh capture --label check -- <你的验证命令>
    

    门会记录命令、其退出码以及输出的SHA-256哈希值。它以命令自身的退出码退出,因此失败的检查会导致捕获失败。

  3. 只有在获得新的、通过的收据之后,才能报告工作完成。

  4. 如果检查失败,请修复问题并重新捕获。切勿在红色检查上报告成功。

在支持该功能的工具链中,停止门(Stop gate)会强制执行此规则:在存在新的通过收据之前,它会阻止代理结束当前轮次。请不要绕过门;请提供证明。

相关技能