Agent Skills
返回列表
Git 全平台发布同步

Git 全平台发布同步

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 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 工作流的集成者,需要在文件筛除和脱敏环节写入决策文件后重跑。