mcpField
G
gitcrawl

gitcrawl

github.com/openclaw开发393.3k387 次安装今天更新
代码仓库

关于 gitcrawl

面向维护者的 GitHub 本地归档发现技能，借助命令行查找 Issue、PR、邻近线程和聚类。它强调归档结果只是线索，做出维护决策前需核对实时 GitHub 状态。

主要功能

  1. 01搜索本地 GitHub 归档
  2. 02查找邻近线程与聚类
  3. 03检查归档新鲜度和数据库路径
  4. 04按需同步指定线程及 PR 详情
  5. 05区分候选证据与实时状态

适用场景

  1. 01发现相关 Issue 或 PR
  2. 02检查线程聚类和历史背景
  3. 03核对本地归档是否过时

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/openclaw/openclaw --skill gitcrawl

安装后在 Claude Code 中输入/gitcrawl确认已加载。

附带文件agents/openai.yaml

详细介绍

Gitcrawl

使用本地 GitHub 存档进行发现；在维护者作出决定或执行公开变更前，先验证 GitHub 当前状态。使用 gitcrawl doctor --json 检查数据的新鲜度和已配置的数据库路径。

gitcrawl threads owner/repo --numbers <number> --include-closed --json
gitcrawl neighbors owner/repo --number <number> --limit 12 --json
gitcrawl search issues "query" -R owner/repo --state open --json number,title,url
gitcrawl clusters owner/repo --sort size --min-size 5
gitcrawl cluster-detail owner/repo --id <cluster-id>

对于过时的结果，可使用有时限的 --sync-if-stale 5m 搜索，或针对性地运行 gitcrawl sync owner/repo --numbers 123,456 --with pr-details。后者会将本地 PR 文件、提交、检查、工作流运行记录和评审讨论串解决状态同步到本地；它不会填充单独的 GitHub CLI 缓存。

GitHub 当前状态

使用裸 PATH gh 和范围精简的原生 JSON 字段：

gh pr view <number> -R owner/repo --json number,title,state,url,isDraft,headRefName,headRefOid
gh pr checks <number> -R owner/repo --json name,state,bucket,link
gh issue view <number> -R owner/repo --json number,title,state,closedAt,url

gitcrawl gh 已移除。它以状态码 2 退出表示迁移提示，而非身份验证失败。不要将它的 --live/--cached 标志或旧字段名称传给 gh，不要恢复旧版 Gitcrawl，不要绕过现有的 Octopool shim，也不要通过更改身份验证、PATH 或配置来修复这个已移除的命令。Octopool 管理共享的 gh 缓存；Gitcrawl 管理本地存档。设置或诊断这种交接时，请参阅上游迁移指南。

存档边界

存档状态和相似度只是候选证据，不能证明问题重复或已解决。请报告仓库、问题/PR 编号、绝对日期范围、集群 ID、数据新鲜度和已知缺口。close-thread、close-cluster 和规范成员选择都是本地覆盖设置；它们不会修改 GitHub。公开变更需使用经授权的 gh 工作流，并提供检出证明。

如需精确的存档计数，Gitcrawl 没有 sql 子命令。请通过 doctor --json 确定 .db_path，并使用 sqlite3 -readonly；不要修改数据库行来代替维护者命令。若要处理 Gitcrawl 实现，请验证检出目录的远程仓库为 openclaw/gitcrawl，并遵循其自身的说明。

评论

支持 Markdown