git-synclisted
Install: claude install-skill Ldxs001/workbuddy-skills
# git-sync — 全平台发布工具
将 skill/agent 代码规范化推送到**码云(Gitee)**、**GitHub**,并支持 **ClawHub**、**SkillHub**、**PyPI** 发布与 **Release 创建**。
## 约束
- **仅前台运行** — git-sync 包含 LLM 交互步骤(���件筛除、敏感脱敏),WorkBuddy 必须在前台会话中读取输出并写入决策文件。**禁止在后台/Bash 任务中运行**,否则 LLM 交互输出被吞会导致死锁
- **自动检测类型** — 自动识别 skill(`_meta.json`)或 agent(rglob 扫描含 `__version__` 的 `__init__.py`,任意包目录名均可,不硬编码),分别走不同发布流程
- **`all` 模式** — `git-sync all` 遍历 `skills/` 和 `agent/` 全部项目
- **网络依赖** — 推送 Gitee/GitHub/ClawHub/SkillHub/PyPI 需要可用网络连接,超时阈值 60 秒
- **冲突不自动合并** — git merge 冲突需人工介入
- **固定仓库** — 同步目标固定为 `~/.workbuddy/workbuddy-skills/`
- **参数约束** — 项目名不含路径分隔符,version 格式严格 x.y.z
- **仓库规模** — 支持 1-50 个项目,每个 ≤ 500MB
- **数据持久性** — manifest.json 记录同步状态,不备份远程仓库数据
## 触发条件
**正向触发:**
- 「同步/上传/推送/发布某个 skill 或 agent」
- 「全量同步/全部发布」
- 「发布到 ClawHub/SkillHub/PyPI」
- 「创建 Release」
- 「打包/更新 README.md」
- 「检查版本号」
**否定条件:**
- 用户只是说「帮我看看这个文件」——没有同步/打包意图
- 用户要求「用 git 提交代码」——这是通用 git 操作,不是本技能
## 核心能力
> 📚 **渐进式加载**:本技能采用渐进式 MD 体系,`SKILL.md` 为入口(≤230行),详细内容拆分到 `references/*.md` 按需加载。
- **全平台发布** —— Gitee + GitHub + ClawHub + SkillHub + PyPI,一次同步全自动
- **类型自动识别** —— skill(`_meta.json`)/ agent(`__init__.py`),版本号各自读取
- **路径由 manifest 统一管理** —— 每个条目记录 `source_path`(源路径)+ `repo_path`(仓库内路径),skill 和 agent 统一走同一套逻辑
- **`all` 批量模式** —— 遍历全部 skills 和 agents 逐个同步
- **LLM 文件过滤** —— 同步前扫描源文件 → 全量打印文件列表 + 规则 → 要求 WorkBuddy 输出决策 JSON → 只复制允许的文件
- **LLM 脱敏(强制)** —— 同步后强制脱敏敏感信息(邮箱/token/路径/本地路径),无跳过选项。WorkBuddy 根据扫描发现 + 脱敏引导规则逐文件判断保留或脱敏
- **版本号三方对比** —— `_meta.json` / `