> 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.

# 实战记录

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

## 一篇记录包含什么

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

## 为什么记录失败

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

## 记录模板

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