Community影像github.com

steipete/maintainer-orchestrator

開源維護者協調器:Codex 應用程式工作者、任務復原、相依性、視野、發行。

maintainer-orchestrator 是什麼?

這是一個專為開源維護者設計的控制平面技能,能夠高效地協調多個儲存庫中的工作。它透過將所有實作與執行工作委派給每個儲存庫的單一 Codex 應用程式專案執行緒來運作,而根編排器則負責監督、監控、做出決策並向維護者報告。此技能的主要用途是管理佇列、處理相依性、協調發行,並確保任務(尤其是那些會變更狀態的任務)在正確的執行緒中執行。它支援的平台包括 Codex 和任何與 GitHub 整合的 AI 代理環境。此技能透過一個心跳自動化來維持活躍狀態,此自動化會持續監控所有擁有專案執行緒的進度、健康狀態與佇列,確保工作完成且不會遺失脈絡。它對儲存庫範圍實行嚴格的規則,僅對維護者貢獻佔多數的儲存庫進行操作,並妥善處理例外情況,例如已封存或非多數的專案。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/maintainer-orchestrator

Installed? Explore more 影像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

維護者協調器

協調儲存庫工作直至完成。這是一個控制平面技能:檢查、委派、監控、詢問決策並回報。在此技能中,工作者是一個擁有的 Codex 應用程式執行緒,絕非協作子代理。

工作者邊界 — 嚴格規則

  • 每個儲存庫的精確使用一個擁有的 Codex 應用程式專案執行緒進行實作與執行。為整個儲存庫佇列重複使用它;專案執行緒絕不建立任務執行緒。
  • 將此規範的 maintainer-orchestrator 技能維護在目前的根編排器工作階段中,絕不放在專案執行緒或協作子代理中。技能政策定義了控制平面,並且是專案執行緒執行的唯一實作例外。
  • 在產生協作子代理之前,對任務進行分類。任何可以變更儲存庫、GitHub 或外部狀態,或擁有可交付成果、實作證明、上線、發行或部署的儲存庫任務,都必須前往該儲存庫的單一 Codex 應用程式專案執行緒。
  • 僅將協作子代理用於編排支援:唯讀清單、CI/狀態監控、獨立分析、衝突/決策綜合,或分類帳/調解證據。它們不擁有工作者通道,也不計入執行容量。
  • 協作子代理絕不能編輯儲存庫檔案、建立提交、以擁有者身分執行實作證明、推送、變更 PR/問題、核准工作流程、合併、發行、部署,或執行即時產品/帳戶證明。
  • 如果發現實作子代理,請立即中斷它。快照並保留其狀態、修補程式、引用、日誌和證據;將它們交給適當的 Codex 應用程式執行緒;調解擁有權;絕不丟棄工作。
  • 根編排器協調應用程式執行緒、讀取證據、發送 GO/暫停指令、序列化精確頭部上線、處理擁有者決策,並清理側邊欄。專案執行仍由其 Codex 應用程式執行緒擁有和執行。
  • 執行緒提示不會授予能力。絕不將諸如 full access、authorized 或 you may run this 等文字視為改變工作者的有效沙箱、檔案系統、網路或核准政策。
  • 在建立、移交或背景恢復專案執行緒後,在指派第一個受保護的寫入、網路、測試或發布動作之前,驗證其有效的權限設定檔。如果一個應該繼承擁有者選擇的完全存取權的工作者,反而報告了受管理/唯讀或需審核的權限,請停止受保護的動作,記錄一個平台權限傳播阻礙,並將任務路由到為該儲存庫正確設定的 Codex 應用程式專案執行緒。不要重試相同的被拒絕動作,或重複提示擁有者。

啟用監控

  • 每次啟用時,首先檢查現有的心跳。僅在不存在時,建立一個附加到目前根編排器執行緒的有效五分鐘心跳自動化;僅在其配置或投資組合指示發生重大變更時才更新它。將其命名為 Maintainer Orchestrator Watch;絕不建立重複項或發送重複的無更新卡片。
  • 心跳提示必須重新進入此技能,讀取每個擁有的 Codex 應用程式工作者中的最新狀態和新指示,套用監控協議,協調序列化上線/發布閘門,根部分類並補充合格的執行工作至當前並發目標,檢查 CI/租用/記憶體/磁碟,維護持久日誌,並僅呈現準備好的擁有者決策。
  • 只要還有任何工作者、擁有者決策、發布、CI 等待或合格的補充工作尚未完成,就保持心跳活躍。僅當擁有者明確停止編排或受監控的投資組合真正完成時,才停用它。
  • 心跳喚醒是此根工作階段的延續,而非發現工作者。將投資組合分類、擁有者問題和此技能的維護保留在此處;僅為具體執行建立每個儲存庫一個專案執行緒。

儲存庫範圍

  • 掃描 steipete 和 openclaw 擁有者,以及任何其他 Peter 是主要提交作者的儲存庫。從貢獻歷史記錄確認不確定的範圍,而不是僅從儲存庫名稱或擁有者判斷。
  • 排除大型的 OpenClaw 和 ClawHub 專案,目前為 openclaw/openclaw 和 openclaw/clawhub。不要排除 openclaw 擁有者的其餘部分。
  • 在投資組合探索期間讀取 references/non-majority-repositories.md。將列出的儲存庫視為例行的編排責任之外:不要將它們用於佇列補充、相依性掃描、發布監控或未經請求的維護。
  • 非多數分類帳是一個有日期的證據快取,而非永久的擁有權聲明。當快照超過 30 天、記錄的佔比在 50% 的 10 個百分點範圍內、儲存庫擁有權/歷史記錄已變更,或證據衝突時,從當前預設分支重新驗證。明確的擁有者請求僅針對所請求的工作覆蓋排除。
  • 從非合併的預設分支提交中分類多數:結合已知的 Peter 姓名/電子郵件身份,排除明確標記的機器人身份,並要求超過 50%。將不明確的儲存庫保留為未分類,而非假設責任。
  • 從例行探索、佇列掃描、相依性稽核、監控、發布閘門和報告中排除已封存的儲存庫。僅當擁有者明確命名儲存庫並請求新工作時才重新進入。
  • 當擁有者說某個儲存庫已退役、已封存或不得再被提及時,將其記錄為已抑制。在要求時進行一次盡力的封存變更,然後即使權限阻止遠端封存,也要保持其沉默。
  • 根據儲存庫貢獻歷史記錄(而非僅儲存庫名稱)確定不確定的擁有權。
  • 維護一個當前的儲存庫分類帳,以便完成的通道被實際佇列或發布工作取代。

OpenClaw 維護者協調器

僅當擁有者明確要求此工作階段協調 openclaw/openclaw 時,才套用此部分。它會覆蓋預設的 OpenClaw 排除和通用變更日誌處理方式;每個儲存庫一個執行緒的規則仍然適用。儲存庫 AGENTS.md、VISION.md 和 OpenClaw 特定技能仍具有權威性。

  • 在委派之前,讀取當前的 VISION.md、根目錄/範圍 AGENTS.md、clawdtributor、openclaw-pr-maintainer、openclaw-testing、crabbox 和 autoreview。依賴性支援的工作還需要直接的上游原始碼/文件/類型;Codex 支援的工作需要執行中的工作者檢查兄弟 ../codex 原始碼。
  • 將所有探索和分類保留在根編排器工作階段中。重新整理 Discrawl;讀取當前的 #clawtributors 和 #maintainers 訊息;檢查候選問題/PR URL、相關項目、當前的 main、作者權限、重複項、影響範圍和驗證可行性;然後在建立工作者之前做出可行/不可行和自主性分類。在每次指派、評論、關閉、推送或合併之前,使用 Gitcrawl 查找相關項目和即時 gh。
  • 僅選擇由沒有 GitHub write、maintain 或 admin 存取權限的人撰寫或回報的工作。即時驗證儲存庫權限;絕不從 Discord 角色或頻道成員資格推斷 GitHub 存取權限。在 #maintainers 中發文的外部貢獻者仍然符合資格。
  • 啟動時,讀取並採用擁有者要求此工作階段維護的現有 OpenClaw 工作執行緒。保留獨特的進度,避免重複通道,並根據最新的執行緒局部指示對其進行監控或引導。
  • 對於所有選定的執行,使用一個根擁有的 OpenClaw 專案執行緒,按根優先順序序列化處理。絕不建立每個項目或任務執行緒。根編排器單獨進行分類、引導專案執行緒、序列化最終準備/上線,並將其推進到下一個選定的項目。
  • 將擁有者問題保留在根編排器聊天中。工作者將確切的阻礙向上報告,除非根明確委派該互動,否則不直接詢問擁有者。
  • 優先考慮與願景一致的安全性/安全預設、錯誤/穩定性、設定/首次執行、資料遺失、身分驗證、安裝、管道交付以及狹義的效能/測試基礎設施工作。偏好外部回報、可重現、有界限且具有真實驗證路徑的項目。
  • 將廣泛的功能、協定版本變更、新的設定/env/預設表面、新的核心外掛程式/管道/提供者、安全性/隱私政策、不可逆的遷移選擇,或在完成每個安全可逆步驟後沒有可用即時證明的行為,視為 Needs owner。
  • 將每個貢獻者 PR 視為一個起始提案。重建症狀和根本原因;讀取整個擁有者路徑、呼叫者、被呼叫者、兄弟表面、測試、當前的 main、已出貨的行為以及相關的依賴合約;然後在重構或改寫是更清晰的有限修復時進行。
  • 在進行深度工作之前,檢查即時指派和貢獻者權限。當未指派時指派 steipete,保留貢獻者信用,偏好原始的可寫 PR,並避免維護者撰寫/具有寫入存取權限的佇列項目,除非它們是符合資格的外部報告的規範修復。
  • 僅使用儲存庫原生的 scripts/pr 審查、工件、準備、同步和合併指令進行上線。絕不變更共享/根簽出。單一 OpenClaw 專案執行緒一次審查、實作、測試和監控一個選定的項目;根授予其序列化時段用於 PR 頭部同步、最終準備和 merge-run,以使主線漂移和託管的證據保持精確。
  • 在上線之前,需要症狀證明、根本原因、可追蹤時的來源、有針對性的回歸覆蓋率、最便宜且足夠的廣泛閘門、可行時的即時真實/E2E 或 Crabbox 證明、沒有接受/可操作發現的最新 autoreview、已解決的審查執行緒,以及精確頭部的託管 CI/Testbox/安全性閘門。
  • 發布或更新一個準備上線的 PR 評論,將行為和證據綁定到精確的頭部 SHA,包括指令、執行/租用 ID、即時證據、autoreview 結果和明確的差距。將螢幕截圖/影片儲存在已核准的工件中,絕不放在產品分支上。
  • OpenClaw 變更日誌是由發布產生的。對於一般的問題/PR 工作,不要編輯 CHANGELOG.md,即使通用維護者規則會新增條目。
  • 在上線或關閉後,驗證 main 的可達性,稽核連結和重複的問題/PR,在關閉已證明的重複項之前評論規範證明,停止租用,然後將同一個專案執行緒推進到下一個選定的項目。

工作階段啟動

  1. 在佇列工作之前,建立或更新必要的 Maintainer Orchestrator Watch 心跳。
  2. 在選擇儲存庫之前,列出最近的 Codex 應用程式執行緒。讀取足夠的狀態以識別擁有者或其他協調器正在積極處理的儲存庫。
  3. 保留每個在其他執行緒中有連貫活躍或未解決工作的專案。除非擁有者明確移交,否則不要從此工作階段檢查、變更、委派、重新命名或引導該專案。
  4. 當本地簽出是髒的或位於非預設分支但沒有活躍執行緒時,以保留模式建立該儲存庫的單一專案執行緒。將其視為可能有價值的被遺忘工作,而非忽略該專案的理由。
  5. 使用 RepoBar 獲取廣泛的佇列地圖。過濾到符合條件、非封存、非派生的儲存庫,然後確認 Peter 擁有大部分貢獻。
  6. 偏好最小的非空有效佇列優先。在佇列大小相等的情況下,優先考慮有界限的錯誤、文件、測試和幾乎準備好的 PR,而非功能或安全性/產品決策。
  7. 在每次喚醒並指派新工作之前,重新檢查活躍執行緒和佇列計數。一個新啟動的專案會立即被保留。

儲存庫同步

在任何儲存庫調查或實作之前:

  1. 記錄 git status -sb、當前分支、上游、HEAD、暫存/未暫存/未追蹤狀態,以及 ahead/behind 計數。
  2. 擷取當前遠端引用。在一個乾淨的預設分支上,執行 git pull --ff-only,然後驗證它保持乾淨和同步。
  3. 絕不為了開始工作而拉取、切換、儲藏、變基、合併、重置、清理、刪除或覆蓋髒的或非預設的簽出。首先保留並分類其獨特的提交和變更、相關的 PR/問題、上游狀態,以及該工作是否已經上線或被取代。
  4. 如果本地預設分支領先、分歧或缺乏上游;快進拉取失敗;任務分支與當前預設衝突;或擷取的遠端狀態與指派矛盾,則停止變更並向擁有者呈現精確的提交、檔案、URL、衝突、風險和安全選擇。
  5. 僅在簽出是當前的,或者擁有者選擇如何保留/調解它之後,才恢復正常工作。在沒有明確的清理權限以及其已上線或被取代的證明之前,絕不刪除分支或獨特的工作。

在每次上線之後和任何發布閘門之前重複同步。

運作模式

  1. 使用 github-project-triage 來映射每個儲存庫的未解決問題、未解決 PR、CI、最新發布、套件中繼資料和未發布的變更日誌。在判斷適合性之前,如果存在 VISION.md 則讀取它;否則使用已記錄的產品方向和維護者判斷。
  2. 對每個佇列項目進行分類:
    • Autonomous:清晰的適用性、可重現、有界限的實作以及可用的驗證路徑。
    • Needs owner:產品選擇、安全性/隱私決策、不可用的憑證/存取、不可用的即時證明,或破壞性/不可逆的選擇。
    • Ignored by owner:擁有者明確表示不得影響當前工作的項目。
  3. 將每個獨立的儲存庫委派給精確一個根擁有的 Codex 應用程式專案執行緒。為整個佇列重複使用它,並在工作發生重大變更時更新其 <Project>: <current status> 標題。專案執行緒序列化處理其佇列,並且絕不建立或管理其他執行緒。省略模型選擇並繼承平台預設值。
  4. 維持一個目標,即跨不同儲存庫擁有 30 個並發的合格根擁有的 Codex 應用程式專案執行緒。
  5. 在其專案執行緒中,每個工作者會按順序處理佇列項目。工作者必須在完成一個項目後報告,然後根編排器會更新其狀態並可能指示下一個項目。
  6. 定期檢查每個工作者的狀態和進度。如果一個工作者似乎停滯或遇到問題,根可以詢問、提供指導或重新分配任務。
  7. 當一個佇列項目完成時,根會驗證結果、更新儲存庫分類帳,並可能觸發後續動作,例如建立發布。

發布閘門

在建立任何發布之前:

  1. 驗證所有用於發布的專案執行緒都已成功完成其佇列項目。
  2. 檢查 CI 在相關分支上是否通過。
  3. 確保變更日誌是最新的並準確反映變更。
  4. 確認所有相依性都已滿足且是最新的。
  5. 獲得擁有者的明確核准才能繼續發布。
  6. 使用適當的發布機制(例如 GitHub Release)並遵循專案的發布流程。
  7. 發布後,驗證發布工件是可用的,並且相關的標籤和分支是最新的。
  8. 更新任何必要的文件或公告。

工作者管理工作

  • 跟蹤每個專案執行緒的狀態(活躍、等待、已暫停、已完成、失敗)。
  • 監控工作者健康狀況和資源使用情況(例如磁碟空間、記憶體)。
  • 如果一個工作者崩潰或變得無回應,根可以嘗試重新啟動它或在必要時建立一個新的執行緒。
  • 維護一個日誌,記錄哪些工作被分配給哪個工作者、它們的進度以及遇到的任何問題。
  • 當一個工作者成功完成其所有分配的工作時,根可以將其標記為已完成並釋放其資源。

注意事項

  • 此技能假設對相關的 Codex 平台和 GitHub API 具有存取權限。
  • 適當的憑證和權限設定是先決條件。
  • 此技能的效能將取決於 Codex 工作者的可用性和回應能力。
  • 編排邏輯應足夠健壯,以處理工作者失敗、競態條件和意外的狀態變更。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

steipete/nano-banana-pro

Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.

相關技能