用途
该技能用于约束“完成声明”的纪律:在工作被声称已完成、已修复或已通过之前,强制要求先取得新鲜、完整的验证证据。资料将其定位为诚实性规则,而非效率工具——未经验证就宣称完成属于不诚实。
核心原则与铁律
- 核心原则:证据先于声明,始终如此。
- 铁律:没有新鲜的验证证据,不得作出任何完成声明。
- 如果在本条消息中没有运行过验证命令,就不能声称它通过。
- 违反规则的文字也违反规则的精神。
五步门控流程
在声称任何状态或表达满意之前:
- 识别(IDENTIFY):什么命令能证明这个声明?
- 运行(RUN):执行完整的命令(新鲜、完整)。
- 读取(READ):阅读完整输出,检查退出码,统计失败数。
- 验证(VERIFY):输出是否确认了声明?若否,带证据陈述实际状态;若是,带证据陈述声明。
- 只有此时才作出声明。 跳过任何一步即视为撒谎,而非验证。
常见失败对照
资料给出若干“声明—所需证据—不充分证据”的对照:
- 测试通过:需要测试命令输出显示0失败;上一次运行、“应该会过”不充分。
- Linter干净:需要Linter输出0错误;部分检查、外推不充分。
- 构建成功:需要构建命令退出码0;Linter通过、日志看起来正常不充分。
- Bug已修复:需要测试原始症状通过;改了代码、假设已修复不充分。
- 回归测试有效:需要验证红-绿循环;测试只通过一次不充分。
- 代理完成:需要版本控制差异显示变更;代理报告“成功”不充分。
- 需求满足:需要逐行核对清单;测试通过不充分。
危险信号(应立即停止)
- 使用“应该”“可能”“似乎”等措辞。
- 在验证前表达满意(如“太好了!”“完美!”“完成了!”)。
- 未验证就准备提交、推送或创建PR。
- 信任代理的成功报告。
- 依赖部分验证。
- 想着“就这一次”。
- 疲倦且想尽快结束工作。
- 任何暗示成功但未运行验证的措辞。
借口预防
资料列出常见借口与对应现实,例如:“现在应该能工作” → 去运行验证;“我有信心” → 信心不等于证据;“就这一次” → 没有例外;“Linter过了” → Linter不等于编译器;“代理说成功了” → 独立验证;“我累了” → 疲倦不是借口;“部分检查够了” → 部分证明不了什么;“换个说法规则就不适用” → 精神高于文字。
关键模式
- 测试:✅ 运行测试命令,看到34/34通过,然后说“所有测试通过”;❌“现在应该会过”“看起来正确”。
- 回归测试(TDD红-绿):✅ 编写→运行(通过)→回退修复→运行(必须失败)→恢复→运行(通过);❌ 只说“我写了一个回归测试”而未验证红-绿循环。
- 构建:✅ 运行构建,看到退出码0,说“构建通过”;❌ 用“Linter通过”代替(Linter不检查编译)。
- 需求:✅ 重读计划→创建清单→逐项验证→报告缺口或完成;❌ 以“测试通过”宣称阶段完成。
- 代理委托:✅ 代理报告成功→检查VCS差异→验证变更→报告实际状态;❌ 直接信任代理报告。
适用时机
始终在以下情形之前应用:任何形式的成功/完成声明;任何满意表达;任何关于工作状态的正面陈述;提交、创建PR、任务完成;转入下一任务;委托给代理。规则适用于原句、转述与同义词、成功暗示,以及任何暗示完成或正确的沟通。
限制与未提供信息
该技能本身不执行验证,也不提供具体项目的测试、构建或Linter命令;实施者需自行识别对应命令。资料未说明安装方式、收费/价格、支持的平台或工具集成方式,这些信息暂未提供。