用途:在项目与主模板仓库之间同步结构性/模板改进。下游场景为模板有更新时拉入项目,上游场景为本地改进后推回主模板。不用于同步 .env、凭据或业务文档,不自动执行 git clone,且默认不自动触发。
主要能力:下游默认走 FAST PATH,一条命令完成同步、OKF 回填、指纹刷新、技能安装到三处位置、校验与日志:python3 harness/scripts/sync-template.py --full。支持 --json、--dry-run、--strategy pull、--branch 等参数。通过 disk、remote_synced、当前 remote 三个哈希点分类:NEW/UPDATE 自动拉取,KEPT 保留本地,CONFLICT 保留本地并把远端版本存到 /tmp/sync-template-conflicts/,退出码 3。退出码 0 表示干净,1 表示下载/OKF/校验错误。
使用方式:常规下游同步运行一次 --full 即可,不要重复调用 okf-check、health-check 或手动改 log。出现 CONFLICT 且想采用远端时再运行 --strategy pull;分支不一致时用 --branch。上游推送、旧 skills/ 结构迁移或调试需走 MANUAL STEPS 0–8,其中 Step 5 会停下等待用户确认。
适用场景:项目与模板仓库之间的模板文件同步、技能文件安装与校验、旧结构迁移。
限制:Antigravity 因沙箱限制无法运行;不自动同步敏感文件;冲突需用户决策;上游推送需人工审批。部分细节如具体版本号、性能数据等以资料为准。