Apollo
全部栏目

结构化笔记

结构化笔记用稳定字段记录目标、进度、证据和未决问题，方便跨会话继续工作，也方便其他执行者接手。

返回概念图谱 →

理解与应用

结构化笔记是按固定栏目或字段组织信息的记录方式。它可以是一份带标题的文档，也可以是 JSON，不一定需要复杂数据库。相比按时间堆积的聊天记录，它让读者能直接找到当前目标、已经确认的结果和下一步。结构的价值在于减少查找与误解，而不是把所有内容都塞进表格。

例如周报快写完时交给另一个助手接手。“数据差不多齐了，继续完善”很难执行；写明“研发和销售数据已核实，运营退款口径未定，草稿在 draft-2”，接手者就知道从哪里继续。如果完成项附有对应表格或检查记录，就能区分已经核对的结论和原作者的猜测。对于复杂背景，字段之外仍可以保留一小段说明，避免结构化后丢掉来龙去脉。

笔记还需要随工作更新。运营数据确认后，应把原来的阻塞改为已解决，并留下新依据；多个执行者同时修改时，则需要明确谁维护状态或使用版本检查，防止旧副本覆盖新进展。字段完整只能说明记录格式合格，不能证明所指文件确实存在、测试真的通过。因此，交接时仍应能打开证据，完成状态也应与可观察的产物一致。

关系速览
结构化笔记应用于 →智能体记忆

结构化笔记可保存有来源的事实与待办，但不应把模型猜测永久化。

结构化笔记应用于 →上下文压缩

压缩时可以保留结构化事实、来源和未完成动作，以便检查摘要是否丢失约束。

看看如何配置：一份可以直接接手的周报笔记

笔记明确区分已验证结果与待解决问题，并提供继续工作的入口。编号是示例引用；实际交接时，对应记录需要真实存在且接手者可访问。

以下为教学示意，未连接真实业务系统。

配置示意

记录版本：3
任务：青禾项目 6 月第一周周报
当前草稿：draft-2

已验证结果：
  研发数据口径已核对，依据 check-17。
  销售数据口径已核对，依据 check-18。

未解决问题：
  运营表中的金额是否已经扣除退款？
  原始资料：data-19；目前没有足够证据确认。

下一步：读取 data-19 的字段说明，必要时询问数据提供者。
交付状态：未交付，运营部分尚未完成。

配置对应的行为

接手者应先核对 data-19 的字段说明，再更新运营部分。
不能仅凭“记录版本为 3”推断报告完成，也无需重复核对已有证据的两个部门。

常见误区

  • 只填“状态=完成”而没有产物或证据，结构化字段会把不确定的进度包装得过于确定。
  • 多人分别维护副本而没有版本或所有权约定，容易把已经解决的问题恢复成旧状态。

前置与延伸

建议先读

相关概念

参考与版本

Apollo 原创讲解与教学示例。参考资料用于核对技术定义；核验日不代表资料的发布日期。