---
slug: "git-sync-x-9"
source_type: "clawhub"
source_url: "https://clawhub.ai/skills/git-sync"
repo: ""
source_file: "description"
---
---
name: git-sync
version: 2.9.2
author: wUwproject
license: MIT
description: 将skill代码规范化推送到码云、GitHub，并生成ZIP安装包。修复跳过同步时状态显示「成功」的误导问题，改为跳过。修复审计问题，统一术语，修正自审粒度。
sensitive_access: false
critical_write: false
permission_weight: LOW
data_dir: ../.standardization/git-sync/
tags: ['sync', 'git', 'zip', 'skill-manager', 'manifest', 'security']
external_data_dir: true
trigger: 同步/上传/推送/发布某个skill
trigger_negative: 只是看文件/通用git提交/文件同步到云端
h1_version: true
---
# 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 索引** —— 生成安装包 + 可视化索引页





### 渐进式文件索引

| 文件名 | 位置 | 说明 |
|--------|------|------|
| `references/antipatterns.md` | git-sync 反模式 | 常见错误和注意事项，避免误用本技能。 |
| `references/changelog.md` | changelog.md — git-sync 更新日志 | - 版本号 2.6.28 → 2.6.29（`update --fix` 自动 bump） |
| `references/faq.md` | git-sync 常见问题 | --- |
| `references/guide.md` | git-sync 完整使用指南 | > 本文档是 SKILL.md 的渐进式补充，包含完整的执行流程、步骤详解和配置说明。 |
| `references/permissions.md` | git-sync — 权限说明（详细版） | > 本文档由 `permission_checker.py` 扫描生成，记录 git-sync 所有权限需求、风险等级及 |
| `references/reference.md` | git-sync 完整参考手册 | > CLI 命令速查、路径变量、排除列表、文件结构规范。 |
## 工作流程


## 数据目录说明

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

```
skills/.standardization/git-sync/
```

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

## 执行流程（AI 操作指南）

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

### 脚本执行

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

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

脚本已自动输出完整报告到终端（推送状态表 + 审计结论 + ZIP/HTML 路径）。

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

#### 1. [文本] 将终端输出的完整报告原文放入回复中

**不要重新格式化、不要摘录、不要加工** — 直接从终端输出原文粘贴。
（终端输出在工具结果中，用户看不到，必须由 AI 显式放入回复文本。）

#### 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 超时、版本冲突等）