工程开发
verification-before-completion avatar

verification-before-completion

强制执行工作验证协议,要求在宣称工作完成或成功前,必须运行验证指令并确认输出,以防止错误的成果声明。

简介

verification-before-completion 技能作为编码代理的严格守门人,确立了一项不可动摇的原则:在没有独立、即时的证据之前,不得宣称任何状态,例如“已修复”、“已完成”或“测试通过”。此技能专为自动化编码代理和旨在消除代码错误假设的开发人员设计。通过将代理的行为从基于启发式的报告转向基于证据的验证,显著提高了交付成果的可靠性。

  • 强制执行严格的识别、执行和确认循环,用于每一个完成声明。

  • 为检查构建成功、测试通过率、代码检查状态和需求合规性提供了系统化框架。

  • 直接整合到开发流程中,特别是在提交、推送或发起合并请求(PR)等 Git 操作之前。

  • 主动打击“合理化”和“代理幻觉”,将任何未经支持指令输出而表达的满意或成功声明视为危险信号。

  • 包含常见软件开发声明与所需证据的全面对照表,例如要求修复 Bug 时必须经过完整的红绿测试(Red-Green TDD)周期。

  • 使用方式:此技能应在任何任务的最后阶段启用,特别是在代理即将宣告任务完成或已验证时。

  • 输入/输出:要求代理识别相关终端指令(例如 npm test 或 cargo build),并处理原始输出流,以确认零失败或预期退出代码,然后才向用户回报成功。

  • 实际限制:代理必须忽略内部的信心指标或先前的运行结果;必须发起新的执行以确保考虑到当前的环境背景。

  • 安全性:遵守此技能可防止因过早自信或疲劳导致的错误而交付包含 Bug、未定义函数或不完整的功能。

  • 整合:它是子代理驱动开发(Subagent-driven development)的重要检查点,确保代理不会委派或批准尚未经过实证验证的工作。

仓库统计

Star 数
170,798
Fork 数
15,078
Open Issue 数
285
主要语言
Shell
默认分支
main
同步状态
空闲
最近同步时间
2026年4月28日 11:38
在 GitHub 查看