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 agent 보내기", "agent review 요청", "작업자 생성" | 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(기본값)는 현재 작업 디렉토리의 프로젝트 버킷에서 작동합니다.--scope global은 공유된__global__버킷에서 작동합니다. 의도적으로 범위를 선택하세요. 글로벌 보드는--scope global을 전달하지 않으면 프로젝트 목록에 표시되지 않습니다.- 브레인스토밍의 경우 여러 번의 압박 테스트 라운드를 수행하세요. 하나의 답변과 하나의 확인은 브레인스토밍이 아닌 검토입니다.
- 디스패처 대기 패턴: 완료 신호로 사용자
--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 명령어 참조(모든 하위 명령어, 모든 플래그, 출력 규칙, 범위/유형 모델).
해당 사항 없음
- 마크다운 파일과 프롬프트만으로 충분한 정적 검토 한 번.
- 일반 도구 호출을 자체 로깅으로 대체.
- 장기 기억 검색. 실행 가능한 이슈에는 내구성 있는 포럼 채널을 사용하고, 세션/히스토리 검색에는
trellis mem(trellis-session-insight스킬)을 사용하세요.