Communitygithub.com

cookys/autopilot

深度0 想要透過背景工頭與異質協作流程,從探測到推送發布,交付一份自動駕駛計畫或待辦事項整合包。繁體中文觸發詞——派工頭做完發版,平行工頭,落地發版。

autopilot 是什麼?

此技能實現了一個多重工頭的自動化管道,從探測(Probe)、計畫審查(Plan Review)、實作工頭(Implement Foreman)、落地工頭(Landing Foreman)到結案工頭(Closeout Foreman),每個階段之間都由 depth-0 進行驗證。depth-0 是唯一有權接受主張的權威;每個工頭的輸出都是證據,而非最終裁決。它支援 Claude Code 等具備背景 Sonnet 模型協作能力的平台,利用異質審查循環(hetero-review)與凍結檢查(freeze check)來確保計畫品質。關鍵機制包括:實作工頭使用 Clone 而非主要檢出,並放入影子提交(shadow commit)以繞過 Mission enforcement 限制;落地工頭從 `origin/develop` 建立全新 Clone,僅挑選手動提交(hand commits),並執行完整測試套件;跨階段驗證由 depth-0 獨立重新推導每個被駁回的發現。此技能也處理釋出閘門失敗時的修復,並要求在任何情況下都不可跳過結案工頭,以維護文件同步、證據歸檔與 HANDOFF 更新。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cookys/autopilot/tree/HEAD/.claude/skills/foreman-landing-pipeline

在你喜歡的 AI 中提問

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

說明文件

foreman-landing-pipeline

多工頭管道,用於交付一份計畫或 BACKLOG 整合包:探測 → 計畫審查 → 實作工頭 → 落地工頭 → 每個階段之間由 depth-0 驗證 → 結案工頭。depth-0 是唯一有權接受主張的權威;每個工頭的輸出都是證據,而非最終裁決。

0. 前置作業(在任何工頭存在之前)

  • 探測任何計畫所依賴、但你在此工作階段尚未透過 URL 或執行真實工具驗證的平台事實(參閱專案 CLAUDE.md「不要」§)。未經驗證的事實是 Spike 候選項,而非事實——將其以 Spike 形式放入計畫中,或先進行探測。
  • 撰寫計畫,然後透過計畫審查循環(autopilot:hetero-review → dispatch-plan-review)執行,而非依賴此技能自身的判斷:
    • 每次生成使用固定的評分表;主席更換需要操作員核准,而非工頭主動發起。
    • G1 處置具有約束力——每個被接受的項目都會逐字納入實作簡報的全域限制中。
    • 最多到 G2。 如果某個評分項目在 G1 被駁回,請以新的邏輯 ID 和工單取代,而非復活舊項目。
    • 在將計畫視為可實作之前,執行凍結檢查。
    • 凍結後允許進行有限修復,僅針對凍結檢查本身發現的缺陷——不得重新開啟已裁決的評分項目。

1. 實作工頭

派遣一個背景 Sonnet 工頭(標頭 Engine: sonnet——dispatch-model-guard 會拒絕缺少此標頭的派遣),使用 templates/implement-brief.md。對該簡報的判斷:

  • 使用 Clone,而非主要檢出。 Clone 攜帶一個影子提交(「PARALLEL-RUN LOCAL ONLY — mission_convergence enforcement_mode shadow, never land」),這樣 dispatch-hetero.sh 就不會在 Mission 強制模式下拒絕。將影子提交直接放入簡報中,在設定階段由 depth-0 撰寫——絕對不要將其作為後續訊息發送給工頭。 後續訊息不是授權;拒絕或錯誤套用影子提交正是 wave-1b 的代價。
  • 堆疊式行:每行的基礎提交 = 前一行的已接受頭提交(若經修復則為其修復頭)。每行一個手動提交,RED 優先測試,Verify 會執行該行自身的測試套件以及所觸碰合約的每個 CONSUMER 測試套件——不僅是整合包測試套件。
  • 每行審查在此處進行,但將其視為必要而非充分條件——參見 §2 的合併審查。
  • 軌道故障(配額、402、就緒狀態、「無法使用此模型」)屬於 RAIL-FAIL,不是工頭自行撰寫程式碼的理由。

1b. 在派遣前評估規模(2026-10-02/03)

  • 獨立行以平行方式執行,而非堆疊:每行使用一個 Clone 中的各自工作目錄,由一個 Sonnet 手動操作,使用 templates/hand-brief-common.md。僅堆疊真正的依賴項。七個平行的 S 行約在 1 小時內完成;相同規模的堆疊式低成本行整合包則耗時約 3 小時。
  • 手動選擇:規模較大或涉及 signals/traps/sandboxing 的行,應使用 Sonnet 手動操作(Agent,模型 sonnet),而非低成本軌道手動操作——6/7 個低成本手動操作行需要一輪修復。
  • 絕對不要為了節省時間而跳過每行審查:v2.36.108 跳過了它,結果三個問題只在合併審查時才浮現,每個都耗費了一輪落地。
  • 消費者掃描(含 L1) 是每個手動操作 Verify 的一部分(範本中說明了方式);只執行其 bash 測試套件的手動操作會將失敗推遲到落地閘門。
  • 在派遣時告知操作員預計的實際時間。

2. 落地工頭

使用 templates/land-brief.md 的新簡報,僅在 depth-0 已根據 git 證據(diff,而非自我報告)接受每個實做工頭行之後才派遣。對該簡報的判斷:

  • 從 origin/develop 建立全新 Clone,而非實作 Clone。 在最初的設定行中設定 git config core.hooksPath .githooks——沒有此設定的落地 Clone 會在未執行 pre-push qc-gate 的情況下發布(v2.36.99 就是這樣發布了包含文字 <id> 的 trailer)。
  • 僅挑選手動提交。 絕對不要影子提交;每次挑選後 grep enforcement_mode 仍顯示 enforce。
  • 完整測試套件,而非範圍縮減的切片——觸碰廣泛使用之合約的變更需要執行完整的 hooks/tests/run.sh。重新執行每個紅色的獨立測試;任何仍為紅色的測試,在 origin/develop 的拋棄式工作目錄中進行比對,以區分預先存在的紅色與該分支引入的紅色。
  • 一次合併審查,針對 origin/develop..HEAD,絕不重新執行每行審查。合併審查曾在此精確管道中捕捉到每行審查遺漏的內容(multiplexer allow-bypass 以及一輪中的五項發現——請參閱已學習規則)。若該裁決中包含任何 🔴/🟠,則停止;不要自行將其裁定為無效。
  • 僅在閘門為綠色且裁決為 SHIP-AS-IS 時才發布:版本號提升、BACKLOG/CHANGELOG/INDEX、preflight-release.sh。
  • Trailer 應根據審查 manifest 的真實審查 ID 填寫(合併審查實際產生的 JSON),絕不留作文字佔位符。推送,然後使用 git ls-remote origin develop 確認。

3. depth-0 在階段之間的職責

  • 自行重新推導每個被駁回的發現。 ADR-0001(驗證勝過證明):工頭聲稱「此發現為誤報」只是一個主張,而非事實,直到你從相同的 diff 中重新推導出它。
  • 獨立驗證每次推送:git ls-remote 符合報告的 SHA、trailer 包含真實的審查 ID(非 <id>)、governance 仍顯示 enforce,且沒有影子提交被落地。
  • 已暫停工頭不會自行喚醒。 在派遣時同時設定背景死寂計時器(sleep <n>; echo WAKE-<tag>),以及在喚醒時檢查 git 狀態,並使用 SendMessage 提醒應該回報但未回報的工頭。

4. 結案工頭

使用 templates/closeout-brief.md,在真實儲存庫上執行(非 Clone——「此處不執行其他操作」)。此步驟絕不可跳過,即使對於小型整合包也是如此:

  • 僅針對已發布的確切 diff 範圍進行範圍限定的文件同步——僅修正真正的漂移。
  • 針對在管道執行過程中發現、但不在本次修正範圍內的事項,建立一個 BACKLOG 行(例如:疑似但未確認的污染事件)。
  • 在 docs/plans/evidence/<date>-<slug>/ 下建立證據目錄,包含每份簡報、每份 REPORT、每份審查 JSON,以及一個簡短的 README,列出探測項目和合併審查的捕獲項目。
  • 以現有風格更新 HANDOFF(適用繁體中文慣例——請參閱專案 CLAUDE.md)。
  • 一個提交,若觸碰 qc 保護路徑,則其閘控方式與落地提交相同。

修復(當落地閘門僅在發布分支上出現紅色時)

當落地工頭的閘門執行發現測試套件在發布分支上為紅色,但在 origin/develop 為綠色時,使用 templates/repair-brief.md。首先按叢集進行二分查找——信賴二分查找而非可疑猜測。每個叢集一個修復手動操作,在重建的影子分支上執行(絕非發布分支本身),審查方式與實做工頭的手動操作相同。每個叢集最多一輪修復;在此之後仍為紅色的項目為 FAIL,進行報告,而非由工頭自行修復。

規則——規範性內容位於別處(請勿在此重複)

此技能是檢查清單和範本(templates/*.md)。規則及其來源事件位於:

  • skills/l5/references/hetero-impl-loop.md §「Sonnet 工頭作為 Agent 子代理」:影子提交放入簡報、落地 Clone 設定 core.hooksPath、trailer id 來自 manifest、落地工頭在 🔴/🟠 時停止。
  • references/evidence-discipline.md §42–§44:諮詢通道的存在並不保證訊息送達;每行審查不能取代合併審查;真實儲存庫的 diff 並非測試污染的證明。
  • 工具防護陷阱:exec-boundary 區塊會封鎖 even heredoc 文字中具有破壞性的單詞,因此請先將腳本寫入檔案;pgrep -f/pkill -f 會匹配到自身。這些存在於操作員的記憶中,而非儲存庫。

當學到新規則時,請將其新增至那些檔案,而非此處。

相關技能