git-sync

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

git-sync — 三端同步技能

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

触发场景

当用户提出以下类型请求时，应触发本技能：

• 「同步/上传/推送/发布某个 skill」
• 「打包某个 skill」
• 「更新 README.md 的技能列表」
• 「检查某个 skill 的版本号」

不触发（以下情况不应触发本技能）：

• 用户只是说「帮我看看这个文件」——没有同步/打包意图
• 用户要求「用 git 提交代码」——这是通用 git 操作，不是 skill 同步
• 用户提到「同步」但指的是文件同步（如「同步到云端」）——不是 skill 仓库同步

核心能力

📚 渐进式加载：本技能采用渐进式 MD 体系，SKILL.md 为入口（≤230行），详细内容拆分到 references/*.md 按需加载。

• 三端同步 —— 码云、GitHub、本地 .dist/ 目录
• 版本号三方对比 —— _meta.json / SKILL.md frontmatter / references/changelog.md
• 敏感信息过滤 —— 自动扫描并脱敏 secrets/regex/telemetry
• SKILL.md 规范审查 —— 内联审计（版本一致性 + R-23 脚本引用检查）
• ZIP 打包 + HTML 索引 —— 生成安装包 + 可视化索引页

工作流程

执行流程（AI 操作指南）

🔴 第一步必做：加载 references/guide.md 获取完整执行流程和输出要求。

脚本执行

cd ~/.workbuddy/skills/git-sync/scripts
python scripts/git-sync.py <skill-name> [version] [--skip-scan]

AI 执行后必须输出（非可选）

脚本运行完毕后，AI 必须执行以下 4 点：

1. [文本] 完整推送报告

从终端输出提取以下全部内容，结构化呈现：

📦 git-sync 执行报告：<skill-name> v<version>

| 平台 | 状态 | 版本 |
|------|------|------|
| 码云 | ✅/❌ | x.x.x |
| GitHub | ✅/❌ | x.x.x |

─── 审计报告 ───
  结论：pass/fail（ERROR=N, WARN=N）
  [逐条列出审计结果]

ZIP 包：<完整路径>（<大小> / <文件数> 文件）
HTML 索引：<完整路径>

必须包含：推送状态表 + 审计结论 + ZIP 路径/大小/文件数 + HTML 索引路径。

2. [工具] deliver_attachments — 交付 ZIP 包

3. [工具] preview_url — 打开 .dist/index.html

4. [文本] 如果 GitHub 推送失败（443 超时），必须询问用户是否重试

渐进式加载说明

本技能采用渐进式 MD 体系，SKILL.md 为轻量入口，详细规范拆分到 references/ 按需加载。

→ 详见 references/antipatterns.md → 详见 references/faq.md：

• 🔴 references/guide.md — 必读，完整执行流程 + AI 输出要求
• references/reference.md — CLI 命令速查、Git 调用规范、路径变量
• references/changelog.md — 版本更新记录
• references/architecture.md — 内部架构（脚本映射、目录结构）
• references/antipatterns.md — 反模式（常见错误）
• references/faq.md — 常见问题（443 超时、版本冲突等）

数据目录说明

本技能的数据文件（扫描结果、临时副本、ZIP 包等）存放在：

skills/.standardization/git-sync/

通过 frontmatter 的 data_dir: ../.standardization/git-sync/ 声明。安装目录 skills/git-sync/ 只保留 SKILL.md 和 scripts/。