Communitygithub.com

搭子.skill (Partner)

Claude Code가 계획, 다듬기, 검토를 담당하고 Codex가 구현, 모니터링, 검수를 담당하는 2-에이전트 코딩 워크플로우입니다. 동일 세션 영수증으로 Claude 콜드 스타트 낭비를 증명합니다.

搭子.skill (Partner)란 무엇인가요?

이 스킬은 개발자가 Claude Code와 Codex라는 두 개의 AI 에이전트를 협력시켜 코드를 작성하고 검토하는 효율적인 워크플로우를 제공합니다. Claude Code는 아키텍처 계획, UI/상호작용 다듬기, 최종 코드 검토와 같이 높은 가치의 사고 작업에 집중하고, Codex는 실제 구현, 테스트, 모니터링을 담당합니다. 핵심은 하나의 긴 Claude Code 세션을 유지하여 컨텍스트 재사용을 극대화하고 API 비용을 절감하는 것입니다. 작은 작업의 경우 계획 → 구현 → 다듬기 → 검토의 모든 단계를 단일 세션에서 처리할 수 있습니다. 이 워크플로우는 `claude --permission-mode plan`, `/goal`, `/codex:review`와 같은 Claude Code의 특수 명령어를 활용하며, 권한 정책과 라우팅 규칙을 통해 작업이 올바른 에이전트에 할당되도록 합니다. 또한 모니터링 지표, 출력 계약(Partner Session Receipt 포함), Darwin-style 래칫 검증 게이트를 통해 워크플로우의 품질과 투명성을 보장합니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add LearnPrompt/partner-skill

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

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

문서

搭子.skill (파트너)

나의 Claude Code와 Codex는 최고의 콤비입니다.

개요

이 스킬은 2-에이전트 코딩 워크플로우를 실행합니다. Claude Code는 높은 가치의 계획, 다듬기, 검토 에이전트이고, Codex는 외부 조정자이자 주요 구현자입니다. Claude Code 사용량은 API를 통해 과금될 수 있으므로 집중적으로 사용하세요.

중소형 작업의 경우 하나의 장기 Claude Code 세션을 선호합니다. Claude에게 계획을 요청하고, Codex가 구현한 다음, diff 요약과 주요 파일을 동일한 Claude 세션으로 보내 UI/상호작용 다듬기와 최종 /codex:review를 수행하세요. 이렇게 하면 동일한 프로젝트 컨텍스트를 재구축하는 데 Claude를 사용하지 않아도 되고 Claude가 작업을 개선할 수 있는 충분한 연속성을 확보할 수 있습니다.

파트너는 위임을 위한 핑계가 아닙니다. 사용자는 여전히 소유자이며, Codex는 저장소 증거에 대한 책임을 지고, Claude Code는 출력을 검증해야 하는 고가치 협력자로 취급됩니다.

기본 흐름

  1. 대상 저장소에서 기반을 다집니다.

    • agent-workbench 루트가 아닌 실제 프로젝트 디렉토리로 들어갑니다.
    • Claude Code를 시작하기 전에 git status --short를 실행합니다.
    • 작업이 그린필드, 기능 중심, UI 중심, 검토 전용, 또는 디버깅인지 식별합니다.
  2. 고비용 사고 루프를 위해 하나의 Claude Code 세션을 시작합니다.

    • 계획 수립: PTY에서 Claude Code를 시작하고 목표를 설정합니다.
    • 기본값으로 claude --permission-mode plan --name <task-name>을 사용합니다.
    • 대화형 세션에서 /goal <clear completion condition>을 보냅니다.
    • Claude Code에 구체적인 구현 계획, 승인 기준, UI/상호작용 가이드를 요청합니다.
    • 작업이 너무 크지 않은 경우 동일한 세션을 이후 다듬기와 검토 단계를 위해 열어둡니다.
    • Codex가 구현을 완료했다고 해서 별도의 claude -p 검토 전용 세션을 시작하지 마세요. 이는 콜드 스타트 컨텍스트에 토큰을 소비하고 Claude의 연속성을 약화시킵니다.
  3. 주로 Codex로 구현합니다.

    • Claude Code의 계획을 짧은 체크리스트로 변환합니다.
    • 기존 저장소 패턴을 사용하여 Codex에서 직접 코드를 변경합니다.
    • 위험한 편집 후 가능한 가장 빠른 관련 검사를 실행합니다.
    • 사용자가 요청하지 않는 한 Claude Code를 기계적인 대량 편집, 반복적인 린트 수정, 긴 명령 루프에서 배제합니다.
  4. 구현된 상태를 동일한 Claude Code 세션으로 다시 보내 다듬기를 수행합니다.

    • 특히 프론트엔드 UI, 상호작용 품질, 제품 느낌, 접근성, 엣지 상태에 사용합니다.
    • 제한된 페이로드를 보냅니다. 가능하면 references/handoff-template.md를 사용하세요: 원래 계획, 변경된 파일 목록, git diff --stat, 테스트/검사 출력, 위험, 미해결 질문, 그리고 Claude가 필요한 주요 파일 스니펫 또는 전체 파일.
    • 광범위한 재작성이 아닌 우선순위가 있는 결과를 요청합니다.
    • Codex가 수락된 수정 사항을 적용하고 검사를 다시 실행합니다.
  5. 동일한 Claude Code 세션에서 최종 검토를 실행합니다.

    • Claude Code에서 /codex:review를 사용할 수 있으면 사용합니다.
    • 결과를 먼저 버그/위험/테스트 문제로 취급하고, 스타일 제안은 그 다음으로 취급합니다.
    • Codex가 차단 문제를 수정하고, 검사를 다시 실행하며, 최종 상태를 보고합니다.
    • 사용자가 Claude Code 컨텍스트가 재사용되었는지 확인할 수 있도록 파트너 세션 영수증으로 종료합니다.

세션 전략

  • 중소형 작업: plan -> polish -> /codex:review를 위해 하나의 Claude Code 세션을 열어둡니다.
  • 새로운 Claude Code 세션은 비용이 많이 드는 것으로 간주합니다. 재사용 가능한 세션이 없거나, 이전 세션을 복구할 수 없거나, 사용자가 명시적으로 새 Claude 패스를 요청하는 경우에만 새 세션을 엽니다.
  • 동일한 Claude 세션이 프롬프트, 권한 대기, 또는 유휴 상태에 갇힌 경우, 먼저 제한된 메시지로 동일한 세션을 계속하거나 재개해 보세요. 컨텍스트 비용보다 가치가 명확히 크지 않다면 대체 검토를 콜드 스타트하지 마세요.
  • 대규모 작업 또는 거대한 diff: Codex가 계획, 변경된 파일, 주요 결정, 알려진 위험, 검사 결과를 포함하는 간결한 핸드오프를 생성한 후에만 세션을 분할합니다.
  • 동일한 Claude 세션이 느려지거나, 혼란스러워지거나, 컨텍스트가 많아지면, 토큰 트레이드오프를 보고한 후에만 세션을 닫고 제한된 핸드오프로 다시 시작합니다.
  • 사용자가 명시적으로 더 빠른 최소 루프를 요청하지 않는 한 UI/프론트엔드 작업에 대한 Claude 다듬기 단계를 건너뛰지 마세요.
  • /codex:review가 중단되거나, 시간 초과되거나, 권한 프롬프트에 갇히면, 이를 모니터링 결과로 기록하고, 중단된 하위 프로세스/세션을 중지하고, Codex 측 검증을 계속합니다.
  • Claude Code가 실행 가능한 다듬기를 생성하지 않으면, 맹목적으로 계속 프롬프트하지 마세요. 빈 결과/낮은 신호 결과를 캡처하고, Codex 검증을 실행하며, 제한 사항을 보고합니다.
  • claude -p는 기본 파트너 경로가 아닙니다. 이전 세션 컨텍스트를 잃어도 괜찮은 저렴한 일회성 질문에만 사용하세요.

권한 정책

  • 계획 수립에는 기본적으로 --permission-mode plan을, 구현 검토에는 일반 권한을 사용합니다.
  • 사용자가 명시적으로 skip, 최고 권한, 全部允许, bypass를 요청하거나, 의도적으로 격리된 작업 트리 내에서 작업할 때만 건너뛰기/우회를 사용합니다.
  • 건너뛰기 모드의 경우 claude --permission-mode bypassPermissions --name <task-name> 또는 claude --dangerously-skip-permissions --name <task-name>으로 Claude Code를 시작합니다.
  • 건너뛰기 세션 전에는 저장소 경로, 현재 git 상태, 의도된 범위, 중지 조건을 명시합니다.
  • 건너뛰기 모드가 사용자의 별도 명시적 지시 없이 커밋, 푸시, 배포, 메시지 전송, 게시 또는 비밀 정보를 건드리지 않도록 합니다.
  • skip을 저장소 증거를 무시할 수 있는 권한으로 취급하지 마세요. skip은 Claude Code 권한을 변경할 뿐, 파트너의 검증 의무는 변경하지 않습니다.
  • 저장소 가시성 변경, 릴리스 태그, 레지스트리 게시, 외부 발표는 별도의 명시적 게시 지시 뒤에 남겨둡니다.

라우팅 규칙

  • Claude Code로 라우팅: 아키텍처 계획, 구현 전략, UI/상호작용 비평, 최종 Codex 검토, 어려운 제품 트레이드오프.
  • Codex로 라우팅: 스캐폴딩, 구현, 장문 코드 편집, 테스트, 빌드 수정, 저장소 검사, 모니터링, 요약.
  • UI 품질이 중요하거나 첫 번째 구현이 기술적으로 통과했지만 여전히 제품 다듬기가 필요한 경우 동일한 Claude Code 세션으로 다시 라우팅합니다.
  • Kimi Work/Kimi Code Goal은 Claude Code /goal과 별개로 유지합니다. 이전 "Goal mode" 컨텍스트는 Kimi를 참조할 수 있으며 Claude가 아닙니다.

검증 게이트

이 워크플로우를 개선하거나 중요한 작업에 적용할 때 references/darwin-ratchet.md의 Darwin 스타일 래칫을 사용하세요:

  • 한 번에 하나의 워크플로우 차원(계획, 구현, UI 다듬기, 검토, 모니터링, 권한 또는 보고)만 변경합니다.
  • 테스트 프롬프트 또는 실제 미니 루프를 실행하여 개선이 더 낫다고 판단하기 전에 확인합니다.
  • 위험이 큰 변경에 대해 동일한 에이전트가 유일한 제작자이자 유일한 심판이 되지 않도록 합니다.
  • 저장소 증거가 개선될 때만 변경 사항을 유지합니다. 회귀가 발생하면 git reset --hard가 아닌 검토 가능한 되돌리기를 사용합니다.
  • 다른 프롬프트 루프가 낮은 신호 또는 예상 개선 <1점을 생성하면 중지합니다.

모니터링

활성 Claude Code 세션의 경우 references/monitoring.md를 읽으세요. 채팅 텍스트만 신뢰하는 대신 다섯 가지 신호를 선호합니다:

  1. 실행 중인 Claude Code 세션의 PTY 출력.
  2. claude agents --json --cwd <repo> 세션 상태.
  3. 기본적으로 전체 메시지 본문을 덤프하지 않는 Claude JSONL 전사 구조.
  4. ~/.claude/tasks/<sessionId>/ 아래의 선택적 작업 파일.
  5. 저장소 증거: git status --short, git diff --stat, 관련 테스트/빌드 검사.

출력 계약

사용자에게 다시 보고할 때 다음을 포함하세요:

  • 현재 단계: 계획, Codex 구현, Claude 다듬기, 검토 또는 최종 수정.
  • Claude Code 세션 ID (존재하는 경우).
  • 변경된 파일 및 실행된 검사.
  • 수정되었거나 아직 열려 있는 검토 결과.
  • 작업을 커밋할 준비가 되었는지 여부. 기본적으로 커밋하지 마세요.
  • 유휴 세션, 권한 대기, 빈 검토 출력, diff 없음, 실패한 검사와 같은 모든 모니터링 이상.
  • 중요하지 않은 Claude Code 워크플로우에 대한 파트너 세션 영수증:
[파트너 세션 영수증]
단계: <planning | codex implementation | claude polish | review | final fix>
claude_session: <sessionId 또는 없음>
claude_session_reused: <yes | no | n/a>
new_claude_p_sessions: <0 | 개수 | unknown>
codex_passes: <구현/수정 패스 수>
checks: <실행된 또는 실행되지 않은 명령>
anomalies: <없음 | permission wait | idle | empty review | failed check | 기타>

토큰 절감을 조작하지 마세요. 정확한 토큰 텔레메트리를 사용할 수 없는 경우 대신 검증 가능한 동작(동일한 Claude Code 세션 재사용, 새로운 claude -p 세션 없음, 제한된 핸드오프 사용, 검사 통과)을 보고하세요.

관련 스킬