agent-project-knowledge-engine。它在 2026 年 8 月 22 日归档，最终进入 040rc1。案例中的目标、child、依赖、提交和验证结果都来自仓库记录。
这次 Change 把 Project Knowledge 从即时运行 ripgrep 的文档检索，升级为面向 Agent 的项目理解能力。最终交付包含 SQLite FTS5 与 ripgrep 混合召回、项目知识单元、受控学习、CLI、Dashboard 和评测体系。
Supervisor 在 Codex 中的执行画面
下面的录屏展示 Supervisor 在 Codex 中创建独立任务、分配 child 和持续统筹的实际界面。录屏用于展示执行机制；本文的 child、提交和验收数据仍来自agent-project-knowledge-engine 归档。
用整体目标约束多个实现阶段
Project Knowledge 的改造横跨检索、索引、知识模型、插件事件、CLI、Dashboard 和评测。各部分可以分阶段实现，但必须共同满足一个产品目标：减少 Agent 的重复探索，同时继续以当前代码、配置和测试作为最终依据。 父级 Change 统一维护以下边界：- Local Provider 默认使用 FTS5 与 ripgrep 混合召回，FTS5 不可用时保留回退；
- Project Knowledge 与 Personal Memory 保持独立所有权、存储和预算；
- 项目知识必须带当前来源，不能代替代码核对；
- 索引故障、来源不可读和语义适配器失败不能阻塞 workflow；
- CLI、Dashboard、生成资产、Retrieval Eval 和 Agent A/B 使用同一能力边界。
从真实依赖拆出三个 feature child
归档中的children.yaml 使用 comet.native.children.v2。初始实施按真实依赖拆成三个 feature child：
这三个 child 形成一条依赖链：
readyChildren。后续 child 从最新集成基线开始，避免基于尚未稳定的数据结构或接口提前实现。
每个 child 在隔离工作区形成可集成结果
三个 feature child 都在自己的工作区完成实现和验证。它们没有直接修改目标分支，而是先进入 Supervisor 的集成分支。 仓库保留了三次真实集成提交：
每个 child 的 feature commit 与集成 commit 分开保留。Runtime 可以据此判断候选是否经过验证、当前集成基线是否包含依赖，以及迟到结果是否仍适用于当前状态。
父级 Verify 暴露跨模块缺口
三个 feature child 集成后，父级没有直接归档。verification.md 记录了两轮失败：
这些问题跨越多个 feature child。重新打开已经集成的 child 会破坏已确认的历史边界，也难以表达新的整体验收范围。Runtime 保留集成现场，并让父级回到 Shape 更新验收与 child 声明。
追加 closure child 收敛真实失败
最终归档的children.yaml 增加了第四个 child：
project-knowledge-closure 聚焦父级 Verify 已经观察到的缺口，包括来源边界、定向刷新、激活条件、workspace 隔离和评测完整性。后续修复提交没有扩大产品目标，而是在现有验收范围内补齐实现证据。
其中，3cd0c25b 完成了最后一轮 review boundary 修复，涉及知识单元、学习流程、插件集成、文件存储和两个评测脚本。这个 child 让跨模块问题拥有独立范围，同时保留前三个 feature child 的集成历史。
最终验收覆盖 49 项行为
第四个目标周期的第二次 Verifier 通过。最终verification.md 记录：
- 49 项验收全部为
passed； - Child 验证、父级集成和父级检查均完成；
- focused tests、Native tests、typecheck 和 build 已执行；
- 独立 code review 的三项重要问题已经修复；
- 没有 Critical 问题和未完成阻塞项。
/comet Skill 长度基线失败。归档没有把它改写为本次能力通过，也没有让无关失败覆盖已经完成的专项证据。
Archive 后一次性交付目标分支
父级完成 Verify 后，以de780ce2 归档。随后 58b6dfb2 把 comet/agent-project-knowledge-engine 合入 040rc1。
整个过程只在父级完成一次最终交付：
从这个案例提取拆分原则
这个真实 Change 展示了 Supervisor 的四个产品特点：
选择 Supervisor Change 的关键依据是整体目标需要多个可独立验证的结果，并且父级仍有不可省略的最终验收。子任务能否同时运行只是执行效率的一部分，明确依赖、隔离候选和统一交付同样重要。
案例证据位于 Comet 源码仓库的
docs/comet/archive/2026-08-22-agent-project-knowledge-engine/。继续阅读：Supervisor Change 机制、Native Loop 和 验证与修复。