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 狀態
使用純粹的 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 墊片、或修改 auth/PATH/config 來修復那個已被移除的指令。Octopool 負責管理共用的 gh 快取；Gitcrawl 則負責管理本機存檔。設定或診斷該交接時，請參閱上游遷移指南。
存檔界限
存檔狀態與相似度是候選證據，而非重複或已解決問題的證明。請回報儲存庫、議題/PR 編號、絕對日期範圍、聚類 ID、新鮮度以及已知缺口。close-thread、close-cluster 以及規範成員的選擇是本機的覆寫，不會影響 GitHub。公開變更使用經授權的 gh 工作流程與簽出證明。
若需要精確的存檔計數，Gitcrawl 沒有 sql 子指令。請從 doctor --json 取得 .db_path，並使用 sqlite3 -readonly；請不要直接修改資料庫列來取代維護者指令。若要進行 Gitcrawl 的實作工作，請確認簽出遠端為 openclaw/gitcrawl，並遵循其自身說明。