trellis-channel
trellis channel は、ローカルでのマルチエージェントコラボレーションのためのランタイムです。エージェントが永続的なイベントログを介して通信する必要がある場合、ワーカーをピアプロセスとしてスポーンする場合、実行中のワーカーへの割り込みやデバッグが必要な場合、またはフィードバックを永続的な --type forum チャンネルに記録する場合に使用します。
典型的なユーザーシグナル: "和 codex/claude 讨论"、"別のエージェントとブレインストーミング"、"implement/check ワーカーをスポーン"、"エージェントにレビューさせる"、"イシューボード/チェンジログフォーラムを開く"、"このスレッドを見る"、"チャンネルが詰まった/出力がない"、"進捗が途中で切れた"、"そのチャンネルコマンドの書き方"。
このスキルはインデックスです。現在のジョブに必要な参照ファイルのみを読み込んでください。すべてをプリロードしないでください。
最初のコマンド
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 |
| "implement/check エージェントを派遣する"、"エージェントにレビューさせる"、"ワーカーをスポーン" | references/workflows.md、次に references/workers.md |
| "イシューエリア/トピックグループ/チェンジログ/ボードを開く"、"フォーラムを作る" | references/forum.md |
| "このスレッド/リンクされたコンテキストを見る"、"スレッドを調査" | references/forum.md |
| "チャンネルが詰まった/出力がない/進捗が切れた"、"ワーカーが停止" | references/progress-debugging.md |
| "具体的なコマンドの書き方"、"X はどんなフラグを取るか" | references/command-reference.md |
コアルール
- 新しいフォーラムチャンネルは
--type forumを使用します。threadはフォーラムチャンネル内の1つのアイテムです。 --context-file/--context-rawおよびtrellis channel context add/delete/listを使用します。--linked-context-*は非推奨の用語です。- 長いメッセージには
--stdinまたは--text-fileを使用します。長い日中混合テキストを位置引数のシェル引数に入れないでください。 messagesの整形出力はオペレーターダッシュボードであり、進捗を切り詰める可能性があります。監査には--rawを使用してください。--asはコマンドに応じて、話し手またはワーカーハンドルです。複数のエージェントやセッションが関与する場合は、明示的で安定した名前を使用してください。--scope project(デフォルト) は現在のカレントディレクトリのプロジェクトバケットに対して動作します。--scope globalは共有の__global__バケットに対して動作します。スコープは意図的に選択してください。グローバルボードは、--scope globalを渡さない限りプロジェクトの一覧には表示されません。- ブレインストーミングでは、複数回のプレッシャーテストラウンドを実施してください。1つの回答と1つの確認はレビューであり、ブレインストーミングではありません。
- ディスパッチャー待機パターン: 完了シグナルとして、ユーザーの
--tagではなく、--kind done/--kind turn_finished(trellisが発行するシステムイベント) を使用してください。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は、再利用可能なチャンネル/スレッド状態、イベント追記、シーケンス割り当て、コンテキスト/タイトルのプロジェクション、リデューサー、タスクヘルパーを所有します。CLIはフラグ、ターミナルレンダリング、プロンプト、ワーカーのライフサイクル、プロセスの終了を所有します。
参照ファイル
references/workflows.md— 標準的なコラボレーションパターン A～F (ピアブレインストーミング、スポーンされたレビュー、ディスパッチ＆ウェイト、フォーラムイシューキャプチャ、割り込み＆リダイレクト、ワンショット実行)。references/forum.md— フォーラムチャンネル、コンテキスト、タイトル、名前変更、チェンジログフォーラム、スレッドフィルタリング。references/workers.md— スポーン、エージェントカード、コンテキストインジェクション (--file/--jsonl)、割り込み、強制終了のセマンティクス。references/progress-debugging.md— 進捗/生データの調査、停止したワーカーの診断、OOMガード、終了コード。references/command-reference.md— 現在のCLIコマンドリファレンス (すべてのサブコマンド、すべてのフラグ、出力規則、スコープ/タイプモデル)。
対象外
- マークダウンファイルとプロンプトだけで十分な、静的な1回限りのレビュー。
- 通常のツール呼び出しを自己ログに置き換えること。
- 長期記憶の検索。アクション可能なイシューには永続的なフォーラムチャンネルを、セッション/履歴の検索には
trellis mem(trellis-session-insightスキル) を使用してください。