2.0 KiB
2.0 KiB
Agent Note: 无需生成索引即可发现 Agent Note
Status: implemented
English | 中文
问题
提交到仓库的 Agent Note 索引，会重复记录每个文件的生命周期／类别路径、文件名日期和 H1 已经编码的事实。任何分支只要添加、移动或重命名彼此无关的 Agent Note，都会重写同一个生成文件，因此该产物会成为可预见的合并冲突热点。
与浏览生命周期／类别目录树或搜索仓库相比，这份集中式时间顺序清单提供的发现价值有限；但其生成器、渲染器、命令和新鲜度检查仍然构成维护负担。
决策
生命周期／类别文件系统目录树就是 Agent Note 清单。README.md 继续作为人工维护的入口和契约，普通的目录树浏览与仓库搜索负责内容发现。
scripts/agent-note-tree.ts 持有封闭的生命周期／类别集合与结构遍历器。verify-agent-note-classification 校验该目录树，并拒绝旧目录和根目录中的 INDEX.md，但不会渲染集中式清单或检查其新鲜度。
备选方案
保留提交到仓库的生成索引，并通过重新生成解决冲突。 重新生成能让冲突解决过程机械化，但无法阻止无关分支修改同一产物，也不会减少由此产生的评审噪音。
提供不提交到仓库的按需索引命令。 这可以避免已提交文件的冲突，但仍需维护渲染器和命令，而目录树浏览与仓库搜索已经覆盖该发现路径。
恢复人工维护的索引。 它具有相同的共享文件争用问题，还会重新引入生成机制已经避免的完整性和排序错误。
影响
- 添加、移动或重命名 Agent Note 时，不再改动覆盖整个语料库的生成文件。
- 分类门禁执行的工作更少，文档门禁拓扑也不会增加进程或阶段。
- 读者不再获得单一的时间顺序页面，改用生命周期／类别目录树或仓库搜索。