Agent Skills
返回列表
GitHub 仓库检索提取

GitHub 仓库检索提取

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_e8f27348/github-repo-extract。

技能介绍

要解决什么问题

工程师在接 GitHub 链接、或明确说「参考 / 借鉴 / 评估某仓库」时,往往缺一套可复用的流程:该拉哪些字段、树太大怎么减量、README 和 contents 接口回来的是 base64 却常被原样落盘、License 误判后直接抄码。本技能是一份通用 SOP(v1.1),不绑定单一技术栈,强调先把当前工程的文档与目录约定对齐,再把分析结果写回可检索的文档,而不是散落在对话里。

技能如何工作

上下文识别:对照 project.godot、package.json、requirements.txt、Cargo.toml 等判断工程类型;确认是否已有双文档 + DOCS_INDEX,以及 third_party/、reference_repos/、docs/ 等落盘约定。没有索引时建议先建架构总览,否则后续对比表和方法论无法沉淀。

查询与落盘:优先已鉴权的 gh(规避匿名 API 60 次/小时限流),用 gh repo view、gh api .../git/trees/HEAD?recursive=1、readme 与 contents/{path} 拉元数据与关键文件;gh 不可用时再直连 api.github.com,必要时用 Python urllib 绕过 hosts。content 字段必须 base64 解码后再写入本地,禁止把编码串当源码保存;大树按需取路径,不盲目全量递归。

价值与合规:用五维矩阵(可直接使用、知识转译、设计提炼、架构分层、视觉/规范)打 ★ 级;下载矩阵按 MIT/Apache/CC0、GPL-3.0/AGPL、无 License、私有标注、>100MB、纯索引文档等分支决定下什么、放哪、是否只读参考。licenseInfo 为 null 时要额外查根目录 LICENSE/COPYING/LICENSE.md,避免误判。

文档回写:按工程文档体系同步 AI 侧与人读版;每个有价值仓库记录价值等级、License 警告、命名规则(如 VS_ 前缀),必要时追加「参考方案 vs 当前工程」对比表,并完成编码与问号校验清单。

适用边界与注意点

  • GPL/AGPL:默认只学方法论与 README,不下载源码、不做整段转译进可发布构建。
  • 版权硬规矩:CC-BY-NC 等禁止商用素材不纳入工程;保留所有权利的外部代码仅只读参考。
  • 大仓与纯文档仓:>100MB 选择性下关键文件;纯资源索引类以在线 URL 记录为主。
  • 天倾项目若需项目配置文件,应使用专用技能 github-repo-extract-tianqing,本通用版不携带该配置。

使用场景

  • 选型前收到五六个同类 GitHub 仓库链接,需要统一拉 stars、License 与目录结构并打 ★ 级备忘
  • 要把某仓库 shader 或配置片段放进 `third_party/`,须先核对 License 与命名规则再 selective 下载关键路径
  • 跨框架借鉴(如 C# 玩法循环转 GDScript)时,只下 README 与核心模块并写方法对比表
  • `licenseInfo` 返回 null 的仓库,需查根目录 LICENSE 文件后再决定能否抄码或仅文档记录

适合人员

  • 维护 Godot/多技术栈 side project、习惯用 `reference_repos/` 沉淀外仓笔记的独立开发者
  • 带团队做技术预研、必须给 GPL 与无 License 仓库留书面警告的技术负责人
  • 写双文档体系(人读 + AI 侧)并希望每次外仓分析都更新 `DOCS_INDEX` 的文档维护者
  • 在 GitHub 被 hosts 拦截环境里仍要用 Python 兜底拉 `api.github.com` 的内网工程师