Community라이팅 & 에디팅github.com

薪尽火传 · Agent Relay

AI 에이전트를 위한 검증 가능한 작업 인계 프로토콜입니다. Codex, TRAE, Claude, Cursor 등 플랫폼 간에 상태, 산출물, 소유권 및 승인 기준을 전달합니다.

薪尽火传 · Agent Relay란 무엇인가요?

Agent Relay는 서로 다른 AI 에이전트 간의 안전하고 검증 가능한 작업 인계를 가능하게 하는 프로토콜입니다. Codex, TRAE, Claude, Cursor 등 여러 플랫폼에서 상태, 산출물, 소유권 및 승인 기준을 전달하여 작업이 중단 없이 이어지도록 보장합니다. 이 스킬은 `context`(문맥 확인), `offer`(인계 제안), `accept`(인계 수락), `heartbeat`(장기 작업 하트비트), `complete`(완료), `verify`(검증) 등 명확한 액션 세트를 제공하여 작업 흐름을 구조화합니다. 특히 검증 메커니즘을 통해 각 인계가 명확한 승인 기준과 산출물 증거를 포함하도록 강제하여 에이전트 간 협업의 신뢰성과 추적 가능성을 크게 향상시킵니다.

지원 대상✓Claude Code✓Codex CLI✓Cursor
npx skills add TongyiDai/xinjin-huochuan

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

薪尽火传 · Agent Relay은(는) 무엇을 하나요?

에이전트를 바꿔도 작업이 끊기지 않습니다. Memory Hub는 내부 저장소 계층이고, Relay가 바로 제품 계층입니다.

강제 첫 단계

이 Skill을 트리거한 후에는 먼저 Relay Context를 읽으십시오. 프로젝트 디렉토리, Skill 파일 또는 Home 디렉토리를 먼저 스캔하지 마십시오.

  1. MCP 도구 relay_context를 우선 호출하되, 매개변수로 현재 프로젝트 경로와 현재 Agent 이름을 전달합니다.
  2. MCP를 사용할 수 없는 경우 agent-relay context --agent <name> --project "$PWD"를 실행합니다.
  3. Context가 특정 산출물을 가리킨 후에만 해당 산출물을 열어 현장 검증을 수행합니다.

Relay Context를 대체하기 위해 find /, 전체 디렉토리 스캔 또는 원본 세션 로그를 사용하지 마십시오.

액션 선택

사용자 의도액션
"계속", "이어서", "다른 Agent가 무엇을 했는지 확인"context 또는 resume --no-mark, inbox 확인
"Codex/Claude/TRAE에게 전달"offer
인계 받아 시작accept
장기 작업 진행 중heartbeat
완료 및 증거 첨부complete
인계 측이 완료 확인verify
계속할 수 없음fail 또는 reject
인계 취소cancel
일반 단계 기록capture

agent-relay 명령어를 사용하십시오. 이전 memory-hub는 호환성을 위한 진입점일 뿐입니다.

인계 받기

  1. 현재 프로젝트와 인계 대기열을 읽습니다.
  2. 인계 측이 참조한 실제 산출물을 엽니다.
  3. 산출물이 없거나 변경된 경우, 바로 인계를 받지 말고 먼저 차이점을 설명합니다.
  4. 실행 가능함을 확인한 후 accept를 수행합니다.
  5. 사용자에게 Hub에 이미 기록된 배경을 다시 설명하도록 요구하지 않습니다.
agent-relay context --agent codex --project "$PWD"
agent-relay inbox --agent codex --project "$PWD"
agent-relay accept \
  --relay relay-xxxx \
  --agent codex \
  --summary "입력 산출물 확인 완료, 인계 시작"

읽기 전용 샌드박스에서 먼저 실행하십시오:

agent-relay resume --agent codex --project "$PWD" --no-mark

인계 넘기기

인계 시에는 명확한 승인 기준이 반드시 포함되어야 합니다. 실제 산출물 경로 또는 재확인 가능한 출처를 제공하십시오. "완료했습니다"라고만 적지 마십시오.

agent-relay offer \
  --project "$PWD" \
  --from-agent trae \
  --to-agent codex \
  --summary "구현 완료, Codex에게 경계 검증 인계" \
  --acceptance "모든 테스트 통과" \
  --acceptance "민감 정보 없음" \
  --artifact "/path/to/implementation" \
  --source-ref "test: integration suite passed" \
  --priority high

기본적으로 인계 제안은 7일 동안 수신되지 않으면 자동 만료됩니다. 인계 수락 후 기본 임대 시간은 1시간입니다. 장기 작업은 정기적으로 임대를 갱신하십시오:

agent-relay heartbeat \
  --relay relay-xxxx \
  --agent codex \
  --summary "경계 테스트 진행 중"

완료 및 승인

인계 수신 측이 완료할 때는 반드시 증거를 첨부해야 합니다:

agent-relay complete \
  --relay relay-xxxx \
  --agent codex \
  --summary "경계 검증 완료" \
  --artifact "/path/to/test-results.json"

승인 측은 각 기준을 하나씩 확인하고 산출물을 대조합니다:

agent-relay verify \
  --relay relay-xxxx \
  --agent trae \
  --summary "산출물 및 승인 기준 모두 확인 완료" \
  --accept-all-criteria

completed는 아직 완료된 것이 아닙니다. 오직 verified여야 한 번의 인계가 완료된 것으로 간주됩니다.

기록 경계

  • 전체 채팅, 비밀번호, 토큰, API Key 또는 필터링되지 않은 개인 데이터를 저장하지 않습니다.
  • 추측을 사실로 기록하지 않습니다. 이전 이벤트를 수정하지 않고 정정 기록을 추가합니다.
  • 단일 Agent, 단일 라운드, 후속 가치가 없는 작업은 Relay에 기록하지 않습니다.
  • Relay는 Git, 비즈니스 버전 관리 또는 여러 사용자가 동시에 편집하는 파일 잠금을 대체하지 않습니다.
  • 실제 환경 검증이 기억된 내용보다 우선합니다.

전체 상태 머신, 의존성 체인, 산출물 지문, 충돌 및 개인 정보 보호 규칙은 references/protocol.md를 참조하십시오.

관련 스킬