trellis-channel

trellis-channel

trellis channel 是本地多 Agent 协作运行时。当 Agent 需要通过持久事件日志交流、需要将工作进程作为对等进程启动、需要中断／调试正在运行的工作进程，或需要在持久的 --type forum 频道中记录反馈时，可以使用它。

典型用户需求：“和 codex/claude 讨论”“与另一个 Agent 头脑风暴”“启动一个实现／检查工作进程”“让 Agent 审查”“开一个 issue 看板／变更日志论坛”“查看这个 thread”“频道卡住了／没有输出”“进度被截断了”“这条频道命令该怎么写”。

此技能是索引。只加载当前任务所需的参考文件，不要预先加载所有文件。

首批命令

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>

按用户意图选择路径

用户意图	阅读
“和 codex/claude 讨论一下”“与另一个 Agent 头脑风暴”	references/workflows.md
“派一个 implement/check Agent”“让 Agent 审查”“启动一个工作进程”	references/workflows.md，然后是 references/workers.md
“开 issue 区／topic 群／changelog／看板”“创建论坛”	references/forum.md
“查看这个 thread／关联上下文”“检查 thread”	references/forum.md
“频道卡住了／没有输出／进度被截断”“工作进程停滞”	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 表示发言者或工作进程句柄，具体取决于命令。涉及多个 Agent 或会话时，使用明确且稳定的名称。
• --scope project（默认值）操作当前 cwd 对应的项目分区；--scope global 操作共享的 __global__ 分区。请有意识地选择作用域——不传入 --scope global 时，项目列表中看不到全局看板。
• 头脑风暴应进行多轮压力测试。一个回答加一次确认属于审查，不是头脑风暴。
• Dispatcher 等待模式：使用 --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 负责可复用的频道／thread 状态、事件追加、seq 分配、上下文／标题投影、reducer 和任务辅助工具。CLI 负责标志、终端渲染、提示词、工作进程生命周期和进程退出。

参考文件

• references/workflows.md — 规范的协作模式 A–F（同级头脑风暴、生成审查、派发并等待、论坛问题记录、中断并重定向、单次运行）。
• references/forum.md — 论坛频道、上下文、标题、重命名、变更日志论坛、线程筛选。
• references/workers.md — 生成、Agent 卡片、上下文注入（--file / --jsonl）、中断、终止语义。
• references/progress-debugging.md — 进度／原始数据检查、停滞 Worker 诊断、OOM 防护、退出代码。
• references/command-reference.md — 当前 CLI 命令参考（每个子命令、每个标志、输出约定、范围／类型模型）。

不适用场景

• 只需进行一次静态审查，Markdown 文件和提示词已足够。
• 用自我记录替代常规工具调用。
• 检索长期记忆。对于可执行问题，请使用持久化论坛频道；对于会话／历史搜索，请使用 trellis mem（trellis-session-insight 技能）。