用途:将 ~/.claude-config/ 中本地编辑提交并推送到同步仓库远端,是框架示例 sync.sh 定时 git pull --rebase --autostash 的反方向操作——那条负责把上游拉到本地,本技能负责把本地改动推到上游。
主要能力与流程:先 cd ~/.claude-config 确认是 git 工作树并指向私有远端,否则停止。执行 git fetch origin 后报告落后上游的提交、领先上游但未推送的提交、未提交改动(git status --short)及未跟踪文件。按四种状态处理:已同步则报告停止;仅需推送则直接 push;有未提交改动则逐个文件走 diff、起草提交信息并交用户批准后提交再推送;既落后又有改动则先 git pull --rebase --autostash,冲突则停止交由用户处理。提交时对具体文件用 git add <file>,不用 git add -A 或 git add .;提交信息需用户确认,并按 AGENTS.md 在正文末尾带 Generated-by: Claude Code (Opus <版本>) 尾注,不用 Co-Authored-By:。推送后报告提交 SHA 与一行摘要。
运行前检查:会读取采用方仓库中的 .apache-magpie-overrides/setup-shared-config-sync.md 覆盖项(若存在);并比较 gitignore 的 .apache-magpie.local.lock 与已提交的 .apache-magpie.lock,不一致时非阻塞地建议运行 /magpie-setup upgrade,并按 method/URL、ref、svn-zip SHA-512 区分严重程度。
限制:路径固定为 ~/.claude-config/,不可参数化,换路径需 fork;绝不 force-push、不改写已推送提交、不修改该目录以外的文件;若 .sync.lock 被占用则停止不抢锁;不自动发送提交信息,需用户批准。其他机器由定时 sync.sh 自行拉取。
适用场景:多机同步用户级 Claude 配置、提交并推送本地配置改动。具体平台兼容、收费与价格资料暂未提供。