OpenClaw PR 維護工具

OpenClaw PR 維護工具 是做什麼的？

• 僅執行要求的議題/PR 操作。根目錄 AGENTS.md：修復、產品、源碼信任、核准政策。本技能：GitHub 工作流程。
• 貼上的參考文獻 ≠ 發表許可或範圍擴展。

選擇作用域

• 審查/分類/列舉： 唯讀；說明變更/發現/證明/不確定性。編輯、指派、標籤、留言、關閉需要授權。
• 僅修復： 調查/修復/在本機驗證；發表需要「發佈/合併」或同等作用域。
• 合併/發佈/自主修復： 源碼證明 → 審查 → 原生提交 → 驗證合併。追蹤待處理請求；在相同授權下修復 CI/衝突。接受的合併自動化 ≠ 完成。保留歸屬權/無關工作；根限制仍存在，無重複例行權限。
• 排隊/探索： 閱讀分類。批次即時讀取/共享探索；指定 PR ≠ 佇列掃描。
• 作者/回歸歸因： 作者與來源研究；帳號年齡/歷史條件。
• 主導親自動手；有限有用的工作者，序列化 checkout/refs + GitHub 寫入。無使用者擁有的應用程式任務隱藏內部子任務。在接手/重新指派前保留停滯的工作者補丁/索賠/證明。

檢查實際項目

• 執行 git status -sb；保留無關工作。本地 gitcrawl → 裸 PATH gh，縮小即時 JSON。過時/遺失的存檔 → gh，無廣泛同步。PR 來源：gh pr view/diff + checkout，非網頁搜尋。

gh pr view <pr> --repo openclaw/openclaw \
  --json number,title,state,body,author,assignees,baseRefName,headRefName,headRefOid,files,comments,reviews
gh issue view <issue> --repo openclaw/openclaw \
  --json number,title,state,body,author,assignees,comments

• 指派：參閱分類，在深入工作前。提及其他指派者；保留所有權。帳號/活動研究視情況而定。

建立結果

• 讀取擁有者、進入點、呼叫者、同層、測試、文件、歷史、當前主分支；檢查決定依賴契約。Codex：根目錄的個人源碼檢查。對立證據 → 先調查再辯護。無發明的矩陣/替代方案。
• 已修復： 證明當前主分支已修復；正規提交/PR + 相符的源碼/可執行證明。關閉權限 → 留言證據 + 關閉；否則回報。
• 真實缺陷： 重現 → 修復擁有者不變量 → 證明路徑/同層。簡化優於症狀防護；大小/行數 ≠ 正確性門檻。
• 有用的 PR： 改善可編輯分支；不安全 → 在關閉前進行授權的歸屬替代。取代的祖先 → 維護者擁有的替代，絕不壓縮貢獻者 PR。
• 不確定/產品決策： 陳述差距；無推測性合併/自動超出範圍關閉。
• 證明 + 源碼信任/主機路徑：$openclaw-testing，發佈。聚焦證明 → 準備就緒的 PR；PR CI = 廣泛證明。在合格、可用的主機上進行有界限的本地證明為佳。審慎的遠端證明可涵蓋昂貴的檢查或環境差距；佇列 → 停止任務擁有的分配，使用 PR CI 或安全的本地作用域，保留未涵蓋的需求。絕不在本地執行不受信任的源碼。可選的即時差距 → 有意義的邊界證明 + 限制；明確的即時、外部 API、已驗證風險的證明為強制。模擬/跳過/舊頭 ≠ 即時。
• 行為變更：邊界證明契約 + $test-audit。請求的行為與倉庫標準：分開檢查。

CODEOWNERS 審查

• CODEOWNERS 路由審查；檢查即時強制執行。受限/安全路徑 + 重大產品/行為/安全/擁有權變更需要列出擁有者參與。
• 擁有權/審查治理：已驗證的活躍組織管理員指示亦符合資格；僅倉庫管理員/繞過則不符合。兩種路徑都不能豁免強制審查。

審查與發佈

• 在提交或合併非瑣碎程式碼之前：透過允許的工作流程進行新審查；除非使用者選擇退出，否則解決可行的發現。可行 = 可能或高影響；拒絕不可能、可回復的邊緣案例，其修復增加了不成比例的複雜性，並附上一行理由。

• 非瑣碎程式碼提交/合併：$autoreview；解決已驗證的可行動發現。僅審查：僅在請求時進行獨立通行，無額外強制 CLI 通行。

• 對實質變更/未解決的疑慮重新開啟審查，而非補丁相同的 rebase/機械性頭部變更。處理真實的人類/機器人發現；解釋拒絕理由。機器人評分/Rank-up 清單不會產生單獨義務。ClawSweeper 建議；絕不等待留言來合併。

• 當前 PR 範本：簡潔的問題/影響；清單在 diff/詳細資料中。保持風險、遷移、動作、證明、差距、歸屬權為最新；解釋實質權衡。無發明的內部使用者利益或通用的 LOC/來源/替代修復文章。

• CHANGELOG.md 為發佈擁有；在 PR/提交中附上發佈說明上下文。僅在明確要求時提供代理人轉錄。

• 公開變異：驗證作者/提交者 + 寫入者；外殼敏感性主體檔案。僅限授權範圍；更新現有留言/主體，無重複。

• 發佈/合併：閱讀發佈（媒體、精確頭部 CI、原生工作流程）。

• 驗證遠端合併/關閉 + 源碼。以散文形式回報問題、擁有者變更、證明/差距、歸屬權、連結的最終狀態；僅限有價值的後續行動。

最終化與清理

• 絕不移除持有工作階段目錄的工作樹，包括你的或子目錄。子 cd/cwd 覆蓋不會移動父目錄。保留到擁有者退出/釋放 cwd；回報路徑。
• 驗證結果後 → 透過原生結案移除任務日誌、收據、證明存檔、.crabbox、暫存區、已完成的工作樹。不為移除而進行保留/存檔/匯出/移交。
• 一旦工作/PR 完成或合併，移除已建立的工作樹，除非立即需要下一個；絕不移除活動目錄的工作樹。
• 每個任務：在聊天/stdout 中呈現發現；僅為交付物/工具/證明/復原需要建立的檔案，說明目的/重複使用。合併前證明為強制；可選的後續行動絕不阻礙完成。
• 保留要求的交付物/保留、未完成的源碼 + 必要的復原狀態、活躍/進行中/未知的擁有者、憑證、代理人狀態、共享相依性。