Coding Agent 源码研究模板与证据等级

读源码时，最容易把“看起来应该这样”写成“它一定这样”。这份记录方式把代码直接支持的事实、架构推断和未验证项分开。先固定版本，再沿调用关系找依据，读者才有机会重复你的检查。

版本与资料依据

  • last_verified: 2026-08-24
  • version_scope: repository snapshots verified 2026-08-24
  • source_type: official-repository
  • stability: fast-moving

先记录项目、版本、研究日期与覆盖范围，再沿一次任务查看循环、上下文、工具、权限和会话。如果项目还包含压缩、计划、子 Agent、Skills 或 MCP，分别说明它们从哪里接入。最后补充交互入口、持久化、运行观察与安全机制，避免只看到主循环就结束。

  • CONFIRMED：固定 commit 的代码、测试或官方文档直接支持；给出文件/符号链接。
  • INFERRED：由调用关系、依赖或目录结构推断；说明推理链和可证伪条件。
  • UNKNOWN：静态材料未覆盖、需要运行/私有服务/产品行为验证。

研究快照与当前 HEAD 分开记录。更新 HEAD 不自动让旧结论失效，但必须重新核对变更范围后才可更新 last_verified。

一条源码结论至少留下这三样东西

第一，固定仓库提交，避免分支更新后入口改变。第二，写出实际查看的文件与控制流，而不只是贴仓库首页。第三，说明验证方式：静态阅读、执行单元测试、还是跑过完整任务。

本轮 OpenCode 就提供了一个例子：历史路径消失后，必须到新的 SessionRunner 入口追踪，不能只改文章里的核验日期。旧提交仍可复现旧结论，新的实现则需要新的证据。

如果没跑某个项目的构建，就写“静态阅读，未运行”。这不会削弱笔记，反而能让下一位读者知道该从哪里继续。

本节的核验依据

2026-10-25 查阅。下面的链接支持本节的机制说明；练习场景和选型建议是本教程的教学设计。