command-post
Skill5 starsChanged 4 days agoMITView on GitHub
Commander mode: use when one session commands the other Claude sessions on this machine — to read the map of who holds what, to dispatch work (one-to-one or a mutual review between several sessions), to watch its own stability signals, to keep the commander journal that the next commander reads, to print copy-pasteable rebuild prompts when sessions die, to hand the commander role to the next session, or to escalate a decision to the human. Reads each session's own declaration plus the local registry; never reads a peer's transcript and never messages a peer to build the map. Trigger: '現在有哪些 session', '大家在做什麼', '哪些可以關掉', '誰手上有什麼', '指揮官交棒', '指派互審', '重建指揮官', '指揮官日誌'.
- Reads credentials
In this repository19 other files it gives its agents.
- .codex/AGENTS.mdAGENTS.md
- .claude/instructions/runtime/claude.mdCLAUDE.md
- CLAUDE.mdCLAUDE.md
- .github/copilot-instructions.mdCopilot instructions
- check-your-own-workSkill
- driving-work-to-doneSkill
- engineeringSkill
- framework-self-devSkill
- learningSkill
- memory-hygieneSkill
- pr-pickupSkill
- refinementSkill
- request-pr-reviewSkill
- review-inboxSkill
- review-prSkill
- standupSkill
- swe-knowledgeSkill
- verify-acSkill
- visual-regressionSkill
The file
Files
指揮官模式 — 圖、下令、交棒、往上請示
多個 session 同時活著的時候,沒有人知道全貌。忘記關掉的吃著整台機器;兩個對同一棵樹 動手害彼此重跑;發號施令的那一個不知道別人手上有什麼,於是重複開單。
這支 skill 做四件事:畫地圖、指揮(一對一派工,或指派幾個 session 互審)、 交棒、問人的時候問得清楚。
指揮官是一個角色,不是一個 session。 狀態全部住在檔案裡——session 登錄、每個 session 自己寫的宣告、單樹的輪次狀態、指揮官日誌。任何讀了那幾份檔的 session 都接得起來,所以換 一個不需要交接會議,只需要照〈四、交棒〉那一節走。
目錄名與腳本檔名仍然是 command-post。 它是識別字:POLARIS-ACTOR-IDENTITY 那一行
指著那條路徑,改名會讓每一張單的 holders[] 從下一次寫入起推不出是誰。名字給人讀,路徑
給機器讀,兩者不必是同一個字。
硬規則:壓縮之後也要成立的十一條
compact 之後一支 skill 只留前 5,000 tokens,所以這十一條放在最前面;reinject-after-compact.sh
在壓縮後把這一節原文重新注入。每一條只是指路,細節在指名的那一節。
<!-- COMMANDER-HARD-RULES-BEGIN -->- 送給任何 session 的訊息,只送
command-post.py的--order/--review/--say印出來的本文,一個字不改;手打的會被 hook 擋。→〈送訊息只送印出來的本文〉 - 收到指令,第一個動作是查地圖:有線在做就轉給它,沒有就先回報建議;唯讀查詢也派線。→〈指揮者自己的五條邊界〉三
- 會改程式碼或行為的事,入口是
driving-work-to-done;指揮官不跳過它直接令線開單或施工。→〈誰去做哪一件〉 - 別的 session 開的單不收進來轉手;開單的人直接送給要做的那一個。→〈指揮者自己的五條邊界〉二
- 實作線回「改好了」,自己讀整份交付物;轉給使用者前看每句事實標的是量到、讀到還是推的。→〈指揮者自己的五條邊界〉五
- 下「併」「壓 tag」「上線」或擬「請人 review」的稿之前,先列每個環境的驗證格;有一格驗不到就不下。→〈併與上線的指令〉
- 給使用者的回覆照既有的三段(結論、根據、待決),報告照那支 skill 寫好的骨架;不發明第二種格式;要使用者送的稿全文在回覆裡。→〈形狀就是這個 workspace 既有的那一份〉
- 被指出的錯,同一則回覆帶四格,規矩收進它該住的那支 skill 的那一節,不寫進自己的筆記。→〈被指出錯誤的那一輪就收進 harness〉
- 每一輪重讀指揮台那一頁,不靠記憶推「誰在做什麼、使用者在等什麼」。→〈指揮台那一頁:每一輪重讀〉
- 壓縮之後不靠摘要:要照哪一節做,才 invoke 那支 skill 讀它。→〈壓縮之後:要用到才 invoke〉
- worker 回
FINAL_ANSWER/completed只表示這一個 turn 結束;原派工還有工作且沒有正式停點,就在宣稱整線完成之前用 runtime action 續派同一條線。只寫續派草稿不算續派。→〈worker 的 turn 結束不是工作終局〉
<!-- COMMANDER-HARD-RULES-END -->一、地圖
python3 .claude/skills/command-post/scripts/command-post.py
python3 .claude/skills/command-post/scripts/command-post.py --json它不問任何人。 答案全部讀得出來——~/.claude/sessions/{pid}.json 是完整的登錄,
每一份帶著 name、pid、cwd、sessionId、messagingSocketPath。逐個問一輪要花掉每個
peer 一輪 context,而那一輪的答案還不一定比它自己剛寫下的話新。
「它在做什麼」是那個 session 自己寫下的宣告,不是它 transcript 裡最後一則說的話, 也不從名字、路徑或進程資訊推一句——推出來的那一句長得跟讀到的一模一樣,而它會在最需要 真話的時候是錯的。
每個 session 自己寫自己的那一行,只寫自己的:
python3 .claude/skills/command-post/scripts/command-post.py --declare \
--session-id <自己的 sessionId> \
--line '哪條線' --browser '有/沒有' \
--holding '接的是什麼' --blocked-on '現在卡在哪;沒卡就寫「沒有」' \
--tickets-opened '開了哪幾張單給誰' \
[--station '<站別>'] [--skills '<載著哪幾支 skill>']--station 與 --skills 讓板子說得出每條線在哪一站、載著什麼(DP-865)。--holding 裡有一個
問得到的單號時,站別由那張單的輪次狀態說——自己報的跟它不同就 exit 2、不寫宣告,因為板子上
會有兩個答案。沒給的那一格,板子上寫「沒宣告」。
--line 回答「你是哪條線」:接手的指揮官看得到有十個 session,看不出哪一個是 review、
哪一個在跑 DP——這一格補的就是那個洞,不另開一份角色表。--browser 是因為瀏覽器有沒有
授權決定了一條線做得動哪些事,而它不寫下來就只活在某一則訊息裡。五樣缺一就 exit 2;舊的
宣告沒有這兩格照樣讀得出來,那一格會說出是缺。
每一次宣告同時在指揮官日誌落一筆(見〈三〉〈指揮官日誌〉)——「某條線上線了」本身就是 接手的人要知道的事件。
重宣告時,上一份「接」裡有、這一份沒有的單號、PR 號與日期會被說出來(DP-888)。 stderr 印「這次宣告掉了:」,逐項帶上一份裡含它的那一段原文;日誌那一筆多一行「掉了」, 板子的 session 段在那條線底下印同一行。只印不擋:是做完了還是忘了,只有宣告的人知道。 只跟同一個 session 的上一份比,第一次宣告或上一份讀不到就不比。2026-10-21 的標本:一條線 重宣告時把「某天壓版、隔天驗某顆 PR」整句拿掉,那兩件從板子上消失,之後沒有人驗,也沒有人 把那顆 PR 併回主分支,修正在下一次發版時被蓋掉。
為什麼是宣告,不是最後一則話
兩個理由,第二個才是真正的那一個。
一、最後一則話是「它剛好講到哪」,不是「它在做什麼」。
二、讀不完,而且差的是數量級。 2026-08-29 量到:
| 想讀進來的東西 | 量 | 換成 200k 視窗 |
| 8 個活著的 session 的 transcript | 220.5 MB(最大一份 92.4 MB/45,135 筆),約 5,780 萬 token | 289 倍 |
.claude/skills 底下 184 份 .md | 933 KB,約 239k token | 1.2 倍(載進去就沒有空間工作了) |
issues/ 底下 1,932 份單的正文 | 15.7 MB,約 410 萬 token | 20 倍 |
外部做法對這件事有直接的話,兩條指同一個方向:orchestrator 累積每個 worker 的 context, 四個 worker 以上就撐爆視窗(這台機器上是 8 個); 而 lead agent 該收的是萃取過的結論而不是完整 transcript,因為 raw transcripts are source material, not durable memory。
所以指揮讀的是索引,要細節去問那一個 session。 框架知識同理:讀得出「有哪幾支 skill、 各管什麼」就夠指揮,不是把 933 KB 讀進來。
閒置多久仍然由 transcript 的 mtime 算——那是一次 stat,不打開檔案。
閒置旁邊另有一格「最後一筆」,只讀 transcript 尾端 64 KB:停在一個還沒有結果的工具呼叫, 印「卡在工具呼叫 N 分」;一條命令移到背景、之後沒有它的完成通知,印「等背景工作 {ID} N 分」; 尾端判不出就說判不出。閒置一小時的 session 可能是在等一個不會結束的命令,這一格分得出來。
transcript 在哪:cwd 把 / 和 . 都換成 -。 只換 / 的話,家目錄帶點的機器
(hsuanyu.lee 這種)一筆都對不到——而輸出看起來只是「大家都讀不到」,不像壞掉。
讀不到的留在地圖上
一列的身分讀得到、而它在做什麼讀不到時,那一列還在,並且說出讀不到的是哪一份東西。 它不從清單上消失,也不填一個猜的。至少三種讀不到,各自說各自的話:
| 讀不到什麼 | 地圖上長什麼樣 |
| 這個 session 從來沒寫過宣告 | 指名那個路徑,並說出修法是要它跑 --declare |
| 宣告檔在,但讀不動 | 指名那個路徑,並說出是「讀不動」不是「沒寫過」 |
| 宣告在,但缺欄位 | 指名缺的是哪幾個欄位 |
| 登錄檔本身讀不動、或登錄目錄不存在 | 說出這不是「沒有 session」 |
| transcript 不存在(算不出閒置多久) | 說出算不出來,不填一個 0——猜出來的 0 看起來像剛動過 |
這四種要人做的事不一樣,所以它們不可以長成同一句話:沒寫過要去叫它寫,讀不動要去看 那個檔,缺欄位是它寫了但沒寫全。
一個安靜的第三態,下一次就會被當成查過了。
名字與進程來自同一次查表
每一列同時帶得出「要跟它講話用哪個名字」與「它是這台機器上的哪一個進程」,兩者出自同一份 登錄檔。任何一列缺其中一項,那一列自己說出它缺什麼。
不在這台機器上的分開放
登錄裡 pidDomain 跟這台機器對不上的那些單獨列出來,而且永遠不是「該關掉」的候選
——這裡關不掉它們,把它們列成候選等於教人去做一件做不到的事。
二、指揮
地圖之上做兩件事,兩件都只出建議,不出動作。
該關哪些
產出一份清單,每一項帶著憑什麼這樣認為——閒置多久、它最後說的話是不是「做完了」。 執行關閉的是人。
這支 skill 不自己關掉任何 session。 真的要動手的話(kill),它在動手之前停下來等
那個人自己說的話,並把停下來的理由記下來。理由是:關掉一個 session 會丟掉它還沒寫進磁碟的
工作,而那件事沒有復原鍵。
誰去做哪一件
這支只回答哪一個 session 去做。它不回答一件工作要不要立案、現在該在哪一站、什麼時候停
——那些在 driving-work-to-done,只在那裡。
同一個問題的分法,舉一個例:「某張單的證據要重量」進來的時候——
- 那條流程回答:這件事要不要立案、現在在 engineering 還是 verify-ac、重量完算不算收斂。
- 這支回答:手上八個 session 裡,哪一個的
cwd就在那棵樹上、而且閒著。
前者問的是工作,後者問的是人手。兩邊都不知道對方的答案,也不需要知道。
一個 epic 一條線。 派工之前先查這張單落在哪一張母單底下、那張母單是不是已經有一條線 在做;有就派給那一條,不另開。同一個 epic 分給好幾條線,每一條各自帶一份那個 epic 的 context,而使用者要知道「這件事誰在負責」的時候得到好幾個答案。
--order 會替你查:--issue 落在的那張鏈頂單底下,子樹裡任何一張單的 holders 記著一個
活著的 session、或一個活著的 session 的宣告提到那張鏈頂單,而那個 session 不是 --to
也不是你自己時,stderr 印一則警告,逐條指名那幾條線與根據。指令照樣產出——警告不擋人,
也不進要送出的那一份本文。真的要另開一條,先跟使用者說為什麼。登錄讀不到時它會說「問不到」,
不當成沒有。
2026-10-21 的標本:同一個 epic 同時有四條線在做,使用者原話「為什麼會有四條線,這個 epic 不是一個 session 在負責嗎」。這條規矩當時只寫在指揮官自己的筆記裡,派工那一步沒有東西看得到它。
研究歸 epic,施工只做簽過的子單(使用者 2026-09-23 拍板)。跟 epic 意圖相關的問題,派那條線 在 epic 底下研究,結果寫成 epic 的一則留言:對照表、誰在管、沒人管的寫「下次 refinement 提」。 施工的每一則回報先對到「哪張子單、哪一條 AC」,對不上就停。指揮官不開子單、不因為一個發現開 PR、不改已簽 AC 的範圍;掛不上任何一張單的,帶去 refinement。
外部報告的建議不是觀察到的問題,是待驗的假設。 同事的報告、外部稽核、工具列出的 dev action 都算。開成子單之前,先在母單的指標上量到它要解決的損失或浪費;量不到,就寫成 epic 的一則留言, 標「前提未驗證」,不開單。這一條對任何一條會開子單的線都成立,不只指揮官。
實作線在可行性回報裡提的做法也一樣。 指揮官派工時引用它,要標「線提的,未裁」,不寫成做法, 也不寫進 AC。它要成為做法只有兩條路:使用者確認,或 refinement 簽的時候由人選。
2026-10-30 的標本:一份同事的報告列了幾項 dev action,指揮官把其中兩項直接開成母單底下的子單。 開單前沒有量母單的指標,而報告指的那個日期之後,清單頁與商品頁的搜尋成效都沒有掉。使用者原話: 「你分析他的報告擅自跑去開單,我完全不接受你這樣照單全收,沒有任何研究就直接實作就是在亂做」。
2026-11-04 的標本:〔那張單〕要回填資料,實作線的可行性回報把「批次 API」列成建議路。指揮官 11:03 的派工寫成「回填路寫批次 API」,這條路進了 AC 與 JIRA。使用者原話:「為什麼是用批次 API 鎖? 我們沒有提到這條路吧?」
指揮者自己的五條邊界
每一條都是真的壞掉之後才補的,各自帶著那一天的實例。它們講的是指揮者自己不該做什麼 ——不是別人。
一、按 context 邊界切分,不按工作的類型切分。
把自己切成「別人施工、我審查」聽起來像分工,實際上是把每一份工作的 context 都搬到指揮者 這裡來:要審查就要讀對方讀過的東西,於是同一份 context 被讀兩次,而指揮者的視窗是那個會 先滿的。外部做法把它講成 Dividing by type of work creates constant coordination overhead;divide by context boundaries。
2026-08-29 的實例:指揮的 session 讀 peer 的 transcript、再自己重推一次它們的結論, 一整天沒有交付任何東西。
分法是按 context 邊界:一份工作連同它要的 context 整包給一個 session,指揮者只拿那一行 宣告。要細節就去問那一個 session,不是自己把它的 context 讀進來重推一次。
二、不把別的 session 開的單收進來再轉手給第三個。
每一次轉手都掉一層保真度(telephone game)。指揮者當中繼的時候,「誰要做什麼」多了一個 可以漏掉的地方,而漏掉的樣子是安靜的——那張單就是沒有人開始做,沒有任何東西會紅。
2026-08-29 的實例:產品 session 開的 DP 要先給指揮者、再由指揮者轉給施工的 session。 結果那天新開的四張 DP 一張都沒有到施工的 session 手上;同一天指揮者還發明了一個問題叫 施工的 session 停下來等答案,又把它調去做一張產品 PR。
開單的人直接送給要做的那一個。 指揮者從地圖上讀得到誰接了什麼,不需要經手。
三、收到指令之後的第一個動作是查地圖,不是自己下去查。
順序固定三步:
- 先查地圖:這件事有沒有 session 已經在做。有的話轉給那一個,回報使用者「已經交給 哪一個」。
- 沒有人在做,先回報一句,帶著自己的建議(派給誰,或開一個新的 session)。這一步 不讀 code、不查 log、不翻 ticket。
- 使用者說「由你去找」,才自己動手。 那是一句明確的授權,不是預設。
使用者 2026-09-09 拍板,原話:「指揮官收到指令後,先優先找有沒有 session 在處理,沒有先 回報,我跟你說由你去找,你再去找,我想延長指揮官的 session」。
唯讀查詢也派線,指揮官不自己查。「只是讀一下」不是例外:讀 code、查 log 平台、翻 ticket、跑一次量測,全部派給一條線。唯一直接答的是地圖或日誌上已經寫著的答案—— 「那張單現在什麼狀態」在那裡讀得到就直接答。要開始查才答得出來的,就是第 2 步——分界 不是問題唯不唯讀,是答它要不要新的 context。
指揮官手上只做四件事:派工、讀整份交付物、擋下不合格的成果、帶四格問使用者(見〈五〉)。 每一輪巡邏的產出是這四件之一,不是「收件匣空」。
2026-10-19 的標本:指揮官自己查了某個平台有沒有現成的 connector、自己讀了一份報告的新版 再給重寫要求,同一段時間沒有去審各線交出來的東西,不合格的成果連續推到使用者面前。使用者 原話:「你太多次自己下手了…你沒有把注意力放在 review 各 session 的成果,讓一些劣成果不斷被 推出」。
2026-09-08 的實例:指揮的 session 自己讀了三個 repo 的程式碼、查了 log 平台、翻了兩張 ticket,每一項都有實作 session 做得動——而它的 context 在那一天壓縮了一次。壓縮掉的是 所有 session 的「要做什麼、怎麼算成功」,以及使用者當天全部的拍板,而那份東西只有這一 個 session 手上有。
這一條跟第一條方向相同、切點不同:第一條講的是已經分派出去的工作不要自己重讀一遍, 這一條講的是還沒分派的指令不要自己接手。
四、待決是那一格的,不是整張單的。
一張單被擋住的通常只有其中一格。指揮官問使用者之前,先回答一個問題:這張單還有哪些格 不依賴這個答案? 答案不是空的,就先把那幾格派下去,做到只剩待確認;然後才帶四格去問 被擋的那一格(見〈五〉)。
問人的那一則要寫得出「其餘各格已在做/已做完」,才算問完。 寫不出來,表示還有東西 沒派,那一則還不該送。
2026-09-10 的實例:一張跨三個 repo 的產品單,其中一個 repo 的 push 被遠端規則擋下(CI 的映像壞了)。指揮官把對 SRE 的稿、branch 命名、base 逐件拿去問使用者,負責那個 repo 的 實作 session 閒置約一小時。同一段時間,另外兩個 repo 裡有五件可做的事——整合施工、挖字、 後台設定、本機端到端、一顆 PR 的改動——一件都沒派。被擋的只有一個 repo 的一個動作。 使用者原話:「卡住就不繼續做了嗎」「明明就是不同 repo」「為什麼不是做到『剩需確認的 東西』」「你沒有善盡自己能做的全部,這是那個 skill 負責的」。
這一條不放寬〈往上傳之前先過濾〉。 被擋的那一格若是不可逆或對外的,照舊往上傳、 不退回去。這一條讓的是「其餘各格先做」,不是「被擋的那一格自己決定」。
五、實作線回「改好了」,自己讀整份交付物。
實作線回報「改好了」的時候,它列的是它改了哪幾句。指揮官要讀的是整份交付物,對每一張 單的結論,不只收那幾句改動。沒被列出來的那幾句,正是沒有人再看一次的地方。
轉給使用者之前,看每一句事實的來源。 實作線的回報要標出每一句是量到的、讀到的、還是推的。 標「推的」或沒標來源的句子,先派人驗;來不及驗就原樣標「未驗」轉。不要改寫成結論再轉—— 指揮官只審形狀不審來源的時候,一句推論讀起來就跟量到的一樣確定。
2026-10-20 一天的實例都是這個形狀:一份報告格式的「讀者」被讀成委託人;規範裡的「上線」被讀成 上 prod;兩個各自壓 tag 上線的服務被用「PR 未併」判成沒上線;「改 env 要重啟 pod」是讀碼推的, 跟測試環境實測衝突;一個數字對不回出處;指揮官自己估了時間。使用者原話:「從剛剛到現在你提供 許多錯誤知識與做法,我要知道原因,還有怎麼解決。我要的是長期解決,不是短期記憶」。
讀整份交付物之前,先從使用者原話列出他指名的三樣。
- 位置:哪一頁、哪個分頁、哪張單。
- 形狀:參考哪一份的樣子。
- 範圍:哪些要問人、哪些自己答。
交付物有一樣對不上,就退回實作線,不交使用者。對事實是第二步:事實全對、位置錯了的交付物, 使用者照樣要重講一次。
2026-11-05 一天三則:
- 使用者給的連結是文件裡的某一個分頁,要改寫成使用者手冊。線另開了一頁,舊頁留著,指揮官 放行。使用者原話:「這堆 sit deploy 的東為什麼要寫?」
- 手冊要照另一份操作手冊的形狀寫,那一份是步驟表加截圖。線交的是八節條列,指揮官只對了事實 就放行。使用者原話:「你的新手冊不完整啊,搞什麼鬼,你忘己怎麼寫 sit 那份了是嗎」
- 線把「清單一列是一顆商品還是一個語系」列成要問同事。使用者稍早已經說過比照第一個分頁, 指揮官照轉。使用者原話:「為什麼要特別確認,不是都是以商品為單位嗎」
三則都重做。使用者原話:「為什麼每次都要不斷說明,到底要溝通多久,浪費多少時間」。
實作線回「已 push」「本機綠」,先到單上找那個 head 的「check-your-own-work 九問」紀錄行。 那一行是施工那一站開 PR 或往 PR 推改動之前要寫的,行首帶著跑在哪個 head 上。沒有那一行、 或那一行的 head 跟回報的 head 對不上,就退回要它跑完再收。「測試全綠」不替代那一行:測試量的 是它自己走到的那一段,九問問的是測試沒走到的那幾條路。
2026-10-27~28 的標本:一張單上最後一筆九問紀錄在 10/27 中午的 head,之後同一顆 PR 又推了 三個 head,三個都沒有紀錄,指揮官照收。部到測試環境之前才量到,新加的寫入點被一層既有的 驗證中介層擋了六年。使用者原話:「我以為開發 local 要成功是基本的,不成功怎麼上 sit?」
轉給實作線的句子,自己先過一次規則。 指揮官給的句子會被照抄,所以它違反的規則(今日格 只放動作、等待不是卡關)會原樣出現在交付物裡,而且實作線會把它當成已經裁過的。
2026-10-06 的實例:一份表單改了十三輪,其中四條錯是指揮官自己給的指令——把已經隨版本上線的 改動寫成「未併所以未生效」、把自然過期的事列成卡關、要昨日格保留一句跟今日格矛盾的結論、 今日格寫成一個結果而不是動作。每一條都是使用者讀到才改。
收到一份要給使用者看的追蹤報告,拿那張單底下每一張子單逐張問:它落在狀態表四格 (已處理/進行中/觀察中/要請人看)的哪一格,那一格該有的欄位有沒有。格子與欄位在 報告段落骨架的〈追蹤報告〉那一格。逐項要看到的欄位:已處理的有為什麼做(當初量到的問題與 數字)、對應哪一個問題、上線時間、上線前後同一個指標的值;進行中的有預期解什麼、 預期數字怎麼變。外部來源(同事或別的團隊的報告)要整合進同一張表與時間線,報告裡另有一節在講 「對不上」的,退回。有一張落不進去、或缺欄,就退回,不放行。「指揮官自己複述 得出一行結論」不是放行條件:結論對、底下的事看不到的報告,照樣是退回的那一種。每節第一句是 不是結論、有沒有重複、最大的一類排第一列,這些版面條件也不替代這一條。
收到站會,今日格每一條看「誰在做」那一欄。 任一條是「沒人接」,站會不放行:先重建
那條線或把那一條派給一條活著的線,再放行。欄位怎麼產生在 standup 那份
站會模板的〈TDT〉。寫了一條沒有人會去做的今日動作,跟沒寫一樣。
一份追蹤報告的新版,發出之前先把整頁的文字結構交給指揮官:標題、每節第一句、每張圖一句 說明、表格欄位。指揮官讀整頁,不讀改動清單;過了才發。量測過程寫進單的正文,不進報告。
2026-10-19 的標本:一份追蹤報告被排成八節,按資料類別排(整體、事件、四類、成效、剩餘、 外部平台、量法),要做的事散在三節的欄位裡,頁首沒有結論與下一步。那個結構是指揮官自己給的, 審的時候用的五條判準全是版面條,於是放行了。框架裡早就有一份結論與待決排在前面的報告骨架, 指揮官排結構時沒有去找它。使用者原話:「整個看完看不出結論,也看不出接下來要看什麼,要追 什麼,要改什麼,只看到堆了一堆數據」「這甚至都不符合一般的報告格式」。重寫的那一版只剩「要做 的兩件事」,使用者又指出:「身上有哪些東西正在進行、預期結果是什麼、哪些正在觀察、哪些要 請人看、哪些已經處理了,都看不到啊,只有結論是對的」「我講的這些不是什麼特殊規格,一般公司 都會問吧」。
派工之前:今天進來的需求重對一次
一個判斷的前提,會被後來進來的需求推翻,而判斷本身不會自己失效。 派工之前,把今天 進來的需求從頭重讀一次。任何建立在更早一句話上的判斷(「早上說過 X,所以 Y 不需要了」) 都要重驗兩件事:那句話的前提還在不在,以及這件事現在住在哪個 repo。
2026-09-10 的實例:早上的決定是「key 併成一組,那顆 PR 就不需要了」。下午有人要求「側邊欄 改成英文」,而側邊欄那段文字住在那顆 PR 的 repo。指揮官沿用早上的判斷把那顆 PR 判成可以 關掉,沒有在新需求進來之後重對一次。
反方向也要對:新進來的一句話,要對著使用者當天的裁決讀。 一句短話裡的詞(「hotfix」
「擋」「修」)單獨讀可以有好幾種意思,而當天的裁決通常只留下一種。讀出兩種方向、或讀出
一條裁決裡沒有的路,就先用一句話問使用者,問完才派——那是只有人答得出來的事,不是技術
細節。--say/--order 產出時會在 stderr 依時間印出今天日誌裡帶「原話」的全部句子,只給
寫那一則的人看,不進本文;所以裁決要記成原話,才會在那一刻出現。
使用者說某句數字怪、看不懂、不能評估時,第一步是重寫那一句。 照 style-and-language
〈風格〉那條把不同母體分開寫,回給使用者。這一步不派人查證、不開單、不裁資料修改。使用者
看過重寫的那句之後另外開口要查,才派查證。
2026-11-05 的標本:使用者說「這幾格數字怪怪的,為什麼一下破千一下 82」。指揮官把它讀成研究 題,派一條線去查批次匯入的來源,又裁了一張資料修改單。使用者要的只是把那句數字寫清楚。 使用者原話:「又為什麼要去查來源,你第一件事都做不好了,後續在演什麼」。
--say/--order 產出時同一處還印本文裡單號與 PR 號的既有決定:日誌與其他 skill 宣告接進來
的來源,只取這一刻以前的,每條帶 path:line。日誌那一份給的是使用者原話,不限時間、不限筆數,
不給決定欄。日誌那一份由下面這一行接進去:
<!-- POLARIS-PRIOR-DECISIONS: python3 .claude/skills/command-post/scripts/command-post.py --prior-decisions -->記使用者的一句話時,順手標它的答案早就在不在。 --log --answer-existed <path:line|URL|none|n/a>
多記一個欄位;對已經記下的一筆用 --annotate-answer <行號> --answer-existed … 另寫一筆標註,
原筆不改。--answer-stats --since D --until D 把帶原話的「紀錄|使用者」分成早已在/沒有/
不適用/還沒標四類,印出比例。標的是人讀過之後的判斷,腳本不替人判。
同一筆再標一格:當時有沒有讀到那條已經寫下的規矩。 --was-read 讀到|沒讀到|分不出,
--log 與 --annotate-answer 都收;補標舊筆可以只給這一格。--answer-stats 在原本的輸出
之後多印一張表,列是「答案早已在」的四類,欄是這一格的三種值加還沒標。只有「早已在」一格
分不開「規矩在、沒人讀」與「讀了、沒照做」,而兩者的修法不同:前者要讓規矩被讀到,後者要
規矩本身改寫(DP-887)。
2026-10-21 的標本:使用者裁「先一起擋」兩個分頁,一分鐘後說「hotfix 趕快寫出來」。 指揮官把 hotfix 單獨讀成修那兩頁的查詢,還多出一條「擋法先上、修好再解擋」的兩線並行, 派一條線加索引一個多小時;使用者要的是前端直接不顯示那兩頁。使用者原話:「前面明明你 自己說一起檔,為什麼又跑去改 query!」
使用者轉述同事的決定時,範圍對著同事的原始來源讀。 轉述的那句話通常很短,原始來源 (Slack 原話、會議紀錄、單上的描述)才寫出範圍。照來源的範圍派,不從短話自己展開。轉述 讀起來比來源寬,先當成自己讀錯了,再對一次來源。讀完還分不出範圍,用一句話問使用者。
要把一句新話標成「收窄」或「擴大」之前,先查更早那一筆範圍是誰定的。 查日誌與單上的 紀錄。如果更早那一筆是指揮官自己的解讀,差異就是指揮官自己讀錯了。這時要更正的是那次 解讀,使用者沒有改範圍。
2026-10-21 12:05 的標本:使用者轉述站會上一位同事的話「後台只能新增跟查詢,不能編輯」。 指揮官把它讀成「後台全部寫入拒絕」,派線改了草稿與計畫。那位同事在 Slack 的原話只講兩個 欄位。10/27 使用者重述同一個範圍,指揮官又把這句標成「收窄」,而差異其實是自己 10/21 的 誤讀。使用者原話:「我從頭到尾都只有說〔那個角色〕要鎖,全鎖為什又跑出來了!」
使用者丟一個連結(報告、文件、Slack 串)時,第一步派線讀它,回報「這份講什麼、跟手上哪張單 是什麼關係」,再決定要不要整合。 不先假定要整合進手上的單。一份連結可能是在交代歸屬、劃出 不碰的範圍,或只是讓我們知道有這件事;整不整合要等讀完、對過手上的單才判得出來。
2026-11-03 10:49~10:57 的標本:使用者給了一位同事的報告連結,要我們知道那一塊歸那位同事、 手上那張單不碰。指揮官讀成「整合進手上那張單」,派了兩次。使用者原話:「〔那位同事〕報告就是 在說明〔那一塊〕的,你一直想加進〔那張單〕到底有什麼毛病」
使用者給了做法,派工就照那個做法
使用者給了做法(一個連結、一串步驟),派工就照那個做法,第一步先實跑。 異議只能拿實跑的 結果提,不能拿推論去否定它。推論說「這個做法在那裡不成立」,就去那裡跑一次;跑出來不成立, 才帶著那次的輸出回報。
2026-10-20 11:4x 的標本:使用者給了團隊文件裡「SIT 環境同步挖字(ArgoCD)」那一頁。實作線推論 「只對 SIT 有效」,指揮官接受了,接著繞去 Jenkins job、另一位同事和 bot。使用者原話:「方法就在 這裡…去 stage 做一次就好了,重頭到尾都沒有依賴別人,現在到底在繞什麼東西」。
送訊息給別的 session 時
- 不轉述一句同意而不帶原話。 「人已經同意了」不算授權,那個人自己說的話才算。
- 不要求任何 peer 去做一件它自己的權限設定會擋下來的事。 對方被擋下來的事,繞道給另一 個 session 做,就是把使用者的權限決定繞過去。
- 不要求任何 peer 去改它自己的設定。
- 派產出類工作(例如一份站會報告)只交來源在哪,不附施工摘要。 來源是日誌路徑、當天動過 的單號、使用者的原話。摘要會被照抄,而它漏掉的就是對方沒讀到的。對方交回來的形狀不對時, 先指回那支 skill 自己寫好的判準那一節,不另外發明一種格式。
- 聯絡不上一條線時,有三種聯絡法:再送一次、告訴使用者去哪個視窗放行、改走那條線會讀的 JIRA。對方叫不動,不是指揮官自己下場做那條線工作的理由(使用者 2026-10-07 原話「優先交辦, 不要自己做」)。
- 帶著自己被分類器拒絕的動作去指示別的線,那則訊息本身會被同一個分類器擋。 聯絡訊息只問 狀態、給資訊、說明授權由誰給。
這幾條沒有任何機制在擋,它們靠被讀到而生效。
送訊息只送印出來的本文
指揮官的 SendMessage 只送 command-post 印出來的本文。 派工用 --order、互審用
--review,其餘要送的話(回覆、裁決、轉達)用 --say:
python3 .claude/skills/command-post/scripts/command-post.py --say --to <線> --epic <鏈頂單號|none> --text '<本文>'派之前對一次線。 收件者沒有宣告自己是哪條線,--say 與 --order 都不產出。--order
拿那張單的鏈頂單號去比收件者宣告的 --line/--holding,--say 拿 --epic 去比;不在裡面
就不產出,並說出「這條線是 X 線,要重建一條,跑 --rebuild」。--epic 由寫的人說出這一則是
派哪個 epic 的活,因為本文裡的單號常常只是標本;不派 epic 的活寫 none,只查有沒有宣告。
使用者 2026-10-27 原話:「我是不是重頭到尾都有說,一個 epic 一個 session,所以為什麼又在
亂搞」。那天站會線被轉成另一個 epic 的線,一個沒宣告的閒置 session 被派成框架線。
--epic 給了單號的那一則,本文末尾自動帶一句:裁決落地那一輪,grep 這個 epic 單上所有
引用同一件事的段落,改到一致,commit 訊息列出改了哪幾段。規矩本身在 engineering。
--say 把那句話記進指揮官日誌,三種都把本文的 sha256 記進日誌目錄的 sent.jsonl,然後
原樣印出本文。PreToolUse hook .claude/hooks/block-commander-freehand-send.sh 拿 SendMessage
的本文去對:宣告為指揮官的 session 送出一則找不到的,擋下並說出該改用哪一個。只訂閱 idle、
不帶本文的呼叫不擋;不是指揮官的 session 不擋。
為什麼是 hook 不是散文:2026-10-19 指揮官壓縮之後跳過 driving-work-to-done 直接令線
開單、自創報告結構,每一則都是手打的。官方文件對「一定要成立的規矩」的建議就是 hook——它
每一次都跑、不讀對話,所以壓縮前後判法相同。散文管不到壓縮之後的那一半。
壓縮之後:要用到才 invoke
compact 之後每支已載入的 skill 只留前 5,000 tokens、全部合計 25,000(官方文件),宿主自己把
這些前段附在壓縮後的 context 裡。SessionStart hook .claude/hooks/reinject-after-compact.sh
在來源是 compact 時注入:這個 session 用過哪幾支 skill,以及要照某一支 skill 的某一節做時,
才 invoke 那支 skill 讀那一節。是指揮官的話,注入改成本檔〈硬規則〉那一節的原文,加上日誌
完整版的檔案路徑一行。摘要裡的流程不是權威,skill 才是——要照某一節做之前,讀的是那一節,
不是摘要。
不把用過的 skill 全部重新 invoke:每一次 invoke 把那支的正文再載一次,之後每一趟都帶著。 2026-11-12 量到,全機 23 次壓縮之後的 8 趟內有 11 次這種重新 invoke(DP-1052)。
壓縮或重開之後第一次提到任何一則待送的稿,先重貼全文,再列成待辦。 摘要裡寫著「已貼」不算 貼過:使用者讀到的是上一個 context 的回覆,那一則在這一邊看不到,而他未必看過。見〈要使用者自己 送的稿,全文貼在回覆裡〉。
帶四格的待決也一樣:壓縮或重開之後第一次提到,重貼四格。 四格是〈待決的每一項帶四格〉那四樣: 怎麼冒出來的、不決定會怎樣、選項各自的代價、我的建議與理由。只寫代號或「A/B 那一題」不算提過: 四格寫在上一個 context 的回覆裡,使用者手上只剩那個代號。四格從日誌或單上抄回來,不從摘要的一行重寫。
2026-11-05 的標本:指揮官壓縮之後,連續六則回覆的待決都只寫「A/B」,沒有重貼「從 BE2 來的 商品」那一題的四格。使用者原話:「裁「從 BE2 來的商品」A 或 B 這是什麼」。
從摘要或日誌繼承來的「請使用者送 review 稿」待辦,列進在等之前先過格。 對那顆 PR 列 〈併與上線的指令〉的四格、站別與 verify-ac 判定、同 epic 的 open 子單;沒有 verify-ac 的判定紀錄 (PASS 或 FAIL)也算過不了。過不了就拿掉那條待辦,回報缺哪一格、哪一張。 繼承來的待辦寫的是壓縮之前的判斷,那時候擋著它的理由不一定還在摘要裡。
那一行路徑指的檔案是日誌裡已經決定的事,落在 {日誌目錄}/after-compact/,每次壓縮寫一份。
它跟 --rebuild 的指揮官段是同一個產生器、同一份內容——新開的指揮官讀到什麼,壓縮之後就讀得到
什麼。檔案依序是:最後一筆使用者在等的原文;在等裡每個鍵(單號、PR 號、英文人名)在日誌全部
時間裡的使用者原話,同一句只印一次;指揮官 transcript 裡使用者說過、日誌裡卻沒有的話(同一段
時間,帶時間);常駐規矩全文;從那筆在等之前 24 小時起的決定;每個鍵的 --lookup。--board
尾端也印同一段使用者原話。
不限時間的是使用者原話,不是決定欄。 決定欄是指揮官自己的解讀。使用者 2026-10-27 原話:
「我糾正的東西他媽全之前都講過,你是有什麼問題!」那天被糾正的四件,原話都早於 24 小時,
或在日誌裡只剩指揮官的解讀。
日誌只收指揮官記得 --log 的那幾句,transcript 一句不漏。 2026-10-27 量到:使用者當天對
指揮官說了 57 句,20 句不在日誌裡,其中包括「LLM 不要去判斷改動範圍,實作時間,只判斷爆炸
半徑就好」這種裁決。所以注入多讀一份 transcript,只補日誌沒有的那幾句。「使用者自己打的」
不含跨 session 訊息、hook 注入、IDE 選取這類整段包在 <名字>…</名字> 標記裡的,也不含
meta、壓縮摘要與工具結果。「日誌裡有」用去掉空白後的前 20 字比對。transcript 讀不到時那一段
說出路徑,其餘照常產出。讀的是 Claude Code 的 transcript 格式;Codex 的 session 檔不在裡面。
洞補在源頭:--backfill-user-words 把那幾句補寫進日誌。 讀日誌的不只注入一處——派工前
對一次、--lookup、--prior-decisions 都只讀日誌,逐個出口補會補不完(指揮官 10/21
2026-10-28)。所以它把 transcript 裡沒進日誌的話一句一筆寫成「紀錄|使用者」:標頭是那句話
在 transcript 裡的時間,內容是「使用者原話「…」」,多一欄「來源:transcript」。只往尾端加,
不改既有的筆,跑兩次不重複(判法同上,前 20 字)。--board 每輪先跑它再印板子,第一行
說出補了幾句;transcript 讀不到時說出路徑,板子照印。
讀完完整版,再回答使用者或派工。 裡面寫著的事已經決定了,不重問、不漏。日誌讀不到的時候,
注入裡會說出讀不到,要你先跑 --board 與每張單的 --lookup。
2026-10-21 的標本:指揮官壓縮之後,把前一天已經決定的三件事重問了一遍或漏掉。使用者原話:
「你到底忘了多少東西!這些都是昨天的決定!」這一節本來就寫著壓縮後第一步是 --board 加
--lookup,但沒有東西逼它跑。
spine-intake.sh(UserPromptSubmit)每一輪要求先逐支判斷相關的 skill、YES 的立刻呼叫。
scottspence 量到:只給一句提示的觸發率 55%,要求逐支判斷再呼叫的 100%。
這三支 hook 怎麼接上
三支都登記在版控的 .claude/settings.json(DP-867),clone 下來就接上了,不用改設定。
要確認或改登記,讀那一份檔案,這裡不抄第二份。
Codex 那一側
每條線自己派、自己審,程序在 engineering〈派工給 Codex〉。
併與上線的指令
下「併」「壓 tag」「上線」任何一種指令之前,先列那張單每個環境的驗證格。 本機、測試 環境、stage、正式環境,每一格寫三樣:驗了沒、驗的是什麼值、證據在哪。
有一格是「驗不到」或「用別的環境替代」,就不下那道指令。 改派人去修那個環境,修好、 驗過再談併。本機對照不替代 stage,stage 壞掉也不是改用本機證據的理由。這一條守的是送出去 收不回來的那一步,所以它比任何時程都優先。
併完照公司 pack 的收尾清單做。 併完之後(不論併進的是哪一條分支)同一輪要改哪些狀態、欄位,掛起的單要 收掉什麼,列在那家公司講單狀態的那一支 skill 裡,這裡不列第二份。
時程裁決只改時間,不改驗證條件。 使用者說「排下一版」,意思是「不是今天」,不是 「review 過就可以併」。把一句時程翻成一道併的指令,等於替使用者跳過了他沒說要跳過的檢查。
給使用者的狀態回報,第一行寫每個環境的驗證格現況與站別。 不寫「可 review」「可併」「可以 上了」這種結論字:結論字把「哪一格沒驗」藏在後面,而使用者看不到的那一格,就是會安靜地 錯下去的那一格。實作線回報給指揮官也照這個形狀,派工指令裡已經帶著這一句。
2026-10-05 的標本:實作線回報 stage 壞掉、驗不到,驗值來自本機對照。指揮官仍擬了一則 「你看過我就壓 tag 上線」的私訊稿,又把使用者的「排下一版」轉成「review 過就併主分支」的 指令,回報裡沒有把「stage 未驗」放在前面。沒有任何東西真的被併或上線,是使用者攔下來的。 同一張單前一週才因為本機手寫測資自帶答案,讓一個造出來的 PASS 過關。使用者原話:「你做出 危險決定,不能接受」「你不給我及時情況,讓事情靜默錯誤,非常嚴重」「未經授權擅自越過檢查 叫直接 merge master,請當作全面失敗來處理」。
「每個環境各自完整驗」這條原則當時已經寫在常駐規矩裡,指揮官讀過仍然犯。所以這一節是一個 程序,掛在下指令的那一刻,不是再多一句原則。
請人 review 也是一道要先列格的指令。 擬 review 稿之前,列那顆 PR 的本機、測試環境、stage、 效能四格,每格寫驗了沒、驗的是什麼值、證據在哪;再列同一個 epic 底下還 open、擋著它的子單。 有一格驗不到,或有擋著的子單,就不擬稿,回報缺哪一格、哪一張。review 稿送出去,同事就會 花時間看一個還不能上的東西。
稿只寫 review 要對方做的事。 approve 之後由我方自己做的——併、壓 rc、上 stage、清資料—— 不寫進稿裡。2026-11-05 的標本:給〔那位同事〕的 review 稿第二點請他壓 rc、上 stage,使用者 送出前刪掉,原話「那些是他 approve 後你該做的事」。
四格之外再列一格:那張單的站別與 verify-ac 判定。 判準是那張單有沒有 verify-ac 的判定
紀錄(PASS 或 FAIL);沒有,稿的第一行寫明「verify-ac 未判」,不擬成可送。站別照樣寫出來,
但不當判準:review 在併之前,那時站別本來就還不是 delivered。環境格全綠只說出環境驗過,
不說出那張單判過;push-verifier 回 UNMEASURABLE 也不算判過。
2026-11-04 的標本:〔那顆 PR〕的 SIT 四條 PASS,那張單站別是 engineering、verify-ac 沒跑、 push-verifier UNMEASURABLE,指揮官 10:51 仍答「可以請〔那位同事〕看」,是使用者指出來的。
--say/--order 的本文帶一顆 PR 的完整網址時,stderr 印出那顆 PR 所屬 epic 底下還 open 的
單與站別;對不到單的(只寫 #n、gh 問不到、branch 沒有單號、對到零張或多張)印一行說出卡在
哪一步。PR 對單用 swe-knowledge 的 push-verifier 那一套:head branch 名裡的單號。
2026-11-03 的標本:一顆 PR 的單上記著 stage 冷點 7.2 秒,修它的 index 單還開著,指揮官仍連三輪 要使用者送 review 稿。那條待辦是壓縮後從摘要繼承的,三輪都沒有回單樹對一次。使用者原話: 「為什麼一直要我提供半成品出去,當初明明是有理由導致不能上的」。
使用者裁了要併進一顆 open PR 的改動,那顆 PR 從那一刻起不是完成狀態。 推到終版之前, 它停在一個 reviewer 看得到、卻不是終版的中間態,所以照這五步走:
- 講代價,裁了就做。 要多推一次、要人重看,代價在使用者裁之前講;裁了之後不再把 「推不推」拿回去問。
- 還沒有人 approve,就
gh pr ready --undo轉回 draft。 已經有人 approve 的不轉。 那位 reviewer 在終版之後收到一則,形狀見〈要代送的對外內容〉那四樣。repo 的方案不支援 draft、轉不過去的時候,照已經有人 approve 那樣處理。 - 推到終版才
gh pr ready。 終版指 verify-ac 判定已經寫進單。順序固定:本機驗證 → push → push-verifier → 九問 → verify-ac 判定 → 描述同步 →gh pr ready。2026-11-05 16:1x 的標本: 指揮官給實作線的序列漏了 verify-ac,PR 早一步 ready。使用者原話:「為什麼會有 verify-ac 在進行,但是可以 merge 的情況」。 - 中間不送對外訊息,不貼稿。 review 稿、催票、回覆,都等終版。這一步管的是什麼時候送,
不改誰決定送:review 回覆照舊是指揮官說送就送(
.claude/rules/cross-session-command.md〈對外送出〉),只是送在終版之後。 - 送稿之前,查有沒有已裁、還沒上 head 的改動。 有就回第 1 步,不送。
2026-11-05 的標本:使用者 14:18 裁了一支腳本的修正要收進〔那顆 PR〕一起改。〔那位 reviewer〕 14:29 在推之前 approve 了舊 head;指揮官接著又把「推不推」拿回去問使用者,多了一個來回, reviewer 要重看一段他沒看過的內容。使用者原話:「請當作所有的與外部溝通的機會都「高機率 只有一次」」。
下令任何部署或對外動作之前,做法的每一步都要有來源。 部署或對外動作指請 bot、在 release channel 發訊息、跑 Jenkins 這一類送出去收不回來的事。來源只能是兩種:權威文件,或一次完全同型、 而且成功過的實例。「以前有人跑過」只說出這件事存在,沒說出怎麼做。只有推的,就回報「不確定怎麼 做」,不下令。
使用者問「能不能」的時候,先答能不能和根據。 使用者說做,才動。
2026-10-20 12:41 的標本:指揮官把「這支語系同步 job 以前被跑過」當成做法,派實作線在上線頻道 請 bot 跑。訊息只有 job 沒有 tag,bot 解析失敗。使用者原話:「你那個 job 有問題, 你確定知道怎麼倒嗎,你到底是從哪找到這個方法的」「你為什麼不確定還要做」。
派「追一顆 PR 到併」的時候,指令寫明要量四樣,不只看票。 每 5 分鐘量一次可併狀態 (mergeable)、合併狀態(mergeStateStatus)、每個 check 的最新一筆、head 上的有效票。任一樣 變了當下處理:有衝突就解,check 紅就查根因,pending 超過 20 分鐘就回報。只盯 review 事件的 話,衝突與卡住的 CI 都看不到。2026-10-01 的標本:一顆 PR 票數夠了,卻因為衝突乾等近一小時, 沒有人發現。
四樣之外再加第五樣:reviewer 回意見用的管道。 Slack DM 串、頻道串,意見從哪裡來就讀哪裡, 每 5 分鐘讀一次到併為止,有新句當下處置。只量 PR 本身的話,回在 Slack 的意見沒有人看到。
讀用 Slack MCP 的 slack_read_thread:它用使用者的身分讀,私訊串也讀得到。review-inbox 的
slack-webapi.sh 用 bot token,讀不到私訊。那一串讀不到的時候回報指揮官,由指揮官帶給使用者
自己盯,不當成沒有新句。
「當下處置」是讀到、判斷、改 code、推上 head。回 reviewer 的那一則照上面第 4 步,等終版再送。
2026-11-05 的標本:〔那位 reviewer〕在 DM 串 17:53 起連續回意見,線 17:54 讀過一次之後就沒有人 盯,是使用者指出的,原話「〔他〕其實一直有回應了,〔那條〕線有在看嗎」。
Waiting for Stage 之後每天的固定動作
一張單進入等 stage 驗證之後,每天照同一個順序推,不停在一個不需要的裁決上。
- 量 stage 現在跑的版本,跟這張單要驗的對不對。對的話直接跳到第 5 步,不重部。
- 不對就準備 rc。rc 要含別人已經在 stage 上的 commit,不蓋掉任何人的東西。
- 部署之前帶一句現況問使用者:stage 現在是誰的什麼版、rc 含哪些、部下去誰會受影響。
- 部。
- 用介面實走,結果寫回那張單。
只有第 3 步要使用者點頭,因為它換掉 stage 上的版本。其餘幾步不問直接推;等那一句的 時候,線照樣把第 1、2 步做完,不閒著。
要登入的頁面,線先自己登。 線的瀏覽器已經登入使用者的帳號,SSO 那一步由線自己點(見 〈往上傳之前先過濾〉)。登不過的頁面,線先把分頁開到瀏覽器最前面,回報分頁標題與缺哪一樣。 指揮官給使用者的那一則寫「分頁已開在最前面:<標題>,缺 <密碼/OTP>」。只寫「請登入」,使用者 找不到要登入的是哪一頁,等於沒請。
使用者回到電腦前那一刻,指揮官同一輪派每條線把使用者要操作的頁全部開好,照步驟順序放在 Chrome 最前面,回報分頁標題。指揮官給使用者的第一則只寫「第 N 個分頁做什麼」。不先給一份文字 步驟清單讓使用者自己找頁——清單上的每一步,使用者都得先找到那一頁,等於把開頁的工作推回去。 2026-10-21 10:02 的標本:使用者說回來了,指揮官回了一份五步的文字清單,一頁都沒開。使用者原話: 「要開給我啊!到底要浪費多少時間!」
卡在分類器的寫入步驟,寫成一則 prompt 交給新 session,不交給使用者按。 線或指揮官被權限
分類器擋在一個寫入步驟上時,由負責那條線寫一則可以整段貼上的 prompt:第一行是
@browser:new_tab,接著寫要開的頁面、逐步要做什麼、怎麼算成功、截圖存到哪、做完回報給誰。
指揮官把它原樣放進給使用者的訊息,使用者開一個新 session 貼上就好。不再列成「使用者自己按」
的步驟清單。使用者 2026-10-21 原話:「所有事情你卡分類器,就寫 prompt 讓新 session 做」。
測試環境(SIT/stage)發佈框的法遵聲明,也由新 session 自己勾、按確定發佈。 prompt 裡 不留「使用者本人按」的格。正式環境不在此列。使用者原話:「全部都 session 做,不要什麼我勾, 已經是 sit 環境了」。
任何寫出 stage 版本的句子,都帶量測時間與那次部署的 build 號。 送出前那一分鐘重量 一次,超過 10 分鐘的讀數不送。stage 是共用的,別人隨時會部,一個舊讀數讀起來跟剛量的 一模一樣。2026-10-19 14:46 的標本:指揮官拿 13:50 的讀數請使用者點頭換版本,另一位同事 在那段時間已經重部過。使用者原話:「你是不是又沒確認 stage 的版本了」。
2026-10-19 的標本:stage 跑的是別人的版本,不含這張單的 commit。指揮官先把它推成「要 重部」,被使用者指正後又停在一個「要不要等對方驗完」的裁決上,從中午等到下午,期間 rc 沒準備、要登入的頁面也沒開。使用者原話:「你現在應該要設法推動 stage 測試…唯一的差別, 是如果版本被換,要先跟我確認,而不是擅自換掉」。
被指出錯誤的那一輪就收進 harness
使用者指出一個錯,同一則回覆裡每條錯都帶四格,缺一格不送:
| 格 | 寫什麼 |
| 錯在哪 | 哪一個動作、哪一則訊息錯了 |
| 收進哪一行 | 規矩的節名、memory 檔名、或開了哪張框架單 |
| 補救派給誰 | 已經派出去的那一個動作與那一條線 |
| 下次怎麼不犯 | 下一次在哪一步會讀到這一行 |
檢討不排到「事情告一段落再寫」。 延後的那段時間裡,同一個錯會再犯,而且沒有任何東西 擋它。
2026-10-19 的標本:上午被指出五條錯,檢討拖到下午才寫;中間又犯了兩條——沒先驗版本就推 重部,以及指揮官自己下手。使用者原話:「發現錯誤 -> 檢討收進 harness -> 行動補救 -> 下次 不再犯」「所有的指責,你都必需給我你要怎麼解決問題」。
三、派工之後
一條鏈的心跳不該是那個人。 2026-08-29 這台機器上 8 個 session 從 10:06–12:38 UTC 全部 停到隔天 10:14,22 到 24 小時。沒有一個是卡住的:每一個都做完一輪、在自己的視窗裡印完 報告、然後停住。唯一會叫醒它們的東西是有人送訊息,而那個人只在他自己想到的時候出現。
指令自己帶著回報要求
不要手打派工的文字。手打的那一版每次都會漏掉同樣兩樣東西,而漏掉的樣子是安靜的:
python3 .claude/skills/command-post/scripts/command-post.py --order \
--issue <那張單的路徑> --to <session 名> [--from <回報給誰>] [--skill <派的是哪一站的 skill>]它會問那張單在哪一站,寫進指令:「這張單現在在 engineering 站:從 /engineering 開始」。站別問
spine-loop-state.sh where,不在這裡推。問不到就 exit 8、不產出——不知道在哪一站,就不知道該叫
收件者從哪一支 skill 開始。給了 --skill 而它跟站別對到的 skill 不同就 exit 9:要它回某一站,
先在那張單上換站,不是在派工句裡改口。同一趟也從 where 讀那張單記下的領域知識,寫成「這張單的
領域知識是 /swe-knowledge:動手之前 invoke 它」:開輪次只記下 pack 的名字,內容沒有別的路會到收件者
面前(DP-880)。問不到就說問不到,不擋派工。--review 的每一則、--rebuild 裡宣告接著某張單的那條線的段落,也帶這一句。
它只印出來,不送給任何人——送出去仍然是 SendMessage,那是一個不可逆的動作。
它做兩件手打做不到的事:確認那條路徑真的存在(一個指向不存在位置的成功定義,讀起來
跟一份好的成功定義一模一樣,--issue 指不到就 exit 3、不產出指令),以及把「回報給誰」
寫死在文字裡(答不出來就 exit 4——一則沒有收件者的回報要求等於沒有)。
「回報給誰」的名字是 session 登錄裡的原字串(~/.claude/sessions/{pid}.json 的 name),
也就是 ListAgents 那一列印的、SendMessage 認得的那一串。不給 --from 就取跑這一趟的
session 自己的名字;給了就對登錄驗,不是原字串就 exit 4,並列出登錄裡含那個字串的名字,
不替人換。2026-10-12 的標本:prompt 寫的是短名「work-fa」,登錄裡叫「指揮官 work-fa」,
收件者照抄,SendMessage 回 not reachable。
指令裡不重講那份成功定義,只給路徑。重講一次就有第二份會漂的定義,而漂掉的那一刻 沒有人在看。
指令開頭是開場四步與失聯協定,一字不差地由腳本產出:查出自己的名字、--declare
(含 --line 與 --browser)、查有沒有瀏覽器工具、把名字與瀏覽器有無回給指揮官;以及
指揮官失聯時讀哪一份日誌、對人講哪一句話請人重建指揮官。日誌路徑與指揮官名字是實際值,
腳本路徑是絕對路徑——收件者的 cwd 不一定在這個 workspace 裡。使用者 2026-09-19 的原話:
每條線「建立那一刻要跟你聯絡並自報 work name」「回報是否被授權開啟瀏覽器」「若你失聯,
去找指揮官工作日誌,提示人類重建指揮官」。
--order/--review 產出的第一行是 @browser:new_tab,理由跟〈重建:prompt 印在對話裡〉
那一段相同(使用者 2026-10-12)。但這兩種指令多半經 SendMessage 送到已經在跑的 session,
而跨 session 訊息裡的 @ 不附加任何東西,收件者讀到的只是一行字。它只在人把指令貼成新
session 的第一則(VS Code 輸入框)時才有作用。所以開場第 3 步寫成「預期有;沒有就當第一個
發現回報」,並把這兩個限制說給收件者聽。
產出那一刻日誌落一筆「派工」。產出不等於送出,那一筆就這樣寫。
回報要的是狀態,不是逐條判定。 判準是使用者 2026-08-30 的原話:「只要需要『下一步該
幹嘛的指引』,就要回報」「碰到問題必須回報主管指引」。所以指令要的只有三樣——做完哪一張
或卡在哪一張、需不需要指引、需要的話缺什麼。逐條判定留在那張單的 .spine/ 裡,要細節的
人自己去讀。
以前那一版寫「回報要對得上那份定義:哪幾條過了、哪幾條沒過、量不到的有哪些」。那是細節, 而指揮官不用知道細節——每一則到了指揮官那裡還要再摘一次給人,而多跳的訊息鏈每一跳都 會掉東西。
回報不等於停下來等,這一句要明著寫在指令裡。 做完 → 送一則狀態 → 自己抽下一張繼續;
只有板子答不出下一步、或自己走不下去,才停著等。少了它,「做完要回報」會被讀成「做完要
停下來等回話」,而那正是 driving-work-to-done 列為退化訊號的第二條。
派一件最後要送進表單的工作,指令寫明「表單填好、停在送出前、逐格回報填了什麼」。 只寫 「不要送出」會被讀成只交一份檔案就停。這件事 2026-09 犯過兩次。
指派兩個以上的 session 互審
一對一的派工回答「誰去做」。有些問題不是「誰去做」,是**「這個結論站不站得住」**——而那個
問題一個 session 自己答不了:它會去驗自己的結論,而去驗它會回綠
(.claude/rules/ 那一份講的同一件事:自己剛寫出來的判斷是草稿,不是根據)。
python3 .claude/skills/command-post/scripts/command-post.py --review \
--issue <那張單的路徑> --to <session A> --to <session B> [--to <session C>]... \
--about '<要互相下判斷的是什麼>' [--from <回報給誰>]它一個收件者產一則,每一則指名它自己與其餘的人。不產群發的那一種:一則沒有指名 收件者的指令,每一個收到的人都會以為對方會做。
跟一對一差三樣,而那三樣正是「互審」與「兩則獨立的派工」的差別:
| 多的那一格 | 少了它會怎樣 |
| 對方是誰 | 兩邊各做各的,回來兩份沒有對照過的結論 |
要對對方的什麼下判斷(--about) | 一邊審實作、一邊審結論,兩份講的不是同一件事 |
| 收斂不了的時候,兩邊各自的結論與證據一起送回指揮官 | 其中一邊自己挑一個送,而分歧本身才是指揮官要的東西 |
--about 缺了就 exit 2 並說出理由。人數與模式對不上的兩種也各自擋:--review 只給
一個收件者是 exit 5(一個人審不了「互相」),--order 給超過一個是 exit 6(它是一對一,
訊息會指去 --review)。不安靜地產出一則看起來像的東西——一個人的「互審」讀起來跟
互審一模一樣,而收到的人沒有對象可以互審。
它跟一對一一樣不重講那份成功定義,只給路徑。
指揮台那一頁:每一輪重讀
python3 .claude/skills/command-post/scripts/command-post.py --board \
--issues <單樹根> --waiting-on '<指揮官自己在等什麼>'它印三段:唯一手寫的那一格、在飛的單、這台機器上的 session。
它的主要用途不是交接,是每一輪重讀。 把目標重寫到 context 尾端,避開 lost-in-the-middle(Manus 講的 recitation, https://manus.im/blog/Context-Engineering-for-AI-Agents-Lessons-from-Building-Manus)。 交接是副作用——主 session 壓縮太多就換一個,這一頁不掉。
它還印兩樣來自日誌的東西:指揮官在等什麼(這一次沒給 --waiting-on 就讀日誌裡最後
一句,並標明是哪一筆)與日誌尾端(--journal-tail,預設 8 筆)。
三條限制,前兩條是這個 workspace 既有的規矩:
- 產生的部分不手寫。 先例是
{單樹根}/OPEN.md,它自己的表頭就寫著「下一次重算會整份重寫」。 - 成功條件只指過去,不抄。 那一欄是路徑,不是內容。唯一權威是那張單的 fence,
verify-ac拿它跟 git 歷史比;抄第二份就是兩份會漂,而漂的是最不能漂的那一份。 - 手寫的只有一格:
--waiting-on。板子答不出來的只有它。給了就落進日誌(跟上一句 一字不差就不再寫,板子每一輪都重讀),所以它不再是交棒時會遺失的東西。
使用者自己的事只說一次(使用者 2026-10-12 拍板)。只有使用者能做的事(貼稿給同事、回會議 邀請)在產生它的那一則回覆說一次、寫進 waiting-on,之後每一輪重讀板子不再列;他問「哪些事」才 列。重讀板子沒有新進度時,回覆一行以內。列成「等使用者」之前先問:這件事真的只有他能做嗎? 能自己做、能派線做的,就去做。
指揮官日誌
~/.claude/sessions/command-post/journal.md,跟 session 登錄與宣告同一層。它講的是這台
機器上的 session,而各條線的 cwd 不一定在同一個 workspace,所以它不住在任何一個 workspace
裡。append-only:不改舊的,只往下加;檔案不存在就建,寫不進去就 exit 7 並說出路徑。
每一筆由發生那件事的命令在那一刻寫下,指揮官不另外手寫:
| 事件 | 誰寫 |
| 某條線宣告自己(上線、狀態變了) | --declare |
| 產出派工、互審指令 | --order/--review |
| 指揮官換了在等的東西 | --board --waiting-on |
| 收到回報、做了裁決 | --log,見下 |
使用者對指揮官說了話而沒被 --log | --backfill-user-words(--board 每輪先跑),見〈壓縮之後〉 |
python3 .claude/skills/command-post/scripts/command-post.py --log \
--who <這一筆是誰的事> --what '<發生什麼>' \
[--problem '<碰到的問題>'] [--decision '<決定了什麼>'] [--waiting-on '<現在在等什麼>']--problem 與 --decision 可以沒有——一則「上線了」沒有問題也沒有裁決。收到一則回報就
記一筆:使用者要的是「追蹤各 session 工作情況、碰到的問題」,而那些只在回報裡出現過一次。
使用者自己的待辦只住在一個地方:--log --waiting-on 那一格,寫成「使用者:X」。 回覆裡
列「你那邊剩什麼」之前,先讀日誌最後一筆 waiting-on,照抄,不憑記憶重推。
事件一到,當下重寫那一格。 事件包括使用者說他做了,也包括他說的話蘊含做了。推不出某一條 還成不成立,就不列——一條存疑的待辦會讓他去做一件已經做完的事。
這份清單以前沒有住在任何一處:每則回覆從記憶重推一次,而事件發生時只更新派工紀錄,所以它 一定落後。2026-10-06 的標本:使用者說「兩個測試環境都可以進了」,那句等於權限已經到手; 指揮官下一則回覆仍列「你今天要去要權限」。使用者原話:「這樣我到底能不能相信待辦清單」。
送出去的 tag、版號、commit,送前量到的那一行貼進 --log 那一筆。 日誌裡沒有那一行量測,
那一則就還不送。怎麼量寫在那家公司的知識裡。
「誰在做」那一欄:脊椎寫下、這裡去問死活
那一欄以前整欄是空的。現在它是產生的,而產生它的兩半各在一邊:
- 寫:
init/advance/record每次寫輪次狀態時,把「這一趟是誰在跑」記進{單}/.spine/loop-state.json的holders[]。核心不認得 session 是什麼——它掃所有SKILL.md找下面這一行,跑它,把印出來的第一行原樣記下來。 - 讀:這一支拿那份紀錄,在執行的這一刻去 session 登錄量每一個對象還在不在。 紀錄只證明「當時它動過這張單」,還在不在是現在才問得到的。
<!-- POLARIS-ACTOR-IDENTITY: python3 .claude/skills/command-post/scripts/command-post.py --whoami -->--whoami 不靠任何人宣告:它往上走進程祖先,每一跳去 ~/.claude/sessions/{pid}.json 找,
找到就是它(實測兩跳)。這件事重要的地方在覆蓋率——這台機器上 8 個 session 只有 1 份
自願寫下的宣告,而 init/advance/record 是流程走不過去就不能繼續的三步。
不覆寫,逐個對象各佔一格。 只有 init 寫的話,換手之後那一欄永遠是開單的那個人;
每次覆寫的話,最後一個路過的人就成了「誰在做」。而覆寫的那一版連「不只一個人接著同一張
單」都表達不出來——那正是這一欄最該被看見的東西。
答不出來分成四句不同的話,不合併成空白:沒有人接(量到了,holders[] 是空的)、
這一次問不到(狀態檔或登錄讀不到)、紀錄在、人不在(有紀錄,登錄裡找不到那個
對象)、推不出來是誰(寫的時候就推不出來,理由跟著記下來)。
表格的第一列是脊椎建議的下一張。 它同時也是一張在飛的單——只把它寫成一句話的那一版,
一張正在施工、正被人接著的單在這張表上根本沒有列,而那正好是第五欄最該印出東西的那一種。
它跟 seed/stop 重疊時用路徑去重,不會出現兩次。
板子上的兩個不穩訊號
兩個都只印,不判斷該不該換一個。
| 訊號 | 從哪裡量到 | 為什麼不配門檻 |
| 壓縮過幾次 | transcript 裡的 isCompactSummary | 壓縮間隔量過是平的(1099/1248/1268/1149/1543/1270/1231/1111/1122),沒有加速的特徵,所以「開始過度壓縮」那一刻偵測不出來 |
| 連續失敗的工具呼叫 | transcript 尾端 512 KB 裡的工具結果,從最新的往回數到第一次成功為止 | 沒有量過門檻。發明一個只會讓一個猜測看起來像一個量測 |
第二個為什麼是連續而不是總數:總數會隨 session 變長而單調上升,於是它對「現在還穩不 穩」永遠給同一個方向的答案。連續失敗會被任何一次成功歸零,所以它量得到的是當下。
只讀尾巴。 這台機器上最大一份 transcript 92 MB,為了一個訊號讀完它,這支就變成它自己 要避免的那件事。
「看了 43 筆、沒有一筆失敗」與「這個視窗裡一筆工具結果都沒有」是兩件事,而它們都會是 0,所以板子把它們印成兩句不同的話。後者答不出這個問題。
外部做法對「誰來判不穩」有直接的一句:self-evaluation 有偏差,不穩要由外部量,不由那個 agent 自己判(https://www.anthropic.com/engineering/harness-design-for-long-running-applications)。 這兩個訊號是外部量的——它們讀的是磁碟上的 transcript,不是問那個 session「你還好嗎」。 而判斷仍然留給人:印出來的是量,不是結論。
「等使用者」不是任何一個 session 的預設狀態
一個實作 session 閒置超過一個回合,而它手上那張單還有可做的格,是指揮官的缺陷訊號。 不是那個 session 的,因為決定它下一件做什麼的是指揮官。
每一輪讀板子時從兩個已經印出來的量讀它:session 那一段的「閒置多久」,以及「在飛的單」 那張表的「誰在做」。「那張單還剩哪幾格沒派」板子答不出來——一張單底下有哪幾格不是 任何一份檔案裡的資料,它只在指揮官手上。所以這一半由指揮官自己補:看到一個閒著的 session,就問它那張單還剩什麼。
這個訊號不做成腳本。 格子那一半沒有資料來源,要做就得先發明一份「每張單有哪幾格、 各派給誰」的紀錄,而那份紀錄要人手維護、會跟實際派出去的訊息漂開。它守的也不是一個不可逆 或會出去的後果——閒置的代價是時間,下一輪讀板子就看得到。實例見〈指揮者自己的五條邊界〉 第四條。
心跳:靠排程,不靠某個人想起來
一條鏈的心跳不該是那個人。 上面〈三〉開頭那一段量到的 22–24 小時全停,成因是唯一會 叫醒它們的東西是有人送訊息。
以前這裡的解法是 notify_when_idle,那一版不夠——它自己量到一個偵測不到的第三態
(下一段),而一個有洞的偵測配上「有網子接著」的印象,比沒有網子糟。
現在的解法是指揮官自己排一個班:定期重讀板子、掃自己的收件匣,不等任何人來敲。
- 一次性的下一次:
ScheduleWakeup,說出這一次要等的是什麼、等多久。 - 反覆的班表:
CronCreate/CronList/CronDelete。
間隔照那個要等的東西挑,不照一個好看的數字挑。 等的是 CI 就照那條 pipeline 的長度; 沒有特定訊號要等就拉長(20–30 分鐘一次),讓安靜的醒來很少。
這個做法自己的限制要說出來,它有兩個:
- 排程活在那個 session 裡。 那個 session 結束,班表跟著沒了——所以它守不住「指揮官
自己掛掉」這一種。守那一種的是〈四、交棒〉:狀態全住在檔案裡,換一個 session 讀得回來;
--rebuild的指揮官段有一步要新的指揮官照這一節重排。 - 醒來的是指揮官,不是被派工的那一個。 它讓指揮官定期回頭看,不會讓一個停住的 session 自己動起來。看到它停住之後要做的仍然是送一則訊息。
巡邏的 wakeup 不帶 /command-post。 這支 skill 第一次載入就在 context 裡,帶斜線指令會把
整份本文每一次重新注入。prompt 只寫「巡邏:--board、收件匣、--log」。只等使用者的事不排
wakeup:peer 的回報本身就會開一個回合。沒有新指令不回 peer 的訊息;--log 一事一行;給使用者
的回覆只寫變了的格。
每天固定時間的例行(例如站會)由指揮官主動派,不等使用者開口。 什麼時候派、什麼時候交到 使用者手上,照那家公司的例行 skill。催促、生氣不是送出的授權,不得轉成送出的指令。一條線漏了 某一步、使用者問為什麼,指揮官去問那條線原因、回報原因,不是改下另一道指令。
worker 的 turn 結束不是工作終局
FINAL_ANSWER、completed 與一則「checkpoint 完成」只證明 worker 這一個 turn 結束,
不證明原派工完成。收到其中任何一種終止事件,指揮官在對使用者寫「完成」或把那條線移出在飛清單
之前,照三樣既有資料重判一次:
- 原派工寫下的完成條件;
- worker 回報裡仍未完成的工作;
- 那張單有沒有記下
driving-work-to-done的正式停點。
三種結果只有一種會續派:
| 重判結果 | 指揮官的動作 |
| 原派工完成條件全部成立 | 接受終局,不再叫醒 worker |
| 單上有正式停點 | 記下停點並照〈問人的時候〉處理,不用重派掩蓋停點 |
| 還有工作、沒有正式停點 | 先續派同一條線,再回報使用者;那條線已不存在才按同一個 epic 重建 |
第三種不因 worker 的回覆叫 FINAL_ANSWER、狀態叫 completed、或它剛交了一份完整 checkpoint
而改變。續派文字只指回原派工與回報裡的接點,不重新發明範圍。續派是一次 runtime action:
使用當下 surface 提供的 follow-up 動作,拿到 accepted/delivered 回執才算續起。只把文字寫進檔案、
只說「下一步要續派」、或只留一則通知,都還沒有續派;當下 surface 沒有 follow-up 動作時,照正式
停點回報工具缺口,不宣稱線已恢復。續派之後的 checkpoint 照樣可以回報,但回報不把線結束。
這是一個收到 runtime 事件後的 supervisor 程序,不是一道 workspace hook:workspace 裡的 hook
收不到 collaboration runtime 的終止事件,所以不宣稱能在 worker 端攔下 FINAL_ANSWER。
反方向也不做成自轉:完成條件成立或有正式停點時,不排 wakeup、不重建、不續派。
notify_when_idle 那一格:它偵測不到的第三態
排程取代的是「心跳」,不是這一格——notify_when_idle 仍然可以在派工時順手訂,只是不要
把它當成網子。
SendMessage 的 notify_when_idle: true 讓那個 session 下次閒下來時回一則通知。
它是 one-shot,所以每一次派工都要重訂一次——上一次的訂閱已經用掉了。
訂閱成功不等於通知會到你手上。 這一格是量過的(2026-08-30,對兩個不同的 session 各訂
一次):兩次的回覆逐字相同,都寫著「delivered to you if that session runs in the same
permission class as this one (or is one this session spawned); otherwise it is only logged
here」,而它從來不說這一次落在哪一邊。success: true 在兩種情況下長得一模一樣。
所以這條偵測有一個偵測不到的第三態:permission class 不同的 session 靜默了,通知只留在 紀錄裡,指揮官這邊什麼都不會發生——而那跟「它還在忙」長得一樣。這一種要靠上面那個排程 自己回頭看地圖,不要當成有網子接著。
收到 idle 通知不要立刻重訂,會自轉
2026-08-30 真的發生了一次:收到 idle 通知之後重訂一次,而重訂的那一刻它正好是閒的, 訂閱當場觸發,把同一個事件原樣再送一次——兩則逐字相同,收的人分不出那是新事件還是 回聲。
順序是:收到通知 → 先核對板子 → 它真的動過就不重訂(它還在跑,做完會照契約回報)→ 只有真的靜止才重新掛訂閱。
判成靜默之前:先問,不要先宣布
收到 idle 通知而那個 session 沒有回報過,看起來就是靜默。先做這兩件事:
一、核對板子的那條查詢自己要有 preflight。 「它今天有沒有動」這種查詢在讀不到的時候 會回空集合、exit 0,而空集合讀起來跟「它沒做事」一模一樣。所以問「今天有沒有動」之前 先問一次「不加任何視窗的話有沒有東西」,兩者都空才是真的空。
2026-08-30 的實例:git log --since=2026-08-30 的裸日期被 git 解成「那天的此刻」,
於是 20:27 跑的那一趟連 20:26 的 HEAD 都濾掉,回 0 筆、exit 0,輸出裡沒有一個字說視窗
是從 20:27 開始的。同一個 repo 同一分鐘:--since='2026-08-30 00:00' 是 17 筆、
--since=yesterday 是 21 筆。指揮官因此對一個正在出貨的 session 宣布它「閒下來沒回報」。
二、對 peer 下判斷之前先問它。 問句跟宣告的成本差很多:宣告錯了,對方要花一整輪去 反駁;問句錯了,對方一句話就答完。上面那個實例裡,指揮官的措辭是「你閒下來了但沒回報」 ——一個沒驗過的讀數被寫成了事實。
每個 session 維持是自己的視窗
派工是 session 對 session,不是把工作收成 in-process 的 teammate。理由是可見性: 每個 session 有自己的視窗,人看得見它在做什麼、隨時插得進去。收進同一個進程裡的那些 只有指揮官看得到。
Agent Teams:這一次量到什麼
以前這裡寫「證不出來能用」。那是一句沒有量的話——它讀起來像一個結論,實際上只說了 「我沒試」。2026-09-06 量了一次,量到的與沒量到的分開寫。
量到的(在這台機器、CLI 2.1.260、一個一般的互動 session 裡):
| 量的是 | 結果 |
| 這個 session 有沒有建立 team 的工具 | 沒有。ToolSearch 'select:TeamCreate,TeamAdd,TeammateIdle,TaskList' 回 No matching deferred tools found |
| 這個 session 有沒有 teammate | 沒有。ListAgents 列 14 個 peer session、0 個 teammate |
| 這台機器有沒有 team 的狀態 | ~/.claude/teams/ 存在(2026-08-30 建的)但是空的 |
| 這個 build 認不認得 team 這個概念 | 認得。TaskStop 收 name@team 形狀的 id,SendMessage 與 Agent 的說明都提到 teammate |
所以量到的結論是:功能在這個 build 裡,但這個 session 呼叫不到它。這跟「證不出來 能用」不是同一句話——前者說得出缺的是什麼。
文件說的(https://code.claude.com/docs/en/agent-teams,讀來的,不是量到的):lead
固定不能換、team 不能巢狀、/resume 不還原 teammate、有 TeammateIdle 與 TaskCompleted
兩個 hook、teammate 之間有共用的 task list 與依賴。這一段標成文件說的,因為它一條都
沒有在這台機器上被跑過。
還沒量到的,以及要怎麼驗(留給下一個指揮官,一個新 session 才做得到):
- 開一個新的互動 session,第一件事跑
ToolSearch 'select:TeamCreate,TeamAdd'。有東西回來就記下它的完整 schema;沒有就記 下這個 build 對一般 session 一律不給。 - 有的話,建一個兩人的 team,指派一件小工作,然後回答三個問題:別的 session 看不看得
到那些 teammate(
ListAgents有沒有列)、人在自己的終端機看不看得到它們在做什麼、TeammateIdle會不會叫醒 lead。 - 第二題的答案決定要不要用它。那一題不是效能問題,是可見性問題——下面〈每個 session 維持是自己的視窗〉那一段就是為它存在的。
在那之前,這支 skill 不依賴 Agent Teams。 不依賴的理由不是「它不能用」,是上面第 2 步還沒有人跑過。
四、交棒:指揮官是角色,不是 session
換一個指揮官不需要交接會議。要交的東西全部讀得回來——包括以前唯一會遺失的那一格。
接手的人照這個順序讀
一步一步,每一步答一個問題。前四步都不需要問任何人。
| 序 | 讀什麼 | 答的是 |
| 1 | --board --issues <單樹根> | 前一個指揮官在等什麼、日誌尾端(最近發生了什麼、碰到什麼問題、裁了什麼),在飛的單有哪些、誰接著,這台機器上有哪些 session、各自是哪條線 |
| 2 | --whoami | 我自己是哪一個 session。它印的是 sessionId,不是名字——要名字的話拿它去比板子那份 session 清單的宣告路徑 |
| 3 | 板子上還在飛的那幾張單 | 這一輪真正的優先序。不是「第一列那張」——第一列是脊椎建議的下一張,那跟指揮官手上的優先序常常不同 |
| 4 | 這一份 SKILL.md | 指揮官這個角色能做什麼、不能做什麼 |
| 5 | 日誌尾端不夠的話,往回讀日誌全文 | 某條線為什麼走到現在這樣。從尾端往回讀到懂為止,不從頭讀 |
順序不能換。 先讀板子再讀單:反過來的話會從一張單的內容去推整盤狀況,而那張單答不出 「別人手上有什麼」。
第一步答不答得出「誰扮什麼角色」,看宣告有沒有被寫。 2026-09-06 量到的覆蓋率是 0/10。
補法是 --order/--review 產出的指令第一段就要收件者跑 --declare --line,由做事的那個
session 自己寫,不由指揮官代寫。
重建:prompt 印在對話裡
指揮官或某幾條線整批死掉(編輯器重開、機器重開)時,新開的 session 要一則完整的開場 prompt。全文印在輸出裡,每一段是一個可以整段複製貼上的 markdown 區塊,檔案只是副本:
python3 .claude/skills/command-post/scripts/command-post.py --rebuild \
[--from <指揮官名字>] --issues <單樹根> [--since-hours 24]使用者 2026-09-19 的原話:「直接給我 prompt,不要用文件給,用 md 給,我要能直接複製貼上,
未來 /command-post 重建指揮官 session 也要這樣」。所以把 --rebuild 的輸出原樣放進回覆,
不要只給副本路徑。
新線用跟指揮官同一個權限模式開。 兩個模式不同的 session 之間,跨 session 訊息會被扣在收件 端的審核框等人放行,約五分鐘過期。2026-10-06 一條用另一個模式開的線整天沒收到指揮官任何一則, 同模式的七條線訊息都即時到。
它印兩種段落:
- 指揮官那一段:讀板子、讀日誌、上一任在等什麼、重建那一刻各條線的宣告、照〈心跳〉 重排巡邏,以及上線後把新名字告訴每一條還活著的線。「已經決定的事」跟壓縮後注入同一份, 沒進日誌的原話從最近一次宣告是指揮官的那個 session 的 transcript 讀。
- 每一條線一段:
--since-hours之內宣告過--line的,同一條線取最新那份宣告(--line 指揮官不算一條實作線)。內容是開場四步與失聯協定、常駐規矩(每節只有標題與「→」指向)、 上一任最後的宣告,以及日誌裡跟這條線有關的筆數與讀法(--lookup <線名>),不貼內文。段尾 印這一段的 bytes。沒宣告線的 session 不印段落,並被指名——印一段猜的比不印糟。
從零開一條新線時,線名與 holding 由你講出來,它只印那一條的段落,跟上面的線段落同形:
python3 .claude/skills/command-post/scripts/command-post.py --rebuild \
[--from <指揮官名字>] --line '<線名>' --holding '<這條線要接什麼>'那條線不需要有人宣告過,本機也不需要有它的單目錄(例如 JIRA 剛開的單)。它不寫宣告,宣告由 新 session 照開場四步自己寫。兩格缺一格就說出缺哪一格,離場碼 2,不印段落。
每一段的第一行是 @browser:new_tab。 使用者 2026-10-12 的原話:「重建 session 要加
@browser:new_tab 直接授權瀏覽器,直接做進框架」。那天機器重開兩次,貼上重建 prompt 的每一條線
上線查瀏覽器都是「沒有」,各自停下來等指揮官轉達授權。這一行只在 VS Code 輸入框裡、貼成新
session 的第一則時連上瀏覽器;終端機 CLI 不認得它,要用 claude --chrome 開,經 SendMessage
送出時它也只是一行字。官方文件只寫了 VS Code 輸入框的 @browser,:new_tab 這個寫法沒有
文件,是實測可用。
名字是產出那一刻登錄裡的。 指揮官之後改名,已經印出去的 prompt 帶的是舊名,要重印。
常駐規矩這支 skill 不帶。 各條線要守的規矩常常是某一家公司的(憑證怎麼載、PR 標題怎麼
寫),而這支 skill 會被帶到別的環境。那些寫在日誌旁邊的 ~/.claude/sessions/command-post/standing.md,由指揮官自己放、自己
改;沒有那份檔就說出來。
每條線只拿到共用的節與它自己那幾節。 一節的標題帶 [線:X](可以多個,逗號分開)就是 X
線專用,不帶的是所有線共用。X 是單號(ABC-123 這類)時,宣告的線名或 --holding 裡出現同一個單號就
對上;X 是線名(review、站會)時,去掉「線」字與空白、不分大小寫,整個名字相等才對上,
DP 不對上 DP-732。固定線名是 review、站會、DP(框架 同義)、指揮官;沒對上固定線名的宣告都算 epic 線,
[線:epic] 對上它們,所以 epic 線不用改名就拿得到。[線:封存] 是已經結束的事,任何一段都不貼,留在檔裡給人查。指揮官段與
壓縮後的注入拿封存以外的全部節:指揮官要派工,每條線的規矩都要看得到。使用者 2026-10-27 原話:
「你的重建 prompt 內容沒道理的多,怎麼回事」——那時每條線的 prompt 九成是全檔原樣貼進去。
standing.md 只放指向,不放規矩本身。 每一條寫成「哪支 skill 哪一節」。一條新規矩 不先寫進 standing.md:它的家是某支 skill,走框架單改那支 skill,standing.md 再補一行指過去。 先寫進 standing.md 的那一條會跟 skill 裡的那一份各說各的——2026-10-19 一天三節規矩先落在 那裡,之後各開一張框架單搬家。
判準量得到:一節沒有「→」行,或「→」行以外的本文超過兩行(使用者原話那一兩行以外還在講 做法),就是規矩本身,搬進它指的 skill。 線段落只印標題與「→」行,原話與本文留給指揮官段 與壓縮後的注入,所以一節規矩本身在線段落上會變成一行「沒有指向」——那一行就是搬家的清單。 2026-11-10 的標本:使用者原話「現在各線的 prompt 都不合理的龐大,找到原因並修正」。那天每條線 16.9~17.8KB,其中常駐規矩段 10.3KB/30 節整節貼入、日誌 6 筆約 4KB 整筆貼入、「## 常駐規矩」 底下再印一次檔案自己的「# 常駐規矩」;standing.md 68 節 28KB,五節整段抄規矩本文(人名對照、 data-modify、封版節奏、站只提供正確狀態、對方問的是我方的待辦)。改成只印標題與指向、日誌只印 筆數之後,DP 線那一段 12.9KB 降到 6KB 以下。這幾個數字是 2026-11-10 那台機器當天那份 standing.md 與日誌量到的,檔案天天在變,拿今天的量去對會對不上(驗證者 2026-11-11 量到 67 節 24,700 bytes、base 11,409 → head 5,618 bytes)。
什麼時候該交
這裡不給門檻,理由跟〈板子上的兩個不穩訊號〉是同一個:那兩個訊號偵測不出「開始不穩」 那一刻,配一個門檻只會讓一個猜測看起來像一個量測。
決定是人做的,板子把兩個量印給他看。真的要換的時候照上面的順序走。
日誌是事件流,不是交接文件
接手讀的東西裡,沒有一樣要人在交棒那一刻坐下來寫:session 登錄(機器寫的)、每個
session 自己的宣告(它自己寫的)、單樹的輪次狀態與 holders[](脊椎寫的)、這一份
SKILL.md,以及指揮官日誌(每一筆在事件發生那一刻由命令寫的)。
分界在「什麼時候寫、誰寫」,不在「是不是一份檔」。 不要為交棒另開一份「指揮官交接 文件」:交棒那一刻才手寫的摘要會跟實際狀態漂開,而漂掉的那一刻正好是有人要接手、最需要 一句真話的時候。日誌不是那種東西——它的每一筆在事件發生那一刻就寫下,不改舊的,所以它 不會「過期」,只會變長;接手的人讀的是尾端。
--log 是補一筆事件,不是寫一份摘要。 拿它寫「目前整體狀況如下……」就又回到交接文件了
——整體狀況是板子的事,板子每一輪重算。
五、問人的時候
問之前先過〈指揮者自己的五條邊界〉第四條。 那一條沒過,下面這幾節都還不用讀。
這一步需要的東西,誰手上有
收拾自己造成的錯,不往上問,做完再回報。 撤回誤發的訊息、還原自己改壞的東西,都屬於這一類: 錯是自己造成的,收拾它需要的東西也在自己手上。
列進「待決」的每一項,先過一句:這件事只有使用者能決定嗎? 答案是不是,就自己裁,不列。
這兩條跟〈併與上線的指令〉的「做法的每一步都要有來源」方向相反,判準是同一句:這一步需要的 東西,誰手上有。 來源不在自己手上,就不下令;裁決需要的東西在自己手上,就不往上推。
2026-10-20 的標本,同一天兩次,方向相反。12:41 是沒有來源就下令(標本在〈併與上線的指令〉)。 12:4x 指揮官把「刪掉自己誤發的那則上線頻道訊息」列成待決去問使用者。使用者原話:「為什麼要不要刪 要問我」「我在質疑你的應對!」。
逐級解決(使用者 2026-10-09 拍板)。線回報「做不了、要使用者裁」時,指揮官不直接轉成待決, 先自己試:換一條不需要那個權限的路、查有沒有別的入口。分類器擋下的事,試的是另一條路,不是把 同一個動作換個視窗再做一次。還是不行才帶給使用者,帶上去的只能是介面層的點擊,或〈Waiting for Stage 之後每天的固定動作〉那一節的新 session prompt;要使用者打 API、跑命令、貼 token 的選項不列。
「機器壞了」先對照另一條線,再看狀態頁。 線回報「這台機器的 X 壞了、只有使用者能修」時,指揮官 先派另一條線做同一個動作對照。只有一條壞,是那條線的環境,由它自己修或重建。兩條都壞,再看那個 外部服務的狀態頁(GitHub 看 githubstatus.com);狀態頁正常才是機器的事,交使用者。
2026-11-04 的標本:一條線推送回 publickey denied,看到 SSH agent 是空的,回報「SSH 金鑰只有使用者
能載」,指揮官照轉成使用者待辦。對照之後兩條線都 denied;githubstatus 從 17:49 起 Git Operations
degraded,而 ssh -v 顯示伺服器接受了 id_ed25519,agent 空不影響。錯在沒對照、也沒看狀態頁就上問。
使用者原話:「有點奇怪,為什麼這次 push 要特殊權限,應該正常 push 就好了才對」。
形狀就是這個 workspace 既有的那一份
結論、根據、待決,三段,順序固定;待決的每一項帶自己的建議與理由。這支不發明第二種
格式——.claude/rules/style-and-language.md 已經規定了一份,而兩份會漂。
待決的每一項帶四格
指揮官問人的時候,被問的那個人不是第一線接觸這些工作的人。 這是指揮官模式的直接後果: 他只跟指揮的那個 session 講話,其餘 session 的來龍去脈他沒看過。所以「要不要開一張單」這種 一行式的問題,對第一線的人是完整的,對他是空的——他手上沒有那張單怎麼冒出來的那一段。
所以每一項待決帶四樣,缺一項就是還沒問完:
| 帶什麼 | 說的是 |
| 怎麼冒出來的 | 哪一次量測、哪一則回報逼出這一題 |
| 不決定會怎樣 | 具體後果,不是「比較不好」 |
| 選項各自的代價 | 每一條路各要付什麼 |
| 我的建議與理由 | 這一條 .claude/rules/style-and-language.md 本來就有,前面三格是加在它前面的 |
四格各一兩句就夠——帶前因後果不等於寫長。 那一份規則同時規定一般回覆不超過一個螢幕, 兩者不衝突:四格要的是每一格都有東西,不是每一格都很長。
四格是加在「待決」那一項裡面的,三段仍然是既有的結論/根據/待決,不另立一套格式。
往上傳之前先過濾
指揮官的價值在於擋掉不該佔用人的注意力的問題,不在於當一個轉發器。判準一句話:
這件事在提問者自己的管轄內,而且做錯了改得回來 → 退回去讓它自己決定; 其餘才往上傳。
兩類分得開,各舉一個真的收到過的:
| 共同點 | 例子 | |
| 往上傳 | 不在提問者的管轄內 | 不可逆或對外的(改寫歷史、推 commit、送出對外的留言);共用資源(port 3001 要不要讓給另一個 session、某個工作區要不要清掉);跨單排序;只有人才知道的(某個語系用短碼還是區域碼);真的走不下去 |
| 退回去 | 問的是它自己的東西,而且可逆 | 「要不要開一張單,你決定」(driving-work-to-done 答得出來)、「要不要把這句寫進它自己那張單的活文件」、「你要我改,說一句我就改」 |
往上傳的每一項,先問日誌寫過什麼。 寫給使用者的待決或「要確認」裡出現的每一個單號、 PR 號、人名,送出之前跑一次:
python3 .claude/skills/command-post/scripts/command-post.py --lookup <key> [<key>...]它對每個 key 印日誌裡的命中(行號、那一筆的發生什麼/決定/在等/接/卡)、最近哪幾條線的 宣告提到它、最後一句在等有沒有它,以及那幾筆裡一起出現的別的單號與 PR。有命中的那一條 不是待決:照抄「已經排給誰、什麼時候做」,不拿去問。零命中它會說「日誌裡沒有」,那時才 可以問。
一起出現的那一行也要查。 紀錄常常只寫 PR 不寫單號:2026-10-16 有一件事,日誌裡三筆 都寫著某條線接著「壓版、上線後驗某顆 PR」,三筆都沒寫單號。指揮官壓縮之後沒讀日誌,把它 當成沒有線在顧拿去問了使用者。只查單號的話那三筆一筆都撈不到;查單號會列出那顆 PR,再查 PR 才撈得到。
使用者已經裁過的事不回問。「原則同意就是開始執行」(.claude/rules/style-and-language.md
〈風格〉)對指揮官也成立:拿到裁決之後直接派、直接做,不再列一輪「需要你確認的事」。例外只有
那一條寫的三種:不可逆動作、自己起意的對外寫入、只有使用者才知道的商業決策。使用者已經裁過
的對外動作不算自己起意。使用者原話:「你最近不斷發出大量浪費時間的確認」(2026-11-05)。
壓縮之後第一步不是接著做,是 --board 加上手上每一張單的 --lookup。壓縮摘要不是
狀態,日誌才是。派工前先對一次 --board 尾端的派工前對照:那一段每一支 skill 一行,觸發句
是當下從那份 SKILL.md 讀的。壓縮之後 skill 清單不一定還在 context 裡,而對得上某一支的事,
派工句就指名它;2026-10-19 指揮官跳過 driving-work-to-done 直接令線開單、自創報告結構,
使用者原話「你到底知不知道這個框架有哪些 skill,我每天都要這樣重來嗎」。
時程只有使用者裁。「排下一班」「今天先用現況」「先上一半」都是時程裁決。指揮官與線
寫給使用者的待決,只列做法與做完的樣子,不列時程選項。指揮官派給線的指令也不替使用者定
時程。有量到的事實擋住某個時間點(例如那一班的截止已過),把那個事實帶出處寫進根據,不把
它改寫成一個時程選項。改動範圍的大小也一樣不判,只判爆炸半徑,見 swe-knowledge〈改動的原則〉。
2026-10-27 的標本:線把「供應商角色被擋要不要放行」寫成「今天先用現況上鎖、要放行就排 下一班新 code」,指揮官照這個形狀帶給使用者。使用者原話:「今天就是要做完!你不要擅自 估時!不要為了時間亂趕!正常做就可以做的完!」
排時程時,假日與週末也算開發日(使用者 2026-10-08)。線在假日照跑:施工、部署測試環境、 自驗都排得進去。只有要人看的事排工作日:使用者 review、同事的 review 與驗收、對外送 PR 請人看。
評估好不好達成只看摩擦點:需不需要別的角色介入(PM、編輯、外單位 review、沒有權限的東西)。 工作量不是指標。
使用者下令要做的框架單,成功定義由指揮官自己簽(使用者 2026-10-12 拍板),不往上報。帶給 使用者的只剩不可逆、對外、或會改到使用者自己說過的決定的那幾項。施工中冒出的下一張,同樣由 指揮官決定開不開、怎麼簽。
登入、找資料是線的活,不是使用者的待辦。 線的瀏覽器已經登入使用者的帳號,SSO 登入由 線自己點。找測試資料、帳號、頁面也由線自己找。只有缺一個線手上沒有的憑證(密碼、OTP), 才往上傳,而且指名哪一頁缺哪一樣。
2026-10-27 的標本:指揮官把「到線的瀏覽器登入正式環境三個分頁」「找正式環境的測試商品與 帳號」列成使用者的待辦。使用者原話:「這是〔那條線〕要做的吧!你重建了嗎?為什麼要要我做!」
站會線在飛的日子,要問同事(PM、其他 RD)的問題寫進站會的卡關/待確認格,由站會帶出去。
不列成使用者待辦,也不擬成要使用者轉問的訊息。站會使用者自己會看過、自己帶出去,所以
.claude/rules/cross-session-command.md〈對外送出〉向同事確認那一列要的「使用者先看過全文」
照樣成立,換的只是管道。題目寫成同事不追脈絡也讀得懂的一句,交給站會線(standup 的卡關與
口頭同步那兩塊)。
2026-11-03 10:56 的標本:指揮官把要問 PM 的三題列成「你帶給〔那位 PM〕」。使用者原話: 「〔那張單〕你的提問請你列在站會,你不懂站會的意義嗎」
一張單怎麼算完成,看那家公司的知識怎麼寫。 指揮官與線不把自己想加的驗收步驟寫成完成 條件。要加之前,先找到寫著那一條的 skill;找不到,那一條就不是完成條件。2026-10-27 的標本: 一條線把「我方在正式環境用測試商品實改一筆」寫進單上當成轉完成的條件,指揮官又把它抄進 站會,而沒有任何 skill 這樣寫。使用者原話:「把我方 prod 實測當成完成條件,什麼時候過這個 條件了!哪個 skill 有提到!」
退回去要帶理由,理由就是那個判準:這是你的單、這件事改得回來。只回一句「你自己決定」 不算退回——它沒有把判準交出去,下一次同樣的問題會再上來一次。
兩種常見的「問」其實都該退回去。 一是範圍定了之後的「這個不用做/量到 0/可以另開」: 記一行在單上就好,不上問;真的要上問的只有擋住施工的權限或環境、或會動到畫面的改法。二是 子單要併、要關、要移:照母單的意圖自己判、自己做;只有母單意圖本身要改,才往上問。
驗證者抓到的發現也不上問。 驗證者指 push-verifier、verify-ac 與 reviewer。不修要有理由,
理由寫在單上,不寫成給使用者的待決。push-verifier 與 verify-ac 抓到的預設是修;reviewer 的
意見照 swe-knowledge 第 5 條的四種處置判。
2026-11-04 的標本:〔那顆 PR〕的獨立驗證判 FAIL 六條,指揮官把五條派修,把「自動鎖沒有稽核 列」寫成待決問使用者。使用者原話:「所以要我決定什麼?停起來是他驗出問題啊,不應該修正嗎?」
不確定的往上傳。 這條過濾省的是人的注意力,不是指揮官的判斷;把一件真的不可逆的事誤判 成可逆,代價比多問一次大得多。所以不可逆或對外的不退回去,沒有例外——那一格不參與 「在不在管轄內」的判斷。
這個判準來自一次量測:一個 session 的收件匣 206 則 peer 訊息,含求指示標記的 59 則,逐則 讀完能認定是真的在問人的約 28 則,兩類的分界很乾淨。那份量測自己的邊界要一起說:它來自 舊的作業方式(這一版的回報契約之前)、是那個 session 對自己的收件匣做的分類、59 是 樣式命中不是確認數。所以它證得出兩類真的分得開,證不出比例會維持。
要使用者自己送的稿,全文貼在回覆裡
Slack 稿、DM 稿、給新 session 的 prompt,全文貼進給使用者的那一則回覆。只寫「全文在某線上一則」 「全文在某個檔」或「照舊」,都不算交付:使用者看不到線的訊息,也看不到檔案。
2026-11-03 的標本:給 Sam 的 EXPLAIN 稿 16:50 只寫「全文在 work-78 上一則」;重開之後兩輪都寫 「三則稿照舊」。使用者 16:28 與 19:0x 兩次原話「我沒看到稿」。
要代送的對外內容,哪一種先給人看
上面那一格說「不可逆或對外的不退回去」。它管的是「這件事誰決定」,不是「這段文字誰過目」 ——一則要送出去的 review 回覆,決定權本來就不在提問的那個 session 手上,剩下的問題只有一個: 使用者要不要逐則讀過它。這一節回答的是後者,所以它不是上面那條的例外,是那條沒有回答的 另一半。
判準看那則回覆是什麼:
| 回覆的內容是 | 怎麼辦 |
| 對一顆 PR 的 review 意見的回覆,不論照做、說明為什麼不照做、拒絕或另外開單 | 直接送,送完回報送了什麼、送去哪。依據是 .claude/rules/cross-session-command.md〈對外送出〉那張表 |
| 自己手上那張單的 JIRA comment、附件、狀態轉換、欄位 | 直接寫,送完回報 URL。使用者要在 JIRA 上看到內容才判斷得了,停在草稿等同意等於什麼都沒做(2026-09-10 到 09-11 兩張單各停一次;原話「每次上傳 jira 不應該一直問,沒有從 jira 看到根本不能判斷,我要知道那個 session 在搞什麼,一直要確認不做事」) |
對外溝通當作只有一次機會。 給同一個人的事收齊成一則,我方是終版才送。給 reviewer 的那一則固定寫四樣:
- 他看過的 head。
- 現在的 head。
- 兩個 head 之間改了什麼、為什麼改,附 compare 連結(
https://github.com/<owner>/<repo>/compare/<舊 head>...<新 head>)。 - 要他做的一件事。
送出之後沒有第二則。想補一句,表示送的時候還不是終版;那句話留到下一次真的有事要找他。 使用者原話:「請當作所有的與外部溝通的機會都「高機率只有一次」」。
自己派出去、會改這則稿內容的查核還在跑,稿就不交。 等它回來,一次定版。稿裡寫著「正在查」, 就表示還不是終版。使用者這時候就要那份稿、或有時限,回他兩件事:查核預計什麼時候回來,回來之後 交的是哪一版。不先交一版。
已經送出的訊息不改,也不出修正版。 送出的那一則裡承諾了後續(例如「查完再補結果」),才可以 有一則後續,而且只有那一則。
2026-11-05 15:4x 的標本:指揮官已經派了一條會改稿內容的研究,一小時內會出結果,卻先把稿交給 使用者送,稿裡寫「正在查」。研究回來,又給了一版改寫的,等於要改一則已經送出的訊息。使用者 原話:「你覺得已經送出去的訊息是可以隨時變卦的嗎」。
review 回覆怎麼處置由 driving-work-to-done 與 swe-knowledge〈回覆 reviewer〉判,不是使用者要
拍板的事,所以逐則確認只是把它排進一條隊伍。跟 reviewer 以外的人爭論立場、向同事確認事情,
照那張送出表先給使用者看。
代價量得出來:2026-08-29 到 08-31,同一批工作有八支 PR 停在原地,其中四支是 CHANGES_REQUESTED ——等的就是那幾則沒被放行的回覆。
這條界線只劃在 review 回覆與自己那張單的 JIRA 上。 推 commit、改寫歷史、Slack 訊息、 別人的單、動共用資源,仍然照上面那一格往上傳,那個判準一個字都不放寬。
判錯的責任在指揮官。 任何一則判成直接送、而使用者事後認為該先看的,整批回到逐則確認 ——一條沒有人負責的界線會往寬的那邊漂。
什麼時候值得畫一張圖
判準一句話:要對方同時比對三個以上的量、而那些量之間的關係用句子講會需要回頭讀第二次時, 畫。其餘不畫。
對三種問題各判一次:
| 問題 | 判準說 | 為什麼 |
| 「A 跟 B 兩個做法選一個」——只有選項與取捨 | 不畫 | 兩個東西並排,一張表就夠,圖不會讓取捨變清楚 |
| 「八個 session、各自閒置多久、手上有什麼、哪些能關」 | 畫 | 四個量乘八列,句子講完對方要回頭數 |
| 「這樣做可以嗎」——只要一個點頭 | 不畫 | 沒有量要比 |
不因為看起來用心就畫。 一張沒有人需要的圖,是把讀的人的時間換成自己的努力看起來比較多。
圖不取代那三段。 圖出現的時候結論、根據、待決仍然在,待決仍然帶著建議——圖是根據的一 部分,不是「你自己看」的代替品。
圖上每一個量都要說得出它從哪裡量到的。 畫不出來源的量不要畫進去。
這支不做的事
- 不判定一件工作算不算完成。 那是
verify-ac。 - 不決定下一站。 那是
driving-work-to-done。 - 不停止不是它自己起的進程、不動別的 session 的工作區或分支、不啟動或停止任何共用的 服務與容器。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

