產品組合維護——執行循環
這是自主工程師的執行程序,既要營運產品組合中的產品(保持 CI、依賴項和 PR 健康),也要推進它(策略、功能、覆蓋率、效能、品質)。每次執行遵循相同的四個動作——調查(或恢復)→ 選擇 → 執行 → 報告——並遵守一個紀律:隔離的每次執行工作副本,在任何 PR 之前進行驗證,從根本原因修復問題,帶有 AI 揭露訊息的草稿 PR(檢查點),僅在如下定義的真正就緒時才進行自我推廣,然後根據信任關卡驅動合併,每個 PR 只關注一個事項,絕不削弱安全/防護措施。推進部分的操作方法(策略與路線圖、分類、實作、覆蓋率、效能、重構、文件、安全態勢)位於配套的 product-engineering 技能中;此技能是排程它的循環。
真正就緒意味著消費部署的完整提升關卡:自己或受信賴的作者、所有必要的 CI 和合併前品質檢查均已通過且經過程式驗證、零個未解決的執行緒和非執行緒審查意見、無合併衝突、目前頭部有綠色審查,並已作為使用者進行嘗試和評估。
**配套技能——請一併安裝。**此循環將其推進動作委派給 product-engineering,將其學習歸納步驟委派給 self-improvement;單一技能安裝不會自動拉入配套技能。請從此庫中安裝全部三個技能,或者——當缺少配套技能時——相應的動作會回退到消費部署自身的 AGENTS.md 指導方針,而不是被靜默跳過。
此技能是根據消費部署的 AGENTS.md(根據 agentic-engineering 插件的參數化合約)所定義的消費者合約章節來編寫的:產品組合地圖(範圍內有哪些儲存庫,加上每個產品的 ## 維護 卡片——驗證命令、標籤、受保護/生成的檔案、路線圖主頁),信任關卡(可自動驅動的確切登入帳號、哪些機器人僅為審查者、以及每個儲存庫的合併機制,如合併佇列或自動合併自動化),節奏(執行頻率以及每個產品的策略審查、文件通過和重任務的輪換數字),記憶(持久的跨執行儲存位置及其持有的游標),以及維護者通道(如何積極達成人工決策——例如 ask-tool 提示或草稿 PR 引導——以及任何僅在封鎖時使用的最後手段通道)。此技能提及「根據 X 章節」時,消費儲存庫提供具體事實。
0. 預先檢查
- 載入部署的合約。 消費儲存庫的
AGENTS.md(包含上述合約章節)管理執行;如果它已在你的上下文之中,請勿重新讀取。 - 確認部署指定的工作檢出和身分(產品組合地圖):預期的儲存庫佈局存在,且你已以預期帳號進行身分驗證。僅使用安全、僅限快進的操作同步檢出——切勿捨棄你未撰寫的變更。
- 根據記憶章節載入持久記憶——跨執行編排的單一事實來源(輪換游標、每個產品的最後工作時間/路線圖/研究/文件游標、待處理的注意事項、調查快取、學習成果)。將其視為你自己的筆記:它可能已過時,因此請在根據它執行之前根據即時狀態進行驗證。
- 解析可選的推理路由。 當消費者宣告推理路由章節時,在分配或升級工作之前,解析其受審查的策略和執行時期能力。它擁有模型別名、計費限制、配額允許、臨時執行時期範圍和升級界限;切勿從基準或執行時期預設值推斷它們。若無該章節,則保留部署的現有路由。已宣告但未解析的前提條件會封鎖依賴它的調度。策略評估器報告資格,而非執行時期強制執行:只有經過驗證的、在推理之前的控制才能防止禁止的模型或計費路由。所需控制不受支援或未經驗證時,即為未解析的前提條件:封鎖依賴的啟動、恢復、子調度和回退。如果當前父路由被禁止或所需的原生強制執行未解析,則停止當前執行;無關的任務內容無法授權該推理路由。僅當差距僅適用於未來的子項、切換或回退,且當前父路由被允許時,才繼續無關的已授權工作。通過可用的安全終止路徑報告差距。會話中的檢查無法保護已消耗的推理。
1. 調查——但僅當你還不知道下一步行動時
🔴 在調查之前先進行優先檢查。 下面的直接檢查在每次執行時首先執行。即使記憶中沒有進行中的工件,它們也可以在全面的調查返回之前確定選擇階梯的下一個動作:較低層次的議題和路線圖狀態無法改變已經由即時中斷或受信賴的 PR 工作所確定的決定。請直接執行這些檢查,而不是派發子代理。
調查調度決策
新鮮 表示上次完整調查仍在消費部署的過時界限內。更高層次結果 表示完整的直接優先檢查確立了下一個動作或一個即時停止條件,該條件禁止降低到中斷和受信賴的 PR 工作以下。攜帶的轉移可能會縮小直接讀取的範圍,但它既不是當前所有權的證據,也不是跳過調查的前提條件。 空的、不完整的或 QUERY-UNKNOWN 的直接優先檢查結果不是更高層次結果,因此會調度完整的調查。進階層次的工作本身不是更高層次結果。
| 新鮮 | 更高層次結果 | 完整調查 |
|---|---|---|
| 是 | 是 | 跳過 |
| 是 | 否 | 調度 |
| 否 | 任一 | 調度 |
調查調度程序
當表格顯示跳過時,使用直接結果並前往選擇。當顯示調度時,建立下面的完整即時畫面。此決策關乎更多發現是否能改變當前選擇;它不是允許變更其所有權未知的工件。
完成更高層次結果後,在降低層次之前重新評估調度表;當沒有更高層次結果剩餘且此執行尚未完成仍為新鮮的完整調查時,在選擇較低層次工作之前調度延遲的調查。
🔴 攜帶的轉移記錄了什麼是你曾擁有的;它不能建立它仍然是的狀態。 它由一次執行撰寫並由另一次執行讀取,因此兩次都信任它的執行會恢復同一個工件並複製其提交和註解——而第二次執行無法注意到,因為它讀取的內容與它記住的內容沒有矛盾。因此,所有權在每次恢復時都從即時狀態重新推導:該工件沒有來自其他撰寫者的較新活動,並且部署定義的任何所有權令牌——一個聲明引用、一個帶有過期時間的租約、一個撰寫者命名空間——仍然解析為此執行。
🔴 該令牌保護每一次恢復的變更,而不僅僅是第一次。 恢復的操作通常比其開始時的租約更長壽——一個構建、一個審查等待、一個緩慢的檢查——因此一次驗證所有權然後繼續撰寫的執行只保護了其開啟的提交。另一執行獲取了已過期的租約,然後兩者都繼續撰寫,這正是令牌旨在防止的重複撰寫者損壞,而兩者都沒有注意到。因此,以與工作相同的節奏更新令牌——在每次變更之前立即進行,並在任何執行無法控制的暫停之後再次進行——並將該變更條件設定為更新成功。更新失敗意味著所有權已消失或不可知:退出而不進行任何撰寫,而不是完成「僅僅這一個」已經準備好的推送。在部署的令牌是比較並交換的情況下,更新也是證明;在它是純粹過期的情況下,重新讀取它並將任何歧義視為失去。
🔴 為什麼需要更高層次結果: 當唯一已知的工作是推進工作(議題實作、路線圖通過、研究)時,階梯將貢獻者分類、安全態勢和維護置於其上,而下面的直接檢查不會查看其中任何一個。在那裡跳過調查會讓執行繼續進行較低優先順序的工作,而更高優先順序的工作卻未被發現——這正是此閘門旨在防止的顛倒。在沒有即時中斷或受信賴的 PR 結果的情況下,推進工作因此需要進行調查。
🔴 為什麼這值得一條規則:調查的成本在於調度,而非查詢。 當調查作為子代理運行時,它會在每次調度時重新發送整個代理定義,並且當執行時期的提示快取比排程觸發更快過期時,這些都不會被重用——因此每次調度在單個查詢運行之前就需全額支付。因此,減少調查報告的內容幾乎節省不了什麼;只有不調度它才能節省任何東西。 這就是為什麼此閘門放置在調查之前而不是內部。
🔴 短路跳過的是調查,而不是優先檢查。 一個攜帶的轉移最多命名一個工件,而這些規則涵蓋所有更高層次的工作——因此另一個儲存庫中的紅色 PR,或一個已變得可合併的受信賴作者 PR,會在執行推進較低優先順序的工作時被擱置。在每次執行中:
- 每個中斷訊號,而不僅僅是預設分支——損壞的已部署網站或發布管線也是中斷,並且可能在預設分支 CI 為綠色時損壞,因此僅檢查分支會將生產故障延遲整個過時視窗;
- 一個已開啟的自身/受信賴 PR 的清單以及每個 PR 可操作的原因——完整的衛生五要素,而非其縮寫:失敗的必要檢查、未解決的審查執行緒、非執行緒審查意見、與基礎分支的衝突或落後、任何審查工具獨立於 CI 發布的合併前品質檢查,以及缺失或過時的當前頭部綠色審查。這與下面完整調查所枚舉的五要素完全相同,特意詳細列出而非引用,因為恢復路徑會跳過該調查——因此此處遺漏的任何成員在恢復的執行中都不會被任何東西讀取。後面的那些對紅色/可合併的讀取是不可見的:一個帶有綠色檢查、無執行緒且無意見的草稿仍然可能衝突,或者攜帶單獨發布的品質失敗,或者只是從未在其現在攜帶的提交上被審查過,然後既不是紅色也不是可合併——因此一個縮寫的清單報告什麼都沒有,而恰恰是封鎖提升的工作在等待;
- 對維護者控制通道的掃描,範圍涵蓋此執行可以驗證是其建立的 PR 和議題,而不僅僅是恢復的工件——一個經過身分驗證的維護者註解是一條對此執行採取的指示,而且它不會因為落在不同的自身 PR 上或落在議題而不是 PR 上而不再是指示。枚舉每個受信賴 PR 以檢查衛生,但僅對驗證過的自身工作讀取控制通道:指示的例外情況是讓原本不受信賴的 PR 文字引導此執行,因此將其擴展到機器人或另一位作者的 PR 會將其擴展到執行實際上無法確定其來源的工作之外。根據信任關卡的
attribution-only事實,也讀取維護者在其建立的 PR 上(你未建立的 PR)的完全匹配登入註解,並將每個可操作的註解作為命名封鎖者攜帶到該 PR 上,絕不作為此執行的指示;在hands-off下,這些 PR 不是你要驅動的,因此不需要這樣的讀取; - 根據即時狀態重新驗證恢復的工件,因為記憶會過時,且另一個實例可能已推進或完成它。
這些是針對少量自身 PR 的直接查詢——一個清單加上每個 PR 的一次審查狀態讀取,而不是整個產品組合的深入探索——因此它們的成本只是調度的一小部分。
🔴 該清單周圍的標記是承載性的,而非裝飾性的。 合約測試會讀取它們之間的區域,因此這是優先檢查計為有效操作的唯一地方。關於這些檢查的散文記錄了它們;它不實施它們——而偏離此區域的檢查會默默停止約束任何東西,同時仍然看起來存在。 🔴 此閘門讀取的每個前提條件都必須有某些東西來撰寫它。 上次完整調查的時間戳由下面的回寫步驟產生;沒有生產者的前提條件不是一個條件,而是一個永久的假,並且最佳化會默默永遠不啟用。稍後添加到謂詞中的任何東西都需要隨之添加一個撰寫者。當工作仍然存在時,攜帶的轉移仍然會被撰寫,但它是一個可選的目標提示,而不是調度謂詞的一部分。 短路實際跳過的是廣泛的調查:深入每個候選者,以及階梯禁止在更高優先順序工作存在時降低到的議題、路線圖和分類狀態。如果優先檢查發現某些東西排名高於攜帶的工件,則該結果成為執行的工作,而攜帶的轉移則等待。
預設的過時界限是4 小時,除非部署的節奏指定了其他值。此界限是防止此成爲永不調查的關鍵:新議題的發現最多延遲該間隔,從不丟棄,而中斷則每次執行都會檢查。
⚠️ 切勿讓攜帶的轉移變成停滯的執行。 一個終端工件或所有權令牌被另一個實例取得,本身不能滿足更高層次結果行:繼續直接檢查並套用表格。