Project 03. 让 agent 关掉再打开还能接着干

相关讲义：L05. 为什么长时任务会丢失上下文 · L06. 为什么初始化需要单独一个阶段本篇模板文件：templates/

你要做什么

P02 解决了"接手"的问题，但 agent 接手之后能不能把活干完、干对了，又是另一回事。这个项目要你给 agent 加上范围控制和验证关卡。

你要实现的知识库功能是：文档分块、元数据提取、索引进度显示、带引用的问答流程。这些功能比前两个项目复杂，agent 更容易跑偏——要么多做了不该做的，要么说做完了但其实没通过验证。

你需要一个 feature_list.json，每个功能有明确的状态。规则很简单：一次只做一个功能，没有可运行的验证证据就不能标成 passing。仓库里的 starter 已经有早期版功能清单，但缺少完整的重启和交接产物；solution 则补齐这些产物。比较两者，看结果差多少。

目录	里面有什么	比较什么
`starter/`	Project 02 代码，索引和带引用问答未完成。有 starter 版 `feature_list.json`，但缺少最终重启/交接产物。	agent 是否跨多个功能漂移，重启后是否丢状态。
`solution/`	完成文档分块、元数据、索引状态、带引用问答，并加入 `init.sh`、`session-handoff.md`、`claude-progress.md`、`clean-state-checklist.md`。	每个功能是否有验证证据后才标为 passing。

本项目对应的产品功能不是泛泛的"多会话"，而是文档分块、元数据提取、索引状态 UI、带引用问答。

切到 p03-baseline 分支。

切到 p03-improved 分支。在启动 agent 之前：

对照 solution 中的 AGENTS.md、feature_list.json、init.sh、session-handoff.md、claude-progress.md。
明确规则：一次只做一个功能；状态只能在有验证证据后切到 pass。
每次会话结束前更新交接和进度产物。

然后启动 agent：