Agent Dispatcher
CI
Security
Claude Code와 Codex를 위한 레포지토리 검색 및 컨텍스트 제공.
Agent Dispatcher는 심볼, 소스 텍스트, 코드 관계, 그리고 Git 히스토리를 사용하여 작업에 필요한 코드를 찾습니다. 관련 소스 발췌본을 조립하고, 해당 작업을 전문적인 가이드와 연결하며, 검증 과정을 명확하게 만듭니다. 이 도구를 사용해 레포지토리를 탐색하거나, 실패 원인을 디버깅하거나, 기능을 구축하거나, 변경 사항을 검토할 수 있습니다.
<!-- counts:start -->**27 roles · 79 local skills · 31 external skills · 8 recipes · 19 MCP servers · 50 detection signals**<!-- counts:end -->
Quick start · Usage · Catalog ·
Documentation · Changelog
Quick start
설치 및 인증된 Claude Code 또는 Codex, Git, 그리고 Python 3.10 이상이 필요합니다.
헬퍼들은 Python의 표준 라이브러리를 사용합니다. macOS, Linux 또는 WSL과 같은 Unix 환경을 사용하세요. 네이티브 Windows 설치는 지원하지 않습니다. 일반적인 사용에는 추가 API 키가 필요하지 않습니다.
Codex
터미널에서 실행하세요:
git clone https://github.com/nahid-sparktales/agent-dispatcher.git
cd agent-dispatcher
python3 install_codex.py
프로젝트에서 새로운 Codex 작업을 시작하고 스킬을 호출합니다:
$agent-dispatcher Find why the tests are failing, fix the cause, and verify the fix.
이 명령어는 ~/.agents/skills/agent-dispatcher/에 하나의 스킬을 설치하며, 역할(roles)과 지원 가이드가 필요에 따라 로드됩니다. 업데이트 및 제거 방법은 Codex setup를 참조하세요.
Claude Code
터미널에서 실행하세요:
claude plugin marketplace add nahid-sparktales/agent-dispatcher
claude plugin install agent-dispatcher@agent-dispatcher
프로젝트에서 새로운 Claude Code 세션을 시작합니다:
/agent-dispatcher:agent-dispatcher Find why the tests are failing, fix the cause, and verify the fix.
수동 설치를 선호하십니까? [수동 설정 가이드]를 따르십시오.
사용자 호스트마다 하나의 설치 방법만 사용하십시오. 중복 명령 및 훅(hook)을 방지하기 위함입니다.
일상적인 사용법
Codex에서는 요청 또는 제어 명령어를 $agent-dispatcher 뒤에 추가합니다:
$agent-dispatcher Redesign the settings page and check it on mobile.
$agent-dispatcher reviewer Review this change for correctness and missing tests.
$agent-dispatcher debugger Find why checkout fails after login.
Claude 플러그인 사용자는 라우팅 및 제어를 위해 /agent-dispatcher:agent-dispatcher를 사용하거나, /agent-dispatcher:agent-reviewer와 같은 역할 명령어를 사용합니다. 이 접두사들은 [Claude의 플러그인 명령어 이름]을 따릅니다.
수동 설치는 /agent-dispatcher와 /agent-reviewer를 사용합니다.
| 디스패처 호출 후 추가할 내용 | 기능 설명 |
|---|
context explain | 현재 역할, 기술 및 컨텍스트 선택을 설명합니다. |
| ... | |
자동 활성화는 옵트인(opt-in) 방식입니다. Codex는 /hooks를 통해 훅을 검토하고 신뢰하도록 요구합니다. 선택된 역할은 다른 것을 선택하거나 라우팅을 중지할 때까지 활성 상태로 유지됩니다. | |
| [모든 명령어 및 구성]을 참조하십시오. | |
기능 설명
- 관련 코드를 찾습니다. 검색(Retrieval)은 경로(paths), 심볼(symbols), 소스 텍스트, 스택 추적 프레임(stack-trace frames), 코드 관계(code relationships), 그리고 Git 히스토리를 결합합니다. 경계가 지정된 컨텍스트 패킷(bounded context packet)에는 실제 소스 발췌본과 각 파일이 선택된 이유가 포함됩니다.
- 프로젝트 지식을 재사용합니다. 소스 연결형 프로젝트 맵(Source-linked project maps) 및 프라이빗 캐시(private caches)는 변경되지 않은 증거를 재사용합니다. 명시적으로 구축된 깊은 인덱스(deep index)는 더 넓은 리포지토리 커버리지, 재개 가능한 온보딩(resumable onboarding), 그리고 점진적 새로고침(incremental refresh)을 추가합니다.
- 작업 경험을 활용할 수 있습니다. 명시적으로 기록된 결과(outcomes), 검증 영수증(verification receipts), 수정 사항은 하나의 프라이빗 스토어(private store)를 공유합니다. 리포지토리 메모리(Repository memory)는 또한 적격한 커밋 히스토리와 모듈 요약(module summaries)을 사용할 수 있으며, 검색에 영향을 미치기 전에 신선도 검사(freshness checks)를 거칩니다.
- 작업을 전문가에게 매칭합니다. 역할(Roles)은 엔지니어링, 디자인, 테스트, 리서치, 작성, 운영 등의 영역을 다룹니다. 작고 명확한 수정 사항은 직접적인 경로를 따르지만, 상당한 작업은 전문가의 지도를 받습니다. 독립적인 하위 작업(subtasks)은 승인된 경우 호스트의 하위 에이전트(subagents)를 사용할 수 있습니다.
- 검사 과정을 가시화합니다. 검증 영수증은 통과한 검사, 실패, 테스트 없음, 그리고 검증되지 않은 작업을 구별합니다. 선택적 변경 감사(Optional change audits)는 실제로 변경된 파일을 보고합니다. 응답은 기본적으로 짧고 평이한 언어에 맞춰지며, 저장된 환경 설정(saved preferences)이 표시 방식을 제어합니다.
- 사용 가능한 도구에 적응합니다. 인벤토리 및 상태 검사(Inventory and health checks)는 사용 가능한 기능, 누락된 설정, 그리고 알려지지 않은 연결을 구별합니다. 참조된 외부 스킬과 MCP 통합은 문서화된 폴백(fallbacks)을 갖추고 있습니다.
역할(Roles)은 코딩 에이전트가 채택하는 지침입니다. Claude Code 또는 Codex는 모델, 도구 및 권한 제어 기능을 제공하며, Dispatcher는 호스트의 모델 및 노력 설정(effort settings)을 존중합니다. 이 팩을 설치한다고 해서 외부 서비스에 연결되거나 백그라운드 에이전트가 시작되는 것은 아닙니다.
기본값 및 선택적 기능
표준 검색(Standard retrieval)은 모델 호출이나 네트워크 연결 없이 로컬에서 실행됩니다. 프로젝트 인덱스와 메모리는 작업 트리 외부의 개인 저장소에 유지됩니다. 모델 지원 기능(Model-assisted features)을 사용하려면 자체 구성이 필요하며, 선택한 제공업체(provider)에게 작업 또는 출처 정보를 전송할 수 있습니다.
카탈로그(catalog)에는 번들로 제공되는 스킬과 참조되는 통합 목록이 있습니다. 외부 스킬 및 MCP 서버는 이 패키지에서 설치되지 않습니다. 에이전트의 사용 비용은 여전히 적용됩니다. 선택적 제공업체는 자체적인 접근 권한 및 청구 요구 사항을 가집니다.
문서화 (Documentation)
| 시작하기 | 찾을 수 있는 내용 |
|---|
| 사용법 및 구성 | 명령어, 출력 환경 설정(output preferences), 컨텍스트 제어, 활성화 및 제거 방법. |
| ... | |
기여 (Contributing)
버그 보고서, 라우팅 예제, 그리고 집중적인 기여가 환영됩니다. 표준 출처 및 생성된 파일은 CONTRIBUTING.md를 읽고, 다음을 실행하세요:
python3 build.py
python3 -B -m tests
이 검사들은 제공업체 자격 증명 없이 오프라인으로 실행됩니다. 패키지를 확장하려면 역할 추가(adding a role) 또는 스킬 추가(adding a skill)를 참조하세요. 취약점은 SECURITY.md를 통해 보고해 주세요.
라이선스 (License)
MIT. 역할의 출처, 각색 및 기여에 대한 내용은 NOTICE를 참고하세요. 참조된 타사 스킬들은 자체적인 라이선스를 유지합니다. 본 프로젝트는 독립적이며 OpenAI, Anthropic 또는 Locus와 제휴하거나 보증되지 않습니다.