SuperAPI AI 工具集

vault-presync

通用与其它

查看项目

更新于 10-15 23:44

技能介绍

用途:在 ~/wiki 仓库执行 git push 前、git pull 因未跟踪文件冲突失败时、或本地与远端历史分叉时,完成同步前处理。

主要能力:拉取远端状态并报告 AHEAD/BEHIND/DIRTY;运行 skillwiki sync lint-delta --base-ref origin/main 做 lint 门禁,仅当 new_errors > 0 时阻断(可用 --force 跳过),继承的旧错误只警告;找出并删除与 origin/main 逐字节相同的未跟踪本地副本,保留有本地修改的文件;检测 rebase 冲突并预警;通过 wiki-pull-with-auto-resolve.sh 执行规范拉取,使用操作日志、冻结远端 tip 的精确 OID、自有 stash 保护与一次重试;报告剩余未跟踪文件。

使用方式:安装后可用 ~/bin/wiki-sync.sh(dry-run)、~/bin/wiki-sync.sh --execute(去重+rebase)、~/bin/wiki-sync.sh --force(跳过 lint)。开发时可直接运行 bash packages/vault-sync/skills/vault-presync/wiki-sync.sh。在 Claude Code 中可用 /vault-presync --execute。脚本自动探测 vault 根目录。

限制:拉取助手从不推送,不使用 force-push;lint 证据缺失或 JSON 格式错误时 fail closed;冲突需人工处理,第二次冲突或人工改动会转为 review-required;未提供收费、平台与效果信息。