用途
Sync Horizon 用于将 eve-skillpacks 与 eve-horizon 仓库的最新状态保持同步。它解决的核心问题是:系统文档往往滞后于实现,功能通过 feat 提交交付、计划标记为“Implemented”,但 docs/system/ 可能数周不更新。因此该同步直接追溯源头——计划、代码变更和提交信息,以了解实际交付了什么。系统文档只是众多信号之一,而非主要驱动因素。
主要能力
- 深度发现:读取提交日志、计划头部、代码信号、系统文档变更和当前 CLI 表面。
- 能力综合:交叉引用所有信号,为每个已交付计划构建能力条目,并记录由 feat 提交直接交付的小功能以及移除项。
- 级联分析:判断每个能力对参考文档、SKILL.md 路由以及其他技能的影响。
- 并行工作者派发:为每个工作项启动一个后台工作者,各自独立处理一个更新。
- 状态合规检查:运行 state-today 和渐进式访问检查,更新同步状态并生成报告。
使用方式
该技能以编排器加并行工作者的架构运行。编排器读取轻量信号(提交日志、计划头部前 15-20 行、文件统计、CLI 模块列表),工作者读取重内容(完整计划、代码差异、源文档、目标文件)。
前置条件:
- eve-horizon 仓库必须位于 ../eve-horizon(同级目录)
- 仓库根目录必须存在 .sync-state.json(如缺失则从模板创建)
- 仓库根目录必须存在 .sync-map.json
工作流分为七个阶段:
- 深度发现(编排器):读取提交日志、计划情报、代码信号、系统文档变更和当前 CLI 表面。
- 能力综合(编排器):交叉引用所有信号,构建能力映射。
- 级联分析(编排器):确定每个能力对 eve-read-eve-docs 的影响。
- 计划工作项(编排器):为每个更新创建自包含的工作项。
- 派发工作者(并行):为每个工作项启动一个后台工作者。
- 收集结果并最终确定(编排器):等待所有工作者完成,获取当前 HEAD,运行检查,更新 .sync-state.json。
- 报告(编排器):生成同步报告。
适用场景
eve-horizon 仓库有新的 feat 提交或计划状态变更为 Implemented/Complete 时,需要将这些已交付能力同步到 eve-skillpacks 的技能和参考文档中。也适用于清理已移除或弃用的功能,以及更新 .sync-map.json 中的映射关系。
限制
- 只记录已交付、已实现的行为,不携带路线图内容。忽略标记为 Proposed/Draft 的计划以及“Planned (Not Implemented)”“What's next”等章节。
- 编排器只读取轻量信号,不读取完整计划、完整差异或源文档。
- 工作者必须完全自包含,无法访问编排器的对话。
- 工作者应增量编辑现有文件,而非从头重写。
- 路由更新工作者应在参考文档工作者完成后启动。
- 具体收费、价格、平台支持等信息暂未提供。