用途:trellis channel 是本地多智能体协作运行时,适合让 agent 通过持久事件日志互相沟通、把 worker 作为对等进程派生、对运行中的 worker 进行中断或调试,以及把反馈记录到持久化的 --type forum 频道。
主要能力:支持 forum 频道与 thread、context 注入与列举、worker 派生与评审、进度检查与卡住诊断、频道日志调试。典型信号包括“和 codex/claude 讨论”“brainstorm with another agent”“spawn an implement/check worker”“让 agent review”“开 issue 区 / changelog forum”“channel 卡住了 / 没输出”“progress 被截断”。
使用方式:先运行 trellis --version、trellis channel --help、trellis channel list --all、trellis channel list --scope global --all。若用户指定频道或 thread,先查看:trellis channel forum <board> --scope global、trellis channel thread <board> <thread> --scope global、trellis channel context list <board> --scope global --thread <thread>。该技能是索引,只加载当前任务对应的参考文件,不要全部预载。
核心规则:新 forum 频道使用 --type forum,thread 是 forum 频道内的一项。使用 --context-file / --context-raw 与 trellis channel context add/delete/list;--linked-context-* 已弃用。长消息用 --stdin 或 --text-file,不要把长中英混合文本放进位置参数。pretty 输出是操作面板且可能截断进度,审计用 --raw。--as 是发言者或 worker 句柄,多 agent 时用稳定明确名称。--scope project(默认)作用于当前 cwd 项目桶,--scope global 作用于共享 global 桶;全局 board 在项目列表中不可见,除非传 --scope global。brainstorm 需多轮压力测试,一问一确认只是 review。Dispatcher 等待用 --kind done / --kind turn_finished,不要用用户 --tag 作为完成信号;只有 interrupt 是保留 tag。forum 频道是事件溯源,不要先解析 events.jsonl,用 forum、thread、messages --thread、context list。
适用场景:对等 brainstorm、派生评审、dispatch-and-wait、forum 问题记录、中断并重定向、一次性运行。
限制:不适合仅需 markdown 与提示词的静态评审、用自记录替代正常工具调用、长期记忆检索;后者应使用持久 forum 频道处理可执行问题,并用 trellis mem(trellis-session-insight 技能)做会话/历史搜索。参考文件包括 workflows.md、forum.md、workers.md、progress-debugging.md、command-reference.md。