在提交代码或创建PR前声称工作完成、已修复或通过时使用——必须先运行验证命令确认输出,再做成功声明;证据永远先于论断。
完成前的核查是一项面向实际任务的技能,主要用于要求工作完成而无需核查是不诚实的,而不是效率的;核心原则: 索赔前的证据, 总是;
该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
未经验证即宣称工作已完成,是不诚实行为,而非高效表现。
核心原则:先有证据,再作声明,始终如一。
违反本规则的字面表述,即等于违背其精神内核。
未提供最新验证证据,不得宣称完成
若你尚未运行本消息中指定的验证命令,则不得宣称其通过。
在宣称任何状态或表达满意之前: 1. 识别:哪条命令可证实该主张? 2. 运行:完整执行该命令(必须为全新、完整执行) 3. 阅读:完整查看输出,检查退出码,统计失败项数量 4. 验证:输出是否确凿支持该主张? - 若否:如实陈述当前状态,并附上证据 - 若是:在陈述主张的同时,附上对应证据 5. 仅在此之后:方可正式作出该主张 跳过任一环节 = 撒谎,而非验证
| 宣称内容 | 必需条件 | 不充分情形 |
|---|---|---|
| 测试通过 | 测试命令输出:0 个失败项 | 此前某次运行结果、“应该能通过”等推测性表述 |
| 代码符合规范(Linter clean) | Linter 输出:0 个错误 | 局部检查、推断性判断 |
| 构建成功 | 构建命令退出码为 0 | Linter 通过、日志看起来正常 |
| 缺陷已修复 | 原始问题症状的测试用例:通过 | 仅修改了代码,即“假定已修复” |
| 回归测试有效 | 已验证红-绿循环(Red-Green cycle) | 仅单次运行通过 |
| Agent 已完成任务 | VCS diff 显示存在变更 | Agent 自报“成功” |
| 需求已满足 | 逐条对照的需求清单核查 | 仅测试通过 |
| 借口 | 事实 |
|---|---|
| “现在应该可以工作了” | 请运行验证命令 |
| “我很有信心” | 信心 ≠ 证据 |
| “就这一次” | 绝不设例外 |
| “Linter 通过了” | Linter ≠ 编译器 |
| “Agent 报告成功” | 须独立验证 |
| “我累了” | 疲劳 ≠ 免责理由 |
| “局部检查就够了” | 局部验证无法证明任何结论 |
| “用了不同措辞,所以规则不适用” | 重实质,而非拘泥字面 |
测试:
✅ [运行测试命令] [观察输出:34/34 通过] → 宣称“所有测试均通过” ❌ “现在应该能通过” / “看起来正确”
回归测试(TDD 红-绿循环):
✅ 编写测试 → 运行(应失败)→ 实现修复 → 运行(应通过)→ 回退修复 → 运行(MUST FAIL)→ 恢复修复 → 运行(应通过) ❌ “我已编写了回归测试”(未执行红-绿验证流程)
构建:
✅ [运行构建命令] [观察输出:exit 0] → 宣称“构建成功” ❌ “Linter 通过了”(Linter 不检验编译过程)
需求达成:
✅ 重读方案 → 制作逐条清单 → 逐项验证 → 报告缺口或完成状态 ❌ “测试通过,阶段完成”
Agent 协作委托:
✅ Agent 报告成功 → 检查 VCS diff → 验证变更内容 → 报告真实状态 ❌ 直接采信 Agent 报告
源自 24 次失败经验教训:
ALWAYS 在以下操作前执行:
本规则适用于:
验证不可取巧。
务必运行命令,仔细阅读输出,然后——才可宣称结果。
此为不可协商的底线要求。
相关专题
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 134.1万人学习
共49课时 | 82.6万人学习
最新文章