GitLoad GitHub 拉取
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sundial-org-awesome-openclaw-skills-gitload。
技能介绍
要解决什么问题
日常从 GitHub 拿内容时,git clone 会把整库历史和 .git 一并拉下;你往往只要某个目录、一个配置文件或一份离线可读的文档树。手工在网页上点「Download ZIP」再解压,路径和分支一换就容易出错,私有仓库还要自己处理 token。
gitload 是针对 GitHub HTTP URL 的 CLI:用 GitHub API 拉取内容,不经过 git 协议,也不保留提交历史。
核心能力与用法
技能文档里的典型路径包括:
- 整库内容:给仓库根 URL,在当前目录生成以仓库名命名的文件夹。
- 指定目录:使用
tree/branch/path形式的链接,只下载该路径下的文件树。 - 单文件:使用
blob/branch/path链接,直接落到本地指定路径。 - 输出控制:
-o指定目录;-z打成 ZIP;也可把内容平铺到当前目录。 - 鉴权:优先
--token,其次环境变量GITHUB_TOKEN,或用--gh复用gh auth login的凭据,用于私有库或缓解限流。
常见模式包括在模板仓里只摘 scaffold/、拉示例代码、整包下载文档目录,或抓取单个 config 文件——都适合「只要文件快照、不要 history」的场景。
边界与注意点
需要 完整 git 历史、要做 git log / 分支切换时,应继续用 git clone。本地已有克隆、或目标不是 GitHub 时,也不适用本技能。大仓库整库下载可能较慢,文档建议改为按文件夹粒度拉取;失败时按 404、限流、权限、网络四类逐项核对 URL 与 token 的 repo scope。
使用场景
- 维护内部脚手架时,只需从公开模板仓的 `templates/next` 目录同步最新文件到本地项目根目录。
- Code Review 前想对照上游示例实现,用 blob 链接只拉取仓库里单个参考文件,避免克隆整个 monorepo。
- 出差或内网环境需要离线阅读,把某文档站的 `docs/` 目录整树下载并打成 ZIP 备份。
- CI 流水线要从私有 GitHub 仓读取单一配置文件,用 token 或 `gh` 凭据拉取后注入构建上下文。
适合人员
- 负责从社区模板仓摘子目录搭建新服务的后端工程师,希望避免为一次拷贝执行完整 `git clone`。
- 在大型 monorepo 中工作的平台工程师,经常只需同步上游某条路径下的配置或示例代码。
- 编写文档站或示例项目的维护者,需要把 GitHub 上的文档树批量拉到本地做离线校对或打包分发。
- 配置私有仓库自动化流水线的 DevOps,需在无 git 历史的前提下用 API 方式拉取单个密钥或配置文件。