一个出色的 STEM 项目，可能仅仅因为一个原因就输给较弱的对手：没有人能看清学生到底做了什么、做了哪些决定、又发现了什么。
无论你是在搭建机器人、训练模型、开展实验，还是在解算法题，你的工作可信度高低，完全取决于你对它的记录。评委、老师和招生官无法亲眼看着你工作——他们只能阅读你的文档。学会清晰地记录 STEM 项目，是一项能在孩子参加的每一场竞赛和每一次申请中持续带来回报的技能。
本指南将说明应该记录什么、何时记录，以及如何组织这些记录，让评审能够顺着你的思路，从最初的草图一直追溯到最终结果。
为什么文档决定成败
大多数重要竞赛都会正式评估记录本身。在机器人项目中，工程笔记的评分依据是：它是否界定了问题、是否展示了头脑风暴与原型制作、是否论证了所选方案的合理性，以及是否证明了设计流程经过反复迭代以提升性能。在科学研究展中，实验日志是评审标准的一部分，评委期望能够从头到尾追踪一个项目。
还有第二个、更不易察觉的原因。带有日期的早期记录——粗略的草图、失败的原型、不断演进的代码——是证明这项工作确实出自学生本人之手的最有力证据。相比一份凭空出现、打磨光鲜的最终报告，评审更信任一个能看到它随时间逐步成长的项目。
真正关键的检验标准：一位懂行的陌生人应当能够读懂你的记录，要么准确理解你是如何得出解决方案的，要么自己就能复现它。
记录什么（以及何时记录）
良好的文档是一种习惯，而不是最后一周的临时突击。要边做边记，每条记录都标注日期。在大多数 STEM 学科中，都会反复出现以下这些核心要素：
- 问题与目标——在每个周期开始时，用平实的语言陈述要研究的问题或挑战。
- 背景与调研——你查阅过的资料来源，附上链接和引用，以便他人核查你的依据。
- 想法与备选方案——多个候选解决方案，配上带标注的草图或示意图，而不仅仅是你最终采用的那一个。
- 决策及其理由——你为何选择这一方案而非其他（一张决策矩阵表或一段简短的测试结果就很有用）。
- 方法与搭建步骤——细节要足够充分，让你所在领域的读者能够重建或重跑这项工作。
- 数据与结果——测量值、运行记录、图表和截图，包括那些失败的实验。
- 迭代过程——展示这个循环。最出色的笔记能证明设计流程经过反复迭代以求改进。
- 结论与致谢——你学到了什么、还有哪些问题尚未解决，以及你获得过的任何帮助。
记录要保持清晰可读、井然有序。一本装订成册、预先编号、用墨水书写的笔记是经典标准，但如今大多数竞赛也接受按同一评分标准评判的电子版——在确定格式之前，请查阅你所参加的具体竞赛规则。
记录代码与数据类项目
对于编程、人工智能和计算类工作，你的"笔记本"在很大程度上就是你的代码仓库。从第一天起就使用版本控制。一份清晰的提交历史本身就是文档：小而描述清楚的提交，不仅说明了你改了什么，更说明了为什么要改。再搭配一份扎实的 README，写明项目的功能、如何安装运行，以及如何复现你的结果。
通过我们的竞赛编程方向备战算法竞赛的学生，会从记录每道题的思路中获益良多——尝试过的方法、复杂度分析，以及解法在哪里出了问题。同样的训练直接延伸到人工智能与机器学习项目中，评审希望看到你的数据来源、预处理过程，以及支撑每一个上报数据背后的实验。
把你的记录变成一个故事
原始笔记是基础，但最终的交付成果应当读起来像一段叙事。围绕整个历程来组织它：问题是什么、你尝试了什么、证据显示了什么、你又得出了什么结论。一个简单的报告结构——目的、假设或目标、材料与方法、结果、讨论以及参考文献——能让所有内容都易于查找。
评委会奖励对死胡同的坦诚。一次你认真分析并从中汲取教训的失败记录，往往比一个背后看不到任何挣扎的结果更能打动人。
最后，要为你的读者而写。定义专业术语，为每一幅图标注说明，并交代足够的背景，让团队之外的人也能跟上你的思路。清晰并非装饰——在竞赛中，它就是分数。
在 BIAA（标奥），从机器人搭建到原创研究，扎实的文档已融入我们学生的工作方式之中。欢迎了解我们的研究导师计划，看看我们如何帮助有抱负的 K-12 学生，把项目转化为经得起任何评委检验的记录。