Agent Native — 병렬 워커 디스패치 & 역할 계약
독립적인 작업을 여러 에이전트 워커에 병렬로 나눠 보내고, 역할·쓰기 범위·증거 기록 규칙을 엄격히 강제하는 멀티 에이전트 운영 스킬.
자동화·워크플로고급★ 446⑂ 42AI 점수 7/10마지막 업데이트: 2026. 9. 26.
무엇을 해주나
- 서로 겹치지 않는(disjoint) 작업 패킷을 병렬 워커나 지정된 영속 역할 세션에 디스패치하는 절차를 정의합니다.
- 역할을 명확히 분리합니다: Orchestrator(의도·범위 전달, 최종 검토 담당자 지정), Implementer(자기 패킷 범위만 수정), Validator(읽기 전용 새 컨텍스트에서 판정), Scribe(런타임 증거 기록). 여기에 값싼 위임인 Reader/Writer(최대 350줄 슬라이스, 참조 파일 필수)를 둡니다.
- 배치 실행 전에 모든 패킷을 검증하도록 강제합니다: 실행자 지정, 패킷 식별자, 심볼릭 링크 해석·경로 정규화·대소문자 무시 비교로 쓰기 범위 충돌 탐지.
- "프롬프트를 성공적으로 보냈다 = 워커가 일하고 있다"는 착각(prompt-send optimism)과, 무응답 워커를 먼저 재시작해 증거를 날리는 안티패턴을 금지합니다.
- 워커 세션/컨텍스트 ID는 관찰된 값만 기록하고, 요청한 ID를 관찰된 ID로 취급하지 않도록 합니다. 실패·미확인 상태도 그대로 보존해 보고합니다.
이런 분께 추천
- AgentOps 계열 워크플로우나 Codex 네이티브 역할(
bulk-reader,code-writer)을 실제로 운용하는 분 - 여러 에이전트를 동시에 돌리며 쓰기 충돌·중복 실행·유령 워커 문제로 고생한 분
- 검증(Validate)과 실행을 분리한 엄격한 감사·증거 체계를 원하는 고급 사용자
활용 예시
- 서로 다른 디렉터리를 담당하는 3개의 구현 패킷을 만들고, 발사 전에 쓰기 범위 충돌 검사를 통과시킨 뒤 한 번씩만 디스패치.
- 대용량 파일 분석을 Reader에게 350줄 단위로 위임해 부모 컨텍스트에 파일 내용을 올리지 않고 줄 번호 기반 요약만 받기.
- 워커가 응답하지 않을 때, 재시작 대신 먼저 네이티브 상태를 관찰·기록하고 권한 범위 안에서 nudge 또는 교체를 선택.
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/boshu2/agentops/HEAD/skills-codex/agent-native/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 boshu2/agentops 의 skills-codex/agent-native 폴더를 내 ~/.claude/skills/boshu2-agent-native/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/boshu2/agentops.git && mkdir -p ~/.claude/skills && cp -r agentops/skills-codex/agent-native ~/.claude/skills/agent-native⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 엽니다.
- 저장소를 내려받습니다:
git clone https://github.com/boshu2/agentops.git - 스킬 폴더를 만듭니다:
mkdir -p ~/.claude/skills - 스킬을 복사합니다:
cp -r agentops/skills-codex/agent-native ~/.claude/skills/agent-native references/하위 문서(model-dispatch.md, session-associations.md 등)가 함께 복사됐는지 확인합니다. 없으면 저장소에서 해당 경로를 다시 복사하세요.- 배치 스크립트
scripts/swarm/dispatch_once.py는 AgentOps 소스 체크아웃이 필요한 개발용 참조이며 스킬 단독 설치에는 포함되지 않습니다. 필요하면 클론한 저장소를 그대로 유지하세요. - Claude Code를 재시작하고 "병렬 워커에 작업을 나눠 디스패치해줘" 같이 요청하면 스킬이 발동합니다.
GitHub에서 원본 보기 ↗라이선스: Apache-2.0