新条目怎么加

本目录评估外部材料要不要、以及怎样进 agent24。一篇文章、一个仓库、一种模式、一种性能手法、一件工具或一种接口，都走同一套三份文档。

用户笔记可能是中文。三份文档用中文写。技术专名保留 English，例如 run_loop、ModelProvider、MCP。

topics/agent24-evolution/
  README.md                 索引：状态 + 一句话结论
  WORKFLOW.md               本文件
  baseline/                 架构基线与阅读快照
  templates/recommendation.md
  items/E000-短名/          每个条目三份文档
  references/               上游清单。checkouts/ 不入库

不使用 git submodule，不提交第三方源码树。理由见 references/README.md。

命名

条目 ID：E 加三位数字，从 E001 起，只增不改。
目录名：items/E001-kebab-slug/。slug 用小写英文，短，不用日期当目录名。日期写在 intake 里。
三份文件名固定：intake.md、analysis.md、recommendation.md。
建议稿从 templates/recommendation.md 复制，改掉 E000。

三份文档各写什么

文件	何时必须有	内容
`intake.md`	一收到就写	来源链接、收到日期（UTC）、用户原话、材料类型。原话逐字保留，不润色。长文不整篇粘贴，记下链接、访问日期和与判断有关的摘录范围。
`analysis.md`	开始研究时写	材料在讲什么、agent24 对应的代码路径、哪些是事实、哪些是推断。可以写长。
`recommendation.md`	可以下判断时写	按模板。先结论，保持短。不把分析稿再贴一遍。

intake.md 开头用这个字段块：

# E001 标题

- ID：E001
- 类型：article | repo | pattern | tool | interface | technique
- 状态：recorded
- 收到日期：YYYY-MM-DD
- 来源：https://...
- 访问日期：YYYY-MM-DD

## 用户原话

> 逐字粘贴。

类型可以多选，用逗号隔开。状态只在索引和 intake 里各写一次，以索引为准。分析稿和建议稿若写状态，改索引时一起改。

状态

状态	含义
`recorded`	只有 intake。还没研究。
`researching`	分析稿已开始，建议稿还没有结论。
`recommended`	建议稿已给出 `yes` / `partly` / `no`。
`parked`	明确先不做。索引的一句话结论写明原因。
`superseded`	被后一条目代替。索引链到新 ID。不删旧目录。

研究完成不等于 agent24 已经实现。索引不把 recommended 写成已排期。

索引

每加一条，就在 README.md 的表里加一行：ID、标题、类型、状态、一句话结论、收到日期、目录链接。

一句话结论在 recorded 和 researching 时写「待评」。进入 recommended 后用判断本身，例如「部分借鉴：只借审批门，不借它的图编排」。

对照基线

建议稿里的「当前架构是否撑得住」必须引用 agent24 架构基线里的路径，或引用阅读快照那个 SHA 上的新读到的行。

基线 SHA 与 agent24 main 不一致时，先在分析稿注明差了哪些提交，再决定要不要先更新基线。更新基线时改 snapshot，并在 architecture 里只改受影响的小节，保留旧结论可追溯。不要把基线写回 T001 至 T009。

一次运行的顺序

分配下一个 E 编号，建目录，写 intake.md，索引状态 recorded。
按 references/README.md 准备需要的检出。新上游补进 references/repos.md。
写 analysis.md，索引改为 researching。
复制模板，写 recommendation.md，索引改为 recommended 或 parked，填一句话结论。
提交只包含本目录的文档。不提交 references/checkouts/。