研发协作
在声称任务完成、修复或通过前,如何用新鲜验证证据支撑结论
当你准备宣称工作已完成、已修复或测试通过,或准备提交/创建 PR 时,必须先运行验证命令并确认输出,再做出任何成功声明。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 49/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 85/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 60/100 ×0.15
适用场景
在声称任务完成、修复或通过前,如何用新鲜通用
解决思路
- 识别:明确哪条命令能证明该声明。
- 运行:执行完整命令(新鲜、完整地跑一遍)。
- 读取:查看完整输出,检查退出码,统计失败数。
- 验证:判断输出是否支持该声明;若否,则带证据说明实际状态;若是,则带证据陈述声明。
- 只有完成以上步骤后,才做出声明;跳过任一步都等于撒谎而非验证。
- 测试通过:需测试命令输出 0 失败,不能依赖上次运行或“应该会通过”。
- Linter 干净:需 linter 输出 0 错误,不能靠部分检查或外推。
- 构建成功:需构建命令退出码为 0,不能靠 linter 通过或日志看起来正常。
- Bug 已修复:需测试原始症状通过,不能只靠改了代码就假定修好。
- 回归测试有效:需验证 red-green 循环,不能只跑一次通过就算数。
- Agent 已完成:需 VCS diff 显示变更,不能只信 agent 报告“成功”。
- 需求已满足:需逐行核对清单,不能只靠测试通过。
- 出现“应该”“可能”“似乎”等措辞时停止。
- 在验证前表达满意(如“太好了!”“完美!”“搞定!”等)时停止。
- 未验证就准备 commit/push/PR 时停止。
- 信任 agent 成功报告时停止。
- 依赖部分验证时停止。
- 想“就这一次”时停止。
- 因疲惫想赶紧收工时停止。
- 任何暗示成功却未运行验证的措辞都要停止。
- “现在应该能跑了”→ 去运行验证。
- “我有信心”→ 信心不等于证据。
- “就这一次”→ 没有例外。
- “Linter 过了”→ Linter 不等于编译器。
- “Agent 说成功了”→ 独立验证。
- “我累了”→ 疲惫不是借口。
- “部分检查够了”→ 部分检查证明不了什么。
- “换个说法规则就不适用”→ 精神重于字面。
- 测试模式:运行测试命令,看到 34/34 通过,再说“所有测试通过”;不要只说“现在应该能过”或“看起来没问题”。
- 回归测试(TDD Red-Green):写测试 → 运行(通过)→ 回退修复 → 运行(必须失败)→ 恢复修复 → 运行(通过);不要只写回归测试而不做 red-green 验证。
- 构建模式:运行构建,看到退出码 0,再说“构建通过”;不要说“Linter 过了”(linter 不检查编译)。
- 需求模式:重读计划 → 创建清单 → 逐项验证 → 报告缺口或完成;不要只说“测试通过,阶段完成”。
- Agent 委派模式:Agent 报告成功 → 检查 VCS diff → 验证变更 → 报告实际状态;不要直接信任 agent 报告。
- 在任何成功/完成声明、任何满意表达、任何关于工作状态的正向陈述之前都要应用。
- 在提交、创建 PR、任务完成、进入下一任务、委派给 agent 之前都要应用。
- 规则适用于:原话、转述和同义词、成功暗示、任何暗示完成/正确的沟通。
- 核心原则:证据先于声明,始终如此;违反规则字面就是违反规则精神。
- 铁律:没有新鲜验证证据,不得声称完成。
- 如果本条消息中没有运行过验证命令,就不能声称它通过。