do fast ted/AgentDock

trellis-channel

trellis channel est l'environnement d'exécution de collaboration multi-agent locale. Utilisez-le lorsque des agents doivent communiquer via un journal d'événements durable, lorsqu'un travailleur doit être généré en tant que processus pair, lorsqu'un travailleur en cours a besoin d'une interruption ou d'un débogage, ou lorsqu'un retour doit être enregistré sur un canal durable de --type forum.

Signaux utilisateur typiques : "和 codex/claude 讨论", "brainstorm with another agent", "spawn an implement/check worker", "let agent review", "open an issue board / changelog forum", "look at this thread", "channel is stuck / no output", "progress was truncated", "how do I write that channel command".

Cette compétence est un index. Chargez uniquement le fichier de référence pour la tâche en cours — ne préchargez pas tous les fichiers.

Premières commandes

trellis --version
trellis channel --help
trellis channel list --all
trellis channel list --scope global --all

Si l'utilisateur nomme un canal ou un fil de discussion, inspectez-le avant de demander le contexte :

trellis channel forum <board> --scope global
trellis channel thread <board> <thread> --scope global
trellis channel context list <board> --scope global --thread <thread>

Routage par intention utilisateur

Intention utilisateur	Lire
"和 codex/claude 讨论一下", "brainstorm with another agent"	references/workflows.md
"派一个 implement/check agent", "让 agent review", "spawn a worker"	references/workflows.md, puis references/workers.md
"开 issue 区 / topic 群 / changelog / board", "make a forum"	references/forum.md
"看看这个 thread / linked context", "inspect a thread"	references/forum.md
"channel 卡住了 / 没输出 / progress 被截断", "worker stalled"	references/progress-debugging.md
"具体命令怎么写", "what flags does X take"	references/command-reference.md

Règles fondamentales

• Les nouveaux canaux de forum utilisent --type forum. Un thread est un élément à l'intérieur d'un canal de forum.
• Utilisez --context-file / --context-raw et trellis channel context add/delete/list. --linked-context-* est une terminologie obsolète.
• Utilisez --stdin ou --text-file pour les messages longs. Ne mettez pas de texte long mélangé chinois/anglais dans l'argument shell positionnel.
• La sortie messages formatée est un tableau de bord opérateur et peut tronquer la progression. Utilisez --raw pour un audit.
• --as est le nom du locuteur ou du travailleur, selon la commande. Utilisez des noms explicites et stables lorsque plusieurs agents ou sessions sont impliqués.
• --scope project (par défaut) opère sur le bucket du projet dans le répertoire de travail courant ; --scope global opère sur le bucket partagé __global__. Choisissez la portée délibérément — un tableau global est invisible dans les listes de projets à moins que --scope global ne soit passé.
• Pour le brainstorming, effectuez plusieurs tours de test de pression. Une réponse plus une confirmation est une révision, pas un brainstorming.
• Modèle d'attente du répartiteur (dispatcher) : utilisez --kind done / --kind turn_finished (événements système émis par trellis), PAS un --tag utilisateur comme signal d'achèvement. L'aide CLI liste phase_done / question comme exemples de --tag, mais seul interrupt est un tag réservé avec un comportement trellis codé en dur ; les autres sont des étiquettes utilisateur opaques. Se fier à un travailleur pour exécuter send --tag <my_signal> n'est pas fiable — les travailleurs LLM écrivent couramment la chaîne de tag en prose au lieu d'exécuter la commande CLI réelle. Voir references/command-reference.md "tag vs kind".
• Les canaux de forum sont basés sur des événements. N'analysez pas events.jsonl en premier ; utilisez forum, thread, messages --thread et context list.
• @mindfoldhq/trellis-core possède l'état réutilisable des canaux/threads, l'ajout d'événements, l'allocation de séquence, la projection de contexte/titre, les réducteurs et les assistants de tâche. Le CLI possède les drapeaux, le rendu terminal, les invites, le cycle de vie des travailleurs et les sorties de processus.

Fichiers de référence

• references/workflows.md — modèles de collaboration canoniques A–F (brainstorming pair, révision générée, dispatch et attente, capture de problème de forum, interruption et redirection, exécution unique).
• references/forum.md — canaux de forum, contexte, titre, renommage, forums de journal des modifications, filtrage de threads.
• references/workers.md — génération, fiches agent, injection de contexte (--file / --jsonl), interruptions, sémantique d'arrêt.
• references/progress-debugging.md — inspection de progression/brute, diagnostic de travailleur bloqué, garde OOM, codes de sortie.
• references/command-reference.md — référence actuelle des commandes CLI (chaque sous-commande, chaque drapeau, conventions de sortie, modèle de portée/type).

Pas pour

• Une révision statique unique où un fichier markdown et une invite suffisent.
• Remplacer les appels d'outils normaux par un auto-journalisation.
• La récupération de mémoire à long terme. Utilisez les canaux de forum durables pour les problèmes actionnables, et trellis mem (la compétence trellis-session-insight) pour la recherche de session/historique.