Git 全平台发布同步
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_800d68d6/git-sync。
技能介绍
解决的问题
git-sync 面向 skill/agent 发布流程中的版本与内容一致性问题:本地目录、_meta.json、SKILL.md frontmatter、changelog、仓库 README、ZIP 包和 ClawHub、SkillHub、PyPI 等目标容易脱节,尤其在手动执行多条命令时,版本不一致、敏感信息遗漏和打包遗漏更难及时发现。
核心机制
- 全平台同步:支持将 skill 或 agent 推送到
Gitee与GitHub,并按需发布到ClawHub、SkillHub、PyPI。 - 类型自动识别:通过
_meta.json识别 skill,通过__init__.py中的__version__识别 agent,分别进入对应发布路径。 - LLM 让位式决策:文件筛除和敏感脱敏会写入
resume状态并exit 3,由调用方写入决策文件后重跑同一命令,避免进程内长时间轮询。 - 断点续跑:
resume_{name}.json记录file_filter或sensitive_scan环节,重跑时跳过已完成步骤,只从当前环节继续。 - 路径与仓库统一管理:
_paths.py集中管理路径,config.json的repos注册表决定目标仓库,manifest.json记录同步状态。 - 发布前检查:版本号三方对比、
SKILL.md规范审查、ZIP 打包和 HTML 索引生成,减少发布后才发现的问题。
使用边界
适合处理“同步、上传、发布、打包、创建 Release”这类明确意图;不适合替代通用 git commit / git push。遇到 git merge 冲突不会自动合并,需要人工处理。多平台发布依赖网络连接与有效凭证;ClawHub、SkillHub、PyPI 对版本参数、路径格式和构建方式有不同要求,应按各自说明执行。
使用场景
- 把单个 skill 从本地目录同步到 Gitee 和 GitHub,并更新 README 与版本号。
- 发布 agent 到 PyPI 前,先检查 `__version__`、隔离构建并上传 twine。
- 在同步前筛除不应上传的文件,并在发现敏感信息后写入脱敏决策再续跑。
- 创建 Release,打 `git tag` 并调用 GitHub/Gitee API 生成发行版。
适合人员
- 维护 skill 仓库的工程师,需要把本地 skill 推送到 Gitee/GitHub 并保持版本一致。
- 发布 agent 的开发者,需要按 `__init__.py` 版本隔离构建并上传 PyPI。
- 管理多技能目录的维护者,需要用 `manifest` 与 `repos` 注册表批量同步项目。
- 处理 LLM 工作流的集成者,需要在文件筛除和脱敏环节写入决策文件后重跑。