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會匹配到自身。這些存在於操作員的記憶中,而非儲存庫。
當學到新規則時,請將其新增至那些檔案,而非此處。