handoff-protocollisted

# 交接紀律(Handoff Protocol) ## 什麼時候用 任何工��分成三個角色的時候:**決策者**(定方向、拍板)、**把關者**(審查、驗收)、**實作者**(動手做)。 三者可能是三個人,也可能是「人 + 審查者 + 自動代理」。這技能講三者之間**交接的格式與紀律**, 讓協作不靠猜、不燒溝通成本、不出無聲的錯。 --- ## 通用法則 ### 法則 1:回報結果用「一行結論」,不貼原始輸出 把關者要的是**結論**,不是你螢幕上的一切。跑完一件事,回報一行:做了什麼、結果是綠是紅、關鍵數字。 - ✓「全量測試 1372 passed / 0 fail(baseline 1341 + 31 新測)」 - ✗ 貼三百行測試輸出讓對方自己找。 原始輸出留在檔案/日誌,需要時再指路。**溝通空間有限,別用它搬運噪音。** ### 法則 2:進度段要「省空間」 長時間任務中途回報進度時,同樣一行:目前到哪、有沒有異常。不要每一步都貼完整細節—— 對話/上下文空間是稀缺資源,塞滿了反而看不到重點。 ### 法則 3:不悶頭長跑(先估時、按時回報、超時喊停) - **動手前先估**:這件事大概多久? - **按節奏回報**:長任務每隔一小段(如 2–3 分鐘)報一次「還在跑、到哪了」,別消失。 - **超時即停**:實際明顯超過預估(如 1.5 倍)就**停下來診斷**,別無限等——通常是卡住了,不是慢。 - **別重試已知無辜的**:已經驗過綠的東西別反覆重跑燒時間;針對可疑的查。 ### 法則 4:分辨「假卡」與「真失敗」,別把假卡當真 bug 改 長任務停住或報錯時,先問:**是我的產物錯了(真失敗),還是環境噪音(假卡)?** - **假卡**的典型來源:殘留的舊進程搶資源/檔鎖、上一輪沒清乾淨的狀態、外部相依暫時不穩、 同名資源多份實例互搶。 - **處置**:先**隔離**(把干擾源精準清掉——按進程 ID 精準結束,別誤殺無辜;**精準結束干擾的那個 程式,別全殺**)→ **乾淨重跑一次** → 若重跑就綠 = 假卡,不是 bug,別去改產物;若穩定重現 = 真失敗,才進入除錯。 - **鐵律**:假卡絕不當真 bug 改——「憑推測就改」會把一個好產物改壞。先重現、再定性、才動手。 ### 法則 5:交給把關者的東西要「可直接把關」 把關者要能**一眼複核**,不用重建你的上下文: - 結論(綠/紅)+ 證據(關鍵數字/對帳)+ 邊界(驗到哪、沒驗到哪,誠實標)。 - 若把關者要貼給更上層,給一段**可複製的定稿段落**(標題 + 結論 + 證據 + 邊界),別讓對方自己拼。 - 對帳要精確:「原 N + 新增 M = N+M」——數字對得上,把關才信得過。 ### 法則 6:實作者不代改決策者/把關者的文件 角色邊界是安全機制,不是形式: - **實作者不擅自改「決策者管理的文件」**(規格、需求、拍板紀錄)。要補內容 → 用**自己的**設計/計畫 文件引用它,或提案請決策者改。看見它被別人動過(工作樹有改動)→ **不碰、不提交**,回報即可。 - 同理,把關的判準由把關者定,實作者不自行放寬。 - 越界的代價:決策者失去對「真相來源」的掌控,後面所有人跟著錯。 ### 法則 7:誠實回報,壞消息不修飾 測試紅了就說紅、貼輸出;跳過了就說跳過;做完並驗過了就直說,不加沒必要的保留。 把關的前提是「回報可信」——一次粉飾,之後所有回報都要被重新驗證,協作成本暴增。