0司令台

主任App 的獨立遙控器,本身是一個獨立的小 App:單一網頁、不吃主任App 的程式碼。App 壞了(白畫面、打不開、某一頁一開就炸)它照樣開得起來——叫接力棒來修的按鈕就在這裡。

0司令台 是各 Claude 專案的總控台,一個獨立的小系統:自己的 repo(wayuanzi-web/deck)、自己的網址,跟主任App 沒有從屬關係——主任App 只是它看板上的一列,主任App 壞了這頁照樣開。所有資料只從 GitHub 讀(每個專案的 repo:最後更新、CI、PR、現況檔、進度檔);這頁自己不存任何專案資料,token 與名單只存在這支手機。

三區:📁 專案(每個 Claude 專案一列:最後更新、CI、開著的 PR、現況、哪個對話在做、🚀 開工;主任App 那列多了 🏃 接力棒、🆕 開新棒,按「▾ 接力棒細節」才看口令、✍️ 其他指令、📊 接力進度、送審中)、📚 指令庫與工作台(把指令組好、檢查過個資再送)、🚨 救援(主任App 壞了從這裡按緊急回滾;清快取、解除離線在主任App 自己的救援頁)。每一區的區名都可以點:點一下收起、再點展開;主任App 的細節展開與否也會記住。按鈕都是圖示＋短字,每顆的長說明在說明書各節(各區右上「說明」)。

怎麼裝到手機:Safari 開這個網址 → 分享 →「加入主畫面」,會得到一個叫「0司令台」的獨立圖示(Android Chrome 選「安裝」)。主任App 裡「🚀 呼叫司令台」那顆鈕也是連到這裡。

要改司令台:到 Claude 的「0司令台」專案用對話講要改什麼(📁 那區有「🛰 開新 0司令台 對話」鈕)。改動走 PR:CI 綠了小版(+0.01)自動上線;整數大版會先給你一個預覽網址,你看過說「切」才合併上線。

登錄簿在司令台 repo 的 projects.json(要加減專案:到「0司令台」專案說一聲)。開頁會讀主任App 的進度檔;按「🔄 讀取狀態」才去 GitHub 問全部專案的最後更新、CI、PR、現況、進度:有 token 每小時可問 5000 次,沒有只能 60 次,而且私有 repo(主任App)一定要 token——到「▾ 接力棒細節」的送審中貼一把。結果存在這支手機 10 分鐘。

• 最後更新=那個 repo 最近一次 push 的時間;CI=主線最近一次 GitHub Actions 的結果(✅ 通過、❌ 失敗、⏳ 跑著、— 沒設 CI)。點 CI 那格打開那次執行;「GitHub ›」打開 repo。
• 現況=那個 repo 的 docs/STATUS.md 前兩行(Claude 做完會更新它;沒有這個檔就不顯示——開工時叫它建一份)。
• 開著的 PR=Claude 做好、等 CI 或等合併的改動,每條寫著「✅ 可合併 / ❌ CI 失敗 / ⏳ CI 跑著 / 草稿」,點了開那個 PR。新流程是 CI 綠了 Claude 自己合併,所以這裡長期有東西=它卡住了,去那個對話問一句。
• 🚀 開工=一鍵:複製那個專案的開場句(「repo 開工:讀 CLAUDE.md 接手,先回報現況與下一步,等我說做。」)並打開 Claude Code → 新對話上方 repo 選那個專案 → 長按貼上送出(字已在剪貼簿)。主任App 那列的開工=🆕 開新棒(交接指令長,仍先攤開面板)。各專案的規矩寫在各自 repo 的 CLAUDE.md:改動一律走 PR、CI 綠了 Claude 自己合併,你只在被問時回答。
• 🛰 開新 0司令台 對話=一鍵:複製司令台專案的開場句並打開 Claude 的專案列表 → 點「0司令台」→ 新對話貼上。要改司令台、要加減專案,都從這裡開。
• 🏃 對話中 / 🏁 已收工 + 開對話 ›:那個專案的 Claude 在自己 repo 維護的進度檔(status.json:哪個對話、現在做什麼、什麼時候更新;主任App 的是 relay.json)。開工時叫它建一份,之後每批更新,這裡就看得到。
• 主任App 那列:列頭寫「接力棒:第 N 棒 · 開工中/已收工」與 GitHub 狀態(私有 repo,要有「送審中」那把 token 才有最後更新/CI/PR);🏃 接力棒=開那棒的對話、🆕 開新棒=交接指令面板;「▾ 接力棒細節」展開才看口令、✍️ 其他指令、📊 接力進度、送審中(各有自己的說明)。

📚 指令庫:精選的指令(司令台目錄的 prompts.json,由「0司令台」專案維護)+你自己存的(只在這支手機)。上面有搜尋框(標題、內容、備註都找);自己存的那幾條有「✎ 載回」,把五格填回工作台改了再送。點一條=先檢查個資 → 跳出面板(整段攤開、已複製與否、步驟)→ 按「🚀」才開對話。指令裡的 {變數}(例:{repo}、{頁面})會先要你填,填完才組成整段。每條標了送到哪:🏃 接力棒(主任App 現任棒;已收工就不能送)、💻 Claude Code(新對話,自己選 repo)、🛰 0司令台。

🧰 指令工作台:不用 API 的「指令審稿」。五格:目的(要達成什麼)、範圍(動哪些檔)、不做(不准碰什麼)、驗收(做到怎樣算完)、許可(它可以自己決定什麼、什麼要問你)。按「📤」組成一段指令 → 個資閘(名冊姓名、證號、手機、電話、生日、地址、案號、帳號,有就擋、可換遮罩版)→ 面板 → 「🚀」開對話。「💾 存進指令庫」把這五格存成自己的一條,下次直接點;存之前也會檢查個資。

為什麼這樣寫指令:範圍與不做寫清楚,Claude 就不會順手改到別的;驗收寫清楚,它才知道做到哪算完;許可寫清楚,它就不必每一步都問你——你要的是少介入。

上排兩格=改動走的路:測試道 /v7/(接力棒做完自己合併到這裡,等你驗、說「切」)→ 主線(你每天用的)。格子裡寫的是那條車道現在的 App 版本與司令台版本;點了就打開那條車道。接力棒收工了還有批次沒合併,測試道那格會多一句「N 批沒合併(說「上 v7」)」。下面那行若有「哨兵 🟢🟡🔴」,是接力棒最後一次跑哨兵的結果。

下面每一列=一棒(一個 Claude 對話):🏃 開工中、🏁 已收工;後面寫開工時間與做了幾批。點那一列=打開那個對話。一列 15 格(接力棒一棒的彈性上限,不強制交棒;上下文被壓縮才一定交);第 16 格以後是破例。

• 橘=送審中:接力棒收工了還沒合併才會這樣,對那一棒說「上 v7」。
• 藍=在測試道:到 App 網址加 /v7/ 看過,說「切」。
• 綠=已切上主線。綠虛線=純資料、文件,合併就生效,不用切。
• 灰刪除線=作廢。

點任何一格會展開那一批:在做什麼、版本、時間、送審包連結、接下來該對誰說什麼。

資料來源是接力棒每批自己寫的 relay-log.json;看到「進度更新」時間太舊、或某棒明明在做卻沒有格子,就對接力棒說「補進度」。新棒開工、還沒合併前,它的列會標「在分支上」,批次要合併後才看得到。

• 第 N 棒 · 開工中:那一棒的對話還在接指令,口令都能按。
• 已收工:它已經交棒,不要再叫它改 App——按「🆕 開新棒」。
• 後面多一句「在分支上,還沒合併」:新的一棒已經開工,只是它的開工紀錄還在送審分支上。要有 token 才看得到(見「送審中」)。
• 按「🏃 接力棒」=打開那一棒的 Claude 對話。讀不到狀態時改開 Claude Code 首頁,自己點最上面那個對話。

什麼時候開:接力棒顯示已收工;它說要交棒(批次到彈性上限 15、或上下文被壓縮);或它斷線、沒反應。

1. 按「🆕 開新棒」→ 跳出面板,整段開場指令已經幫你複製(面板寫「✓ 已複製」)。
2. 按「🚀 開 Claude Code」。
3. 新對話上方的 repo 選 wayuanzi-web/workbench(通常已經是它)。
4. 長按輸入框 →「貼上」→ 送出。
5. 新棒會先回報主線版本、哨兵結果——看完說「繼續」。

面板上有黃字,先照黃字做:「還在開工中」=兩棒同時改 App 會打架,只有它真的沒反應才開;「還有分支沒進主線」=上一棒的交接包要先合併,對上一棒說「上 v7」(口令區那顆會亮著)。

沒複製成功:按「📋 複製指令」再試,或長按文字框 → 全選 → 拷貝。

按一下=複製這個字+打開接力棒的對話,到那邊長按貼上、送出。個資規則若接力棒已產出 /guard.json,司令台與主任App 用同一份(✍️ 其他指令下面那行會寫「規則:guard.json」);否則用司令台內建那套。

• 切=把在 /v7/ 驗過的改動換上主線(它會做完並合併)。
• 上 v7=(作廢)叫它把送審包合併進 main。接力棒現在做完一批就自己合併上測試道,所以平常看不到這顆;只有它收工了、交接包還沒合併時才出現。
• 繼續=照它的計畫做下一批。
• 好=同意它剛剛問的。
• 移交=叫它寫好交接、準備開新棒。
• 取件=叫它取回辦公室電腦 Cowork 做好的答案。
• 外包=叫它把一題寫成題目,交給辦公室電腦 Cowork 去想。

✍️ 其他指令:要講一整段(回報 bug、交代要改什麼)就打在這裡,可以用鍵盤的 🎤 口述。按「📤」前會先檢查有沒有名冊姓名、證號、手機、電話、生日、地址、案號、帳號——有就擋下來,按「🛡 改用遮罩版」換成〔姓名〕〔案號〕這類代號再送;原文不會留在這頁,也不會進對話。寫完回報的話順手附一句驗收方式(「做完回報」「跑哨兵」「附截圖」),對方比較知道做到哪算完。

最近送出:這支手機送過的指令,點一下再送一次;只存在這支手機。

接力棒已收工時口令全部停用(免得叫已收工的對話改 App);只有它的交接包還沒合併時,會留「上 v7」一顆可按。

• 列出還沒合併進主線(main)的接力棒分支:領先幾個提交、最後一筆在做什麼;有開工紀錄的標「🏃 開工鎖:第 N 棒」。
• 接力棒做完會自己合併,這裡通常是空的。有東西=它收工前沒合併(對那一棒說「上 v7」)、或新棒剛在分支上開工。改到 App 程式的合併後到 App 網址加 /v7/ 看過 → 說「切」才上主線;純資料、文件合併就生效。
• 要有 GitHub token 才看得到(司令台有自己的網址,借不到主任App 的)。每個裝置、每個瀏覽器各存各的,換手機要再貼。
• 貼哪一把:到 GitHub 開一把 fine-grained、只讀的(Repository access 勾全部專案的 repo;Contents、Actions、Pull requests 選 Read-only)。token 只存在這支手機的司令台,司令台只讀不寫;按「清掉」就刪掉。
• 寫「token 失效」=過期或被撤銷,重貼一把;寫「找不到」=那把 token 沒勾那個 repo。
• 不要把 token 貼進 Claude 對話,只貼在這頁的框裡。

• 🚨 App 壞了(白畫面、打不開、某一頁一開就炸):按了跳出面板,回滾指令已複製 → 按「🚀」打開接力棒(已收工就開新棒)→ 長按貼上、補一句症狀(哪一頁、看到什麼)→ 送出。接力棒會先退回上一個主線版本,再查原因;這段指令就是你的口令,它不必再等你說「切」。
• 🩹 主任App 救援頁:清快取(切主線後手機還是舊版本號)、解除離線模式(清快取還不行才用),這兩件只有在主任App 自己的網址上才做得到,所以放在它的救援頁;這顆鈕只是幫你開過去。

1. 誰改:只有 Claude 的「0司令台」專案(對話)改它;各專案的 Claude Code(含主任App 的接力棒)不碰這個 repo。
2. 怎麼上線:改動開 PR → CI 跑考卷(tests/check.mjs)→ 小版(+0.01)綠了就自動合併上線;整數大版先給你預覽網址,你說「切」才合併。推上 main 約一分鐘上線。
3. 要加專案:對「0司令台」說「加 repo 名」,它改 projects.json。要那個專案的對話進度出現在這裡,開工時叫那個專案的 Claude 維護 status.json。
4. 主任App 要配合的(relay.json、relay-log.json、guard.json 的格式)寫在 docs/CONTRACTS.md;要改格式,對接力棒說,不是對司令台說。

• 按了沒跳到 Claude:iPhone 可能擋了彈出視窗——回這頁再按一次「🚀」,或自己打開 Claude App 貼上(指令已經在剪貼簿)。
• 寫「讀不到接力棒狀態」:網路不通或網站正在部署,等一分鐘再開。
• 口令全是灰的:接力棒已收工,先開新棒。
• 面板寫「沒讓網頁自動複製」:按「📋 複製指令」再試,或長按文字框 → 全選 → 拷貝。
• 「送審中」一直說讀不到 token:這支手機/這個瀏覽器還沒貼——在那個框貼一把就好。
• 📊 進度跟 🏃 接力棒說的不一樣:進度是接力棒每批手寫的,可能慢半拍;以 🏃 那顆為準,並對接力棒說「補進度」。
• 主任App 那列寫「私有 repo 要 token」:到「▾ 接力棒細節」的送審中貼一把 token,全部都會亮。
• 📁 專案寫「GitHub 未登入流量用完」:不登入每小時只能問 60 次,等一下再按;貼了 token 就是 5000 次。
• 「🩹 主任App 救援頁」開不了:登錄簿 projects.json 沒設主任App 的 url / rescue,對「0司令台」說一聲。