amElnagdy/delegate-skills

delegate‑skills – AI 기반 코드 구현자 오케스트레이션

정의 – 다양한 LLM 기반 코드 생성 CLI(Codex, Claude, Cursor, Aider 등)를 단일 일관된 워크플로우에 연결할 수 있는 스킬(작은 Node.js 스크립트) 모음입니다. 이 패키지에는 LLM 자체는 포함되어 있지 않으며, 이미 설치된 CLI를 검색하고, 이름이 지정된 레인(예: feature, tests, ui)으로 그룹화한 다음, 검토 루프를 유지하면서 작업을 적절한 CLI에 디스패치합니다.

중요성 – 개발자는 종종 각각 고유한 명령줄 인터페이스와 특성을 가진 여러 AI 코딩 어시스턴트를 사용합니다. delegate-skills는 통합된 프런트엔드를 제공합니다:

• 머신의 CLI를 자동 감지하고 플릿 구성을 생성하는 단일 명령(delegate-setup).
• 레인별 위임(*-delegate --lane <name>)으로 동일한 JSON 결과 형식, 읽기 전용 안전 모드, 커밋 전 필수 수동 검토를 보장합니다.
• 숨겨진 네트워크 호출이나 텔레메트리 없음 – 스크립트는 선택한 CLI와 git만 실행하는 순수 Node 내장 기능입니다.

작동 방식

1. 설정 – $delegate-setup을 실행합니다. PATH에서 지원되는 CLI를 스캔하고, 플릿(레인 → 구현자 + 선택적 플래그 매핑)을 제안하고, 전체 구성을 표시한 후 승인한 경우에만 기록합니다.
2. 디스패치 – $codex-delegate --lane feature 또는 $cursor-delegate와 같은 스킬을 직접 사용합니다. 스킬은 작은 relay.mjs 스크립트를 호출하여 다음을 수행합니다:
   • 브리프(제공한 작업 설명)를 작성합니다.
   • 대상 CLI를 헤드리스 모드로 실행합니다.
   • 출력, git diff, delegate-relay.result.v1 계약(상태, exitCode, touchedFiles, 세션 ID 등)을 따르는 result.json을 캡처합니다.
3. 검토 – diff를 검사하고, 프로젝트별 게이트를 실행하고, 커밋 여부를 결정합니다. 릴레이는 커밋하지 않습니다. 커밋은 항상 수동 단계입니다.
4. 완료 – 승인 후 변경 사항을 git commit합니다.

지원되는 구현자 – 리포지토리에는 다음 각 CLI에 대한 즉시 사용 가능한 스킬이 포함되어 있습니다(README의 표에 플래그, 읽기 전용 모드, 재개 기능이 나열됨):

• Aider, Antigravity(agy), Claude Code, Cline, OpenAI Codex, Command Code, Cursor Agent, Grok Build, Kimi Code, Muse Code, OpenCode, Pi, Oh-My-Pi, Qoder, Mistral Vibe, GitHub Copilot CLI, Warp Agent, Z.AI ZCode.
• 각 스킬의 SKILL.md에는 필요한 설치, 인증 및 주의 사항(예: CLI가 실제 읽기 전용 모드를 지원하는지 여부)이 문서화되어 있습니다.

안전 보장

• 자동 커밋 없음 – 릴레이는 diff만 작성하며, 커밋은 수동으로 해야 합니다.
• 읽기 전용/계획 모드 – 대부분의 스킬은 파일 시스템 변경 도구를 허용하지 않는 "드라이 런"에서 CLI를 실행하는 플래그를 노출합니다.
• 권한 투명성 – 릴레이는 readOnlyViolation 및 readOnly 플래그를 보고하여 CLI가 부적절하게 쓰기를 시도했는지 알려줍니다.
• 런타임 종속성 없음 – Node 내장 기능만 사용하며, 스크립트 자체가 외부 서비스에 연락하지 않습니다.

설치 – Vercel Skills CLI 사용:

npx skills add amElnagdy/delegate-skills          # 전체 패키지
npx skills add amElnagdy/delegate-skills --skill delegate-setup   # 설정 스킬만
npx skills add amElnagdy/delegate-skills --skill codex-delegate   # 단일 구현자

전역 또는 에이전트별로 설치하고 특정 버전 태그에 고정할 수 있습니다.

일반적인 사용 사례

# 1️⃣ CLI를 검색하고 플릿 생성
$delegate-setup
# → 프롬프트가 표시되고 .skills/delegate-fleet.json을 작성

# 2️⃣ Codex에 할당한 레인을 사용하여 모듈 리팩토링을 LLM에 요청
$codex-delegate --lane feature "Refactor services/billing to use the new pricing model"

# 3️⃣ 표시된 diff를 검토하고 테스트 실행 후 커밋
git diff && npm test && git commit -am "refactor billing"

사용 대상 – 이미 하나 이상의 AI 코딩 어시스턴트에 의존하고, 최종 커밋을 사람의 통제 하에 유지하면서 작업을 가장 적합한 도구로 라우팅하는 재현 가능하고 감사 가능한 방법을 원하는 개발자.

---

위의 모든 세부 정보는 리포지토리의 README에서 직접 가져온 것이며, 추가 기능은 추론되지 않았습니다.