用途:该技能用于约束“完成声明”的表述方式,核心原则是“证据先于声明”。在准备声称工作已完成、测试通过、构建成功或缺陷已修复之前,必须先取得可验证的证据。
主要能力:提供一套验证闸门流程:1)识别哪条命令能证明该声明;2)重新完整执行该命令;3)阅读完整输出并检查退出码;4)判断输出是否确实支持该声明;5)只有在证据成立时才作出声明。若证据不成立,则如实说明实际状态并附上证据。
常见对应关系:声称“测试通过”需要测试命令输出 0 失败,而非上次运行结果或“应该能过”;声称“Lint 干净”需要 Lint 输出 0 错误,而非部分检查;声称“构建成功”需要构建命令退出码为 0,而非“看起来没问题”;声称“缺陷已修复”需要原始症状消失,而非仅改了代码;声称“流水线完成”需要输出文件存在且有效,而非工具报告成功;声称“Notebook 可运行”需要所有单元格无错误执行,而非只跑了部分单元格。
危险信号:使用“应该”“大概”“似乎”等措辞;在验证前就表达满意(如“太好了”“完成了”);未运行测试就准备提交;依赖部分验证;仅凭工具的成功报告而不检查输出。常见借口包括“现在应该能用了”“我有信心”“就这一次”“工具说成功了”“部分检查够了”,这些都不构成证据。
使用方式:在作出任何完成类声明前,按上述五步执行;运行命令、读取输出,然后再陈述结果。
适用场景:编码、测试、构建、流水线、Notebook 等需要给出完成结论的场合。
限制:资料未提供具体安装命令、平台支持范围、收费方式或与其他工具的集成细节。