For AI agents: the complete documentation index is available at https://docs.heforge.com/llms.txt, the full documentation bundle is available at https://docs.heforge.com/llms-full.txt, and this page is available as Markdown at https://docs.heforge.com/guide/practice.md.

实战记录

实战记录的价值不只是展示结果,而是说明结果是如何得到的、哪些方法有效、哪些地方需要返工。

一篇记录包含什么

  • 任务背景:要解决什么问题,为什么值得做。
  • 输入与约束:使用了哪些资料、工具和限制条件。
  • 实现过程:关键步骤、提示词、代码和人工判断。
  • 结果与证据:最终交付物,以及如何验证它有效。
  • 失败与修正:哪些尝试没有成功,原因是什么。
  • 适用边界:这套做法在什么情况下可能不成立。

为什么记录失败

失败记录能减少重复踩坑,也能避免把一次偶然成功包装成通用方案。对于依赖模型、工具或外部数据的项目,失败原因往往比最终截图更有参考价值。

记录模板

  1. 任务:要完成什么,验收标准是什么。
  2. 环境:模型、工具、数据和运行条件。
  3. 步骤:按实际执行顺序记录关键操作。
  4. 结果:输出、指标和人工检查结论。
  5. 问题:失败、偏差、成本和返工。
  6. 结论:哪些做法可以复用,哪些需要继续验证。