用途:sync-vision 是增量同步通道,工作对象是根 VISION.md,即项目的“规则层”。它分析自上次同步提交以来发生变化的持久输入(如计划、文档、技能、研究、评审、交接),从中学习可复用的项目口味与判断,并忽略噪音。它不替代 vision 路由。
主要能力:依据变更范围收集输入、对候选行或主题分类,并按规则决定是否将高置信度的可复用决策写入根 VISION.md。分类包括 captured、reaffirmed、rejected、run-specific、owner-routed、deferred-with-question。只有可复用的全局口味、来源顺序、跨边界规则、公共 API 规则、证明标准、评审关注点、特定拥有者规则或监督停止条件才提升到根文档;临时命令输出、一次性路由状态、旧分支摘要、原始 issue、生成镜像噪音、产物路径等不应提升。
使用方式:依赖 autogoal,通常先加载 autogoal,创建或继续同步计划。状态存于 docs/sync/vision/status.json,运行产物在 docs/sync/vision/runs/<date>-<base>-to-<target>/。命令包括 status(只读)、preview(写产物但不改 VISION.md、不推进基线)、sync(默认,写产物、补丁根文档、路由非 vision 拥有者、在全部已提交输入都被分类时推进基线)、advance(仅在活动计划证明范围已完全计入后更新 status.json 到当前 HEAD)。辅助脚本用法: node .agents/skills/sync-vision/scripts/collect-vision-diff.mjs --status node .agents/skills/sync-vision/scripts/collect-vision-diff.mjs --dry-run node .agents/skills/sync-vision/scripts/collect-vision-diff.mjs node .agents/skills/sync-vision/scripts/collect-vision-diff.mjs --advance --plan docs/plans/<plan>.md
适用场景:需要在项目演进中把重复出现的人工答案、智能体遗漏、计划与文档中的可复用规则提炼到根 VISION.md,并保持单一项目愿景来源;需要区分哪些内容应留给技能、规则、研究文档、行为规范、迁移指南或基准脚本等拥有者。
限制:资料未提供收费、价格、平台、具体效果等信息。配置可放在 docs/sync/vision/config.json,支持 includePathspecs、exactInputFiles、inputPathPrefixes、excludePathPrefixes、trackedExts、patterns 等字段,应保持项目本地,不放私有 URL、账号 ID 或临时分支状态。生成镜像 .agents/skills/** 在有源规则或顶层 skills/** 时不是主要输入。工作树未提交覆盖物可见于产物但不计入基线;不得仅因写了产物就推进 lastSyncedCommit。当候选涉及产品/API 口味且无法推断默认值、源规则变更但生成镜像同步失败、辅助脚本报 git/ref 错误、或只有未提交覆盖输入时,不应推进基线。