git-sync — Git 同步

git-sync - 三端同步技能 将 skill 代码规范化推送到码云（Gitee）、GitHub，并生成 ZIP 安装包。

核心功能 自动同步文件 - 将 skill 完整目录结构同步到工作仓库 自动更新 README - 检测并添加新技能到 README.md 技能列表和目录结构 双平台推送 - 同时推送到 Gitee 和 GitHub ZIP 打包 - 生成标准安装包

触发场景 用户说"上传"、"推送"、"同步"、"打包"相关指令时触发。

Skill 标准文件结构 / ├── SKILL.md 必需 - 技能说明文档 ├── _meta.json 必需 - 元数据 ├── scripts/ Python脚本目录 │ ├── __init__.py │ ├── cli.py │ └── .py ├── references/ 可选 - 参考文档 │ └── .md ├── assets/ 可选 - 静态资源 │ └── .json/png ├── data/ 可选 - 数据文件 │ └── .json └── 可选 - 默认配置

必须排除： 排除项 原因 __pycache__/ Python 缓存 .pyc 编译文件 .html 本地预览文件 .log 日志文件

路径说明 本技能使用以下路径约定（可按需调整）： 变量 默认值 说明 SKILLS_DIR ~/.workbuddy/skills 技能目录 WORK_REPO ~/.workbuddy/workbuddy-skills Git工作仓库 ZIP_OUTPUT SKILLS_DIR/ ZIP包输出目录

目录结构： SKILLS_DIR/ ├── / 技能目录 │ ├── SKILL.md │ └── scripts/ └── -v.zip 打包输出 WORK_REPO/ ├── skills/ │ └── / 同步目标 └── README.md

完整执行流程

• 同步文件到工作仓库

将技能从 SKILLS_DIR// 同步到 WORK_REPO/skills// 目录/文件 处理 SKILL.md 必须复制 _meta.json 必须复制 scripts/.py 复制 references/ 复制（递归） assets/ 复制（递归） data/ 复制（递归） __pycache__/ 不复制 .pyc 不复制 .html 不复制

• 自动更新 README.md

信息提取优先级： _meta.json → "description" > SKILL.md → description: > 默认值 更新内容： 技能列表表格末尾添加新技能 目录结构中，将最后一个 └── 改为 ├──，然后追加 └── 新技能/

• 提交并推送到双平台

git add → git commit → git pull --rebase → git push

• 生成 ZIP 包

输出路径: SKILLS_DIR/-v.zip ZIP包结构（以skill-name为根目录）： -v.zip ├── SKILL.md ├── _meta.json ├── scripts/ │ └── .py ├── references/ └── ...（与上传仓库结构一致）

安装方式： 将ZIP解压到 ~/.workbuddy/skills/ 目录即可

使用方法 cd /scripts bash git-sync.sh [version] # 示例 bash git-sync.sh color-toolkit 1.0.0 bash git-sync.sh workday-calendar 2.1.0

参数说明： skill-name: 技能目录名（必填） version: 版本号（默认 1.0.0）

输出产物： Git提交到 WORK_REPO ZIP包到 SKILLS_DIR/-v.zip

常见问题 Q1: GitHub 推送失败（443 超时 / Permission denied） → 检查网络代理，或手动推送： cd WORK_REPO git push origin main

Q2: README 中出现重复条目 → 是之前脚本 bug 造成的。用以下命令修复： # 找到干净提交并强制重置 git log --oneline | head -20 git reset --hard <干净commit> git push --force

Q3: 想保留历史 commit → 脚本已改为普通 commit，不再 amend

Q4: 本地有 html 文件被混入 → 先删除临时文件再执行同步： rm -f SKILLS_DIR//.html

代码管理铁律 先检查仓库现有状态 保持标准目录结构（SKILL.md + _meta.json 在根目录，py 文件在 scripts/） 排除缓存/测试/临时文件 自动更新 README 技能列表 ZIP 与仓库结构一致 强制覆盖远程前先确认本地是正确的