중지. 엔드포인트를 호출하기 전에 이 SKILL.MD 전체를 읽으십시오.
Agent Inbox
파일 기반 에이전트 간 메시징 시스템으로, 헤드리스 디스패치와 task-monitor 통합을 지원합니다.
핵심 워크플로
- 전송: 에이전트 A가 프로젝트 B로 모델 및 검증 명령과 함께 버그/요청을 보냅니다.
- 분류: AI가 심각도를 분류하고, 우선순위/모델을 조정한 후 프로젝트로 라우팅합니다.
- 디스패치: 지정된 모델로 헤드리스 에이전트가 생성되어 문제를 수정합니다.
- 추적: Task-monitor가 실시간 진행률을 표시합니다(0% → 25% → 50% → 75% → 100%).
- 검증: 자동 확인 전에 테스트 명령이 실행됩니다. 실패 시 에이전트로 다시 루프백됩니다.
- 스레드: 다중 메시지 대화를 위한 답장/교환 스레딩을 지원합니다.
설정
# 프로젝트 등록 (최초 한 번)
.pi/skills/agent-inbox/agent-inbox register memory /home/user/workspace/memory
.pi/skills/agent-inbox/agent-inbox register scillm /home/user/workspace/litellm
# 목록 / 확인
.pi/skills/agent-inbox/agent-inbox projects
.pi/skills/agent-inbox/agent-inbox whoami
명령어
| 명령어 | 설명 |
|---|---|
register <이름> <경로> | 프로젝트 등록 |
unregister <이름> | 프로젝트 제거 |
projects [--json] | 등록된 프로젝트 목록 표시 |
whoami | 현재 작업 디렉토리(cwd)의 감지된 프로젝트 표시 |
send --to PROJECT --type TYPE "메시지" | 메시지 전송 (유형: bug, request, info, question) |
check [--project P] [--all] [--quiet] | 받은 편지함 확인 |
list [--project P] [--status S] [--json] | 메시지 목록 표시 |
read MSG_ID [--json] | 메시지 읽기 |
ack MSG_ID [--note "..."] | 확인/완료 |
reply MSG_ID "메시지" | 답장 (자동 스레드) |
thread THREAD_ID | 전체 교환 스레드 보기 |
update-status MSG_ID 상태 [--note] | 상태 수동 업데이트 |
triage classify --message "..." [--no-llm] | 수동 분류 |
triage route --message "..." | 파일 경로 기반 자동 라우팅 |
triage log --msg-id ID | 분류 결정 로그 보기 |
triage webhook-add --url URL --events E | 웹훅 등록 |
전송 옵션
| 옵션 | 설명 | 기본값 |
|---|---|---|
--model MODEL | AI 모델: sonnet, opus-4.5, codex-5.2, codex-5.2-high | sonnet |
--timeout MINUTES | 최대 에이전트 작업 시간 | 30 |
--test COMMAND | 자동 확인 전 검증 명령 | 없음 |
--no-dispatch | 자동 스폰 비활성화 | False |
--context-file FILE | 컨텍스트로 파일 첨부 (반복 가능) | 없음 |
--priority PRIORITY | low, normal, high, critical | normal |
--no-triage | AI 분류 건너뛰기 | False |
--dry-run | 전송 없이 메시지 JSON 표시 | False |
모델 선택
| 모델 | 사용 사례 |
|---|---|
sonnet | 간단한 수정, 오타 |
opus-4.5 | 복잡한 분석, 아키텍처 |
codex-5.2 | 표준 버그 수정 |
codex-5.2-high | 심층 추론, 경쟁 조건 |
AI 분류
메시지는 심각도에 따라 자동 분류됩니다:
- critical: 크래시, 데이터 손실, 보안, 프로덕션 다운 →
opus-4.5 - high: 오류, 예외, 실패, 중단, 회귀 →
opus-4.5 - medium: 버그, 문제, 부정확, 예상치 못한 →
sonnet - low: 오타, 미관상, 개선, 사소한 →
sonnet
자동 라우팅은 메시지에서 파일 경로를 추출하고 등록된 프로젝트와 일치시킵니다.
상태 진행
pending → dispatched (25%) → in_progress (50%) → needs_verification (75%) → done (100%)
메모리 사전 후크
디스패처는 에이전트를 생성하기 전에 /memory를 조회하여 유사한 버그와 이전 해결책을 찾습니다.
사전 확인
에이전트는 세션 시작 시, 프로젝트 전환 시, 주요 작업 전, 그리고 사용자가 다른 에이전트나 프로젝트를 언급할 때 받은 편지함을 확인해야 합니다.
저장소
~/.agent-inbox/
├── pending/ # 처리되지 않은 메시지
├── done/ # 확인된 메시지
├── logs/ # 디스패치 로그
├── task_states/ # Task-monitor 상태 파일
├── triage_logs/ # AI 분류 결정 로그
├── webhooks.json # 등록된 웹훅
└── projects.json # 프로젝트 레지스트리
예시
# 검증 명령과 함께 버그 전송 (헤드리스 Opus 에이전트 스폰, 테스트 통과 시 자동 확인)
python inbox.py send --to scillm --type bug --model opus-4.5 \
--test "pytest tests/test_providers.py -x" \
"공급자 초기화의 경쟁 조건"
# 컨텍스트 파일 첨부
python inbox.py send --to scillm --type bug --model opus-4.5 \
--context-file src/server.py --context-file /tmp/traceback.txt \
"서버 시작 시 크래시"
# 받은 편지함 확인 및 처리
python inbox.py check --all
python inbox.py read scillm_abc123
python inbox.py ack scillm_abc123 --note "커밋 abc123에서 수정됨"
# 스레드 교환
python inbox.py reply scillm_abc123 "스택 트레이스를 제공해 주시겠습니까?"
python inbox.py thread scillm_abc123
디스패처 데몬
python dispatcher.py start # 백그라운드
python dispatcher.py start --foreground # 디버그
python dispatcher.py status
python dispatcher.py stop
환경 변수
| 변수 | 설명 | 기본값 |
|---|---|---|
AGENT_INBOX_DIR | 받은 편지함 디렉토리 | ~/.agent-inbox |
TASK_MONITOR_API_URL | Task-monitor URL | http://localhost:8765 |
CLAUDE_PROJECT | 현재 프로젝트 이름 | 자동 감지 |
Claude Code 후크와의 통합
{
"hooks": {
"on_session_start": [
".pi/skills/agent-inbox/agent-inbox check --project $(basename $PWD) || true"
]
}
}