用途:将本机 ~/.claude-config/ 目录里的配置修改提交并推送到同步仓库远端,供其他机器拉取。它与框架示例 sync.sh 中定时执行的 git pull --rebase --autostash 互为反向操作:后者把远端拉进本地,本技能把本地改动推上远端。\n\n主要能力:运行前读取采用者仓库中的 .apache-magpie-local/setup-shared-config-sync.md(个人、gitignore)与 .apache-magpie-overrides/setup-shared-config-sync.md(已提交、项目级)覆盖文件;比较 .apache-magpie.local.lock 与 .apache-magpie.lock 检测快照漂移并提出升级建议(非阻塞)。同步流程为:确认目录是 git 工作树、git fetch 报告落后/领先/未提交改动,再按状态执行仅推送、先提交再推送、或先 rebase 拉取再提交推送。推送后报告提交 SHA 与摘要。\n\n使用方式:同步仓库固定位于 ~/.claude-config/,路径不参数化。引导缺失目录时按用户显式 URL、或 git@github.com:<handle>/claude-config.git(handle 来自 gh api user --jq .login)解析远端;均无法解析则询问用户。创建远端需用户确认,始终使用 --private。\n\n限制与规则:禁止 force-push、--no-verify,禁止改写已推送提交;除 bootstrap 时经确认的符号链接外不修改 ~/.claude-config/ 之外的文件;不覆盖非 git 仓库的 ~/.claude-config/;.sync.lock 被占用时停止;提交信息先起草并由用户确认,正文须带 Generated-by 尾部;冲突由用户自行解决。
shared-config-sync
办公与效率
更新于 10-16 05:00