SuperAPI AI 工具集

sync-horizon

通用与其它

查看项目

更新于 10-15 14:34

技能介绍

用途

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

工作流分为七个阶段:

  1. 深度发现(编排器):读取提交日志、计划情报、代码信号、系统文档变更和当前 CLI 表面。
  2. 能力综合(编排器):交叉引用所有信号,构建能力映射。
  3. 级联分析(编排器):确定每个能力对 eve-read-eve-docs 的影响。
  4. 计划工作项(编排器):为每个更新创建自包含的工作项。
  5. 派发工作者(并行):为每个工作项启动一个后台工作者。
  6. 收集结果并最终确定(编排器):等待所有工作者完成,获取当前 HEAD,运行检查,更新 .sync-state.json。
  7. 报告(编排器):生成同步报告。

适用场景

eve-horizon 仓库有新的 feat 提交或计划状态变更为 Implemented/Complete 时,需要将这些已交付能力同步到 eve-skillpacks 的技能和参考文档中。也适用于清理已移除或弃用的功能,以及更新 .sync-map.json 中的映射关系。

限制

  • 只记录已交付、已实现的行为,不携带路线图内容。忽略标记为 Proposed/Draft 的计划以及“Planned (Not Implemented)”“What's next”等章节。
  • 编排器只读取轻量信号,不读取完整计划、完整差异或源文档。
  • 工作者必须完全自包含,无法访问编排器的对话。
  • 工作者应增量编辑现有文件,而非从头重写。
  • 路由更新工作者应在参考文档工作者完成后启动。
  • 具体收费、价格、平台支持等信息暂未提供。