git-sync - 三端同步技能

将 skill 代码规范化推送到码云（Gitee）、GitHub，并生成 ZIP 安装包。

核心功能

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

触发场景

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

Skill 标准文件结构

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

必须排除：

路径说明

本技能使用以下路径约定（可按需调整）：

目录结构：

SKILLS_DIR/
├── \x3Cskill-name>/           ← 技能源目录
│   ├── SKILL.md
│   └── scripts/
└── \x3Cskill-name>-v\x3Cx.x.x>.zip  ← 打包输出

WORK_REPO/
├── skills/
│   └── \x3Cskill-name>/      ← 同步目标
└── README.md

完整执行流程

1. 同步文件到工作仓库

将技能从 SKILLS_DIR/\x3Cskill-name>/ 同步到 WORK_REPO/skills/\x3Cskill-name>/

2. 自动更新 README.md

信息提取优先级：

_meta.json → "description" > SKILL.md → description: > 默认值

更新内容：

• 技能列表表格末尾添加新技能
• 目录结构中，将最后一个 └── 改为 ├──，然后追加 └── 新技能/

3. 提交并推送到双平台

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

4. 生成 ZIP 包

输出路径: SKILLS_DIR/\x3Cskill-name>-v\x3Cx.x.x>.zip

ZIP包结构（以skill-name为根目录）：
\x3Cskill-name>-v\x3Cx.x.x>.zip
├── SKILL.md
├── _meta.json
├── scripts/
│   └── *.py
├── references/
└── ...（与上传仓库结构一致）

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

使用方法

cd \x3Cgit-sync>/scripts
bash git-sync.sh \x3Cskill-name> [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/\x3Cskill-name>-v\x3Cversion>.zip

常见问题

Q1: GitHub 推送失败（443 超时 / Permission denied）

→ 检查网络代理，或手动推送：

cd WORK_REPO
git push origin main

Q2: README 中出现重复条目

→ 是之前脚本 bug 造成的。用以下命令修复：

# 找到干净提交并强制重置
git log --oneline | head -20
git reset --hard \x3C干净commit>
git push \x3Cremote> --force

Q3: 想保留历史 commit

→ 脚本已改为普通 commit，不再 amend

Q4: 本地有 html 文件被混入

→ 先删除临时文件再执行同步：

rm -f SKILLS_DIR/\x3Cskill-name>/*.html

代码管理铁律

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