principle-prove-it-works

证明它确实有效

直接检查实际情况，验证每项任务的输出。不要根据代理指标、自我报告或“能编译”来推断。

原因： 未经验证的工作，正确性无从得知。间接验证（文件修改时间、输出是否最新、Agent 自我报告、缓存的屏幕截图）看似比直接观察省事，但基于错误推断采取行动，代价要高得多，不如直接检查源头。

模式： 完成任何任务后，问问自己：“我该如何证明它确实有效？”

检查实际情况，而非代理指标：

• 直接检查进程是否存活，不要通过派生状态间接判断
• 读取实际值，不要读取缓存或派生的表示形式
• 验证失败时，先怀疑观察方法，再怀疑系统本身

代码和功能：

1. 构建代码（必要但不充分）
2. 运行代码并实际使用相关功能
3. 检查完整链路：数据是否从输入流向输出？
4. 对于集成，端到端测试完整的通信链路

委派：相信产物，而非自我报告。 验证委派的工作时，检查实际输出产物（git diff、文件内容、运行时行为），不要只看受托者的摘要。Agent 报告的是他们打算做什么，实际结果未必总是如此。

尽可能编写脚本进行检查

最有力的证明，是一个能重新运行相同比对的确定性脚本，而非一次性的目测。编写脚本并运行，将其输出作为产物保留，供审查者重新运行，而不是让他们相信你的说法。用于比较新旧编译输出的脚本，能发现目测时忽略的问题。

让人类能看到这个产物。只有在大型或复杂工作需要日后审计过程时，才提交它，例如大型移植或迁移（show-me-your-work 技能）。大多数工作只需让产物可见，无须提交。