跳转到主要内容
本指南适用于 contributor-kit/reference-notes/ 下的精选参考说明。

​
什么是参考说明

精选参考说明不是实验室文章，也不是来源项目。 它是一种结构化的来源汇总，帮助未来的贡献者快速理解一个主题。 适用场景：
  • 来源映射
  • 对比汇总
  • 有边界的阅读清单
  • 面向未来实验室扩展的主题简报

​
放置位置与命名

  • 将说明放在 contributor-kit/reference-notes/
  • 使用“主题优先”的文件名，例如 deep-research-source-map.md
请将这些说明与 references/ 中导入的材料清楚分开。

​
必需结构

从 Reference Note Template 开始。 必需章节：
  • Summary
  • Why It Matters
  • Scope Notes
  • Source Map
  • Synthesis
  • Gaps And Follow-up
  • Update Log

​
工作规则

  • 要整理并综合来源，而不是复制它们。
  • 明确说明范围，让未来的贡献者知道这份说明不涵盖什么。
  • 优先使用简短的综合，而不是长篇引用。
  • 让这份说明对未来起草仍然有用，而不只是一个书签堆。

​
完成标准

当参考说明满足以下条件时，即可提交审核：
  • 具有清晰的主题边界
  • 包含真实的来源映射
  • 提供综合内容，而不是原始摘录
  • 保持在导入的 references/ 目录树之外