trellis-channel
trellis channel é o runtime de colaboração multiagente local. Use-o quando agentes precisarem se comunicar através de um log de eventos durável, quando um worker deve ser gerado como um processo par, quando um worker em execução precisar de interrupção/depuração ou quando o feedback deve ser registrado em um canal durável do tipo --type forum.
Sinais típicos do usuário: "和 codex/claude 讨论", "brainstorm com outro agente", "gerar um worker implement/check", "deixar o agente revisar", "abrir um quadro de issues / changelog forum", "olhar este tópico", "canal travado / sem saída", "progresso foi truncado", "como escrevo aquele comando de canal".
Esta skill é um índice. Carregue apenas o arquivo de referência para o trabalho atual — não pré-carregue todos.
Primeiros Comandos
trellis --version
trellis channel --help
trellis channel list --all
trellis channel list --scope global --all
Se o usuário nomear um canal ou tópico, inspecione-o antes de perguntar sobre o contexto:
trellis channel forum <board> --scope global
trellis channel thread <board> <thread> --scope global
trellis channel context list <board> --scope global --thread <thread>
Roteamento por Intenção do Usuário
| Intenção do usuário | Leia |
|---|---|
| "和 codex/claude 讨论一下", "brainstorm com outro agente" | references/workflows.md |
| "派 um implement/check agent", "让 agent review", "gerar um worker" | references/workflows.md, depois references/workers.md |
| "开 issue 区 / topic 群 / changelog / board", "criar um fórum" | references/forum.md |
| "看看这个 thread / linked context", "inspecionar um tópico" | references/forum.md |
| "channel 卡住了 / 没输出 / progress 被截断", "worker travou" | references/progress-debugging.md |
| "具体命令怎么写", "quais flags X aceita" | references/command-reference.md |
Regras Principais
- Novos canais de fórum usam
--type forum. Umthreadé um item dentro de um canal de fórum. - Use
--context-file/--context-rawetrellis channel context add/delete/list.--linked-context-*é terminologia obsoleta. - Use
--stdinou--text-filepara mensagens longas. Não coloque texto longo misto chinês/inglês no argumento posicional do shell. - A saída
messagesbonita é um painel do operador e pode truncar o progresso. Use--rawpara auditoria. --asé o identificador do falante ou worker, dependendo do comando. Use nomes explícitos e estáveis quando vários agentes ou sessões estiverem envolvidos.--scope project(padrão) opera no bucket do projeto do diretório atual;--scope globalopera no bucket compartilhado__global__. Escolha o escopo deliberadamente — um quadro global é invisível nas listagens de projeto a menos que--scope globalseja passado.- Para brainstorming, faça múltiplas rodadas de teste de pressão. Uma resposta mais uma confirmação é revisão, não brainstorming.
- Padrão de espera do dispatcher: use
--kind done/--kind turn_finished(eventos de sistema emitidos pelo trellis), NÃO uma--tagdo usuário como sinal de conclusão. A ajuda da CLI listaphase_done/questioncomo exemplos de--tag, mas apenasinterrupté uma tag reservada com comportamento hardcoded do trellis; as outras são rótulos opacos do usuário. Confiar que um worker executesend --tag <my_signal>é não confiável — workers LLM comumente escrevem a string da tag em prosa em vez de executar o comando CLI real. Vejareferences/command-reference.md"tag vs kind". - Canais de fórum são baseados em eventos. Não analise
events.jsonlprimeiro; useforum,thread,messages --threadecontext list. @mindfoldhq/trellis-coregerencia estado reutilizável de canal/tópico, anexo de eventos, alocação de sequência, projeção de contexto/título, redutores e helpers de tarefa. A CLI gerencia flags, renderização de terminal, prompts, ciclo de vida do worker e saídas de processo.
Arquivos de Referência
references/workflows.md— padrões canônicos de colaboração A–F (brainstorm entre pares, revisão gerada, dispatch-e-espera, captura de issue em fórum, interromper-e-redirecionar, execução única).references/forum.md— canais de fórum, contexto, título, renomear, fóruns de changelog, filtragem de tópicos.references/workers.md— gerar, cartões de agente, injeção de contexto (--file/--jsonl), interrupções, semântica de kill.references/progress-debugging.md— inspeção de progresso/bruto, diagnóstico de worker travado, proteção contra OOM, códigos de saída.references/command-reference.md— referência atual de comandos da CLI (todo subcomando, toda flag, convenções de saída, modelo de escopo/tipo).
Não Para
- Uma revisão estática onde um arquivo markdown e um prompt são suficientes.
- Substituir chamadas normais de ferramentas por auto-registro.
- Recuperação de memória de longo prazo. Use canais de fórum duráveis para issues acionáveis e
trellis mem(a skilltrellis-session-insight) para busca de sessão/histórico.