Trellis 頻道
trellis channel 是本地多代理協作運行時。當代理需要透過持久化事件日誌進行溝通、需要產生一個對等工作進程、需要對運行中的工作進程進行中斷或除錯，或是需要將回饋記錄到 --type forum 頻道時，即可使用它。
典型的使用者信號："跟 codex/claude 討論"、"brainstorm with another agent"、"產生一個 implement/check 工作進程"、"讓 agent 審查"、"開個 issue board / changelog 論壇"、"看看這個 thread"、"channel 卡住了 / 沒有輸出"、"進度被截斷"、"那個 channel command 要怎麼寫"。
此技能是一個索引。僅載入目前工作所需的參考文件——不要預先載入所有文件。
初次命令
trellis --version
trellis channel --help
trellis channel list --all
trellis channel list --scope global --all
如果使用者提到了某個頻道或討論串，請先檢查它，再詢問背景資訊：
trellis channel forum <board> --scope global
trellis channel thread <board> <thread> --scope global
trellis channel context list <board> --scope global --thread <thread>
根據使用者意圖路由
| 使用者意圖 | 閱讀內容 |
|---|---|
| "跟 codex/claude 討論一下", "brainstorm with another agent" | references/workflows.md |
| "派一個 implement/check agent", "讓 agent review", "產生一個 worker" | references/workflows.md, 然後 references/workers.md |
| "開 issue 區 / topic 群 / changelog / board", "建立一個論壇" | references/forum.md |
| "看看這個 thread / linked context", "檢查一個討論串" | references/forum.md |
| "channel 卡住了 / 沒有輸出 / progress 被截斷", "worker 停止回應" | references/progress-debugging.md |
| "具體命令要怎麼寫", "X 有哪些旗標" | references/command-reference.md |
核心規則
- 新的論壇頻道使用
--type forum。thread是論壇頻道內的一個項目。 - 使用
--context-file/--context-raw以及trellis channel context add/delete/list。--linked-context-*是已棄用的術語。 - 長訊息請使用
--stdin或--text-file。不要將長的中英文混合文字放在位置 shell 參數中。 messages的漂亮輸出是操作員儀表板，可能會截斷進度。稽核時請使用--raw。--as根據命令，可以是發言者或工作進程的 handle。當涉及多個代理或工作階段時，請使用明確、穩定的名稱。--scope project（預設）作用於目前工作目錄的專案儲存桶；--scope global作用於共享的__global__儲存桶。請審慎選擇範圍——全域看板在專案列表中是不可見的，除非傳入--scope global。- 對於腦力激盪，請進行多輪壓力測試。一個答案加上一個確認只是審查，不是腦力激盪。
- 調度器等待模式：使用
--kind done/--kind turn_finished（trellis 發出的系統事件）作為完成信號，而不是使用使用者標籤--tag。CLI 幫助說明了phase_done/question是--tag的範例，但只有interrupt是具有硬編碼 trellis 行為的保留標籤；其他的都是不透明的使用者標籤。依賴工作進程執行send --tag <my_signal>是不可靠的——LLM 工作進程通常會將標籤字串寫入散文中，而不是執行實際的 CLI 命令。請參閱references/command-reference.md中的 "tag vs kind"。 - 論壇頻道是事件溯源的。請不要優先解析
events.jsonl；請使用forum、thread、messages --thread和context list。 @mindfoldhq/trellis-core擁有可重複使用的頻道/討論串狀態、事件追加、序號分配、上下文/標題投影、歸約器以及任務輔助工具。CLI 則擁有旗標、終端機渲染、提示、工作進程生命週期和程序退出。
參考文件
references/workflows.md—— 標準協作模式 A–F（同儕腦力激盪、產出審查、派發與等待、論壇議題捕捉、中斷與重新導向、一次性執行）。references/forum.md—— 論壇頻道、上下文、標題、重新命名、變更日誌論壇、討論串過濾。references/workers.md—— 產生工作進程、代理卡片、上下文注入（--file/--jsonl）、中斷、終止語意。references/progress-debugging.md—— 進度/原始輸出檢查、工作進程無回應診斷、OOM 防護、結束代碼。references/command-reference.md—— 目前的 CLI 命令參考（每個子命令、每個旗標、輸出慣例、範圍/類型模型）。
不適用於
- 僅需一個 markdown 檔案和提示即可完成的單次靜態審查。
- 用自我記錄取代常規工具呼叫。
- 長期記憶檢索。請使用持久的論壇頻道來處理可操作的議題，並使用
trellis mem（trellis-session-insight技能）進行工作階段/歷史搜尋。