trellis-channel

trellis-channel

trellis channel は、ローカルで複数のエージェントが連携するためのランタイムです。エージェント同士が永続的なイベントログを介してやり取りする必要があるとき、ワーカーをピアプロセスとして起動したいとき、実行中のワーカーに割り込みやデバッグを行う必要があるとき、または永続的な --type forum チャンネルにフィードバックを記録したいときに使用します。

典型的なユーザーの要望：「和 codex/claude 讨论」、「別のエージェントとブレインストーミングする」、「実装／確認ワーカーを起動する」、「エージェントにレビューさせる」、「課題ボード／変更履歴フォーラムを開く」、「このスレッドを見る」、「チャンネルが停止した／出力がない」、「進捗が途中で切れた」、「そのチャンネルコマンドの書き方」。

このスキルは索引です。現在の作業に必要なリファレンスファイルだけを読み込み、すべてを事前に読み込まないでください。

最初に実行するコマンド

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 讨论一下」、「別のエージェントとブレインストーミングする」	references/workflows.md
「実装／確認エージェントを割り当てる」、「エージェントにレビューさせる」、「ワーカーを起動する」	references/workflows.md、続けて references/workers.md
「課題エリア／トピックのグループ／変更履歴／ボードを開く」、「フォーラムを作成する」	references/forum.md
「このスレッド／リンクされたコンテキストを見る」、「スレッドを確認する」	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 を使用します。長い中国語と英語の混在テキストを、シェルの位置引数に入れないでください。
• 整形された messages の出力はオペレーターダッシュボード用であり、進捗が途中で切れることがあります。監査には --raw を使用します。
• --as はコマンドに応じて、発言者またはワーカーハンドルを指定します。複数のエージェントやセッションが関わる場合は、明示的で一貫した名前を使用します。
• --scope project（デフォルト）は現在の cwd のプロジェクト用バケットを操作し、--scope global は共有の __global__ バケットを操作します。スコープは意図的に選択してください。グローバルボードは --scope global を指定しない限り、プロジェクトの一覧には表示されません。
• ブレインストーミングでは、複数回にわたって徹底的に検証します。回答と確認がそれぞれ1回だけなら、それはレビューであり、ブレインストーミングではありません。
• ディスパッチャーの待機パターン：完了シグナルにはユーザーの --tag ではなく、--kind done／--kind turn_finished（trellis が生成するシステムイベント）を使用してください。CLI のヘルプには phase_done／question が --tag の例として記載されていますが、trellis の動作がハードコードされている予約済みタグは interrupt だけです。それ以外は不透明なユーザーラベルです。ワーカーが send --tag <my_signal> を実行することに依存するのは信頼できません。LLM ワーカーは、実際の CLI コマンドを実行せず、タグ文字列を文章に書き込むことがよくあります。references/command-reference.md の「tag vs kind」を参照してください。
• フォーラムチャンネルはイベントソーシング方式です。最初に events.jsonl を解析せず、forum、thread、messages --thread、context list を使用してください。
• 再利用可能なチャンネル／スレッドの状態、イベントの追加、seq の割り当て、コンテキスト／タイトルの投影、リデューサー、タスクヘルパーは @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 スキル）を使用してください。