搭子.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는 출력을 검증해야 하는 고가치 협력자로 취급됩니다.
기본 흐름
-
대상 저장소에서 기반을 다집니다.
agent-workbench루트가 아닌 실제 프로젝트 디렉토리로 들어갑니다.- Claude Code를 시작하기 전에
git status --short를 실행합니다. - 작업이 그린필드, 기능 중심, UI 중심, 검토 전용, 또는 디버깅인지 식별합니다.
-
고비용 사고 루프를 위해 하나의 Claude Code 세션을 시작합니다.
- 계획 수립: PTY에서 Claude Code를 시작하고 목표를 설정합니다.
- 기본값으로
claude --permission-mode plan --name <task-name>을 사용합니다. - 대화형 세션에서
/goal <clear completion condition>을 보냅니다. - Claude Code에 구체적인 구현 계획, 승인 기준, UI/상호작용 가이드를 요청합니다.
- 작업이 너무 크지 않은 경우 동일한 세션을 이후 다듬기와 검토 단계를 위해 열어둡니다.
- Codex가 구현을 완료했다고 해서 별도의
claude -p검토 전용 세션을 시작하지 마세요. 이는 콜드 스타트 컨텍스트에 토큰을 소비하고 Claude의 연속성을 약화시킵니다.
-
주로 Codex로 구현합니다.
- Claude Code의 계획을 짧은 체크리스트로 변환합니다.
- 기존 저장소 패턴을 사용하여 Codex에서 직접 코드를 변경합니다.
- 위험한 편집 후 가능한 가장 빠른 관련 검사를 실행합니다.
- 사용자가 요청하지 않는 한 Claude Code를 기계적인 대량 편집, 반복적인 린트 수정, 긴 명령 루프에서 배제합니다.
-
구현된 상태를 동일한 Claude Code 세션으로 다시 보내 다듬기를 수행합니다.
- 특히 프론트엔드 UI, 상호작용 품질, 제품 느낌, 접근성, 엣지 상태에 사용합니다.
- 제한된 페이로드를 보냅니다. 가능하면
references/handoff-template.md를 사용하세요: 원래 계획, 변경된 파일 목록,git diff --stat, 테스트/검사 출력, 위험, 미해결 질문, 그리고 Claude가 필요한 주요 파일 스니펫 또는 전체 파일. - 광범위한 재작성이 아닌 우선순위가 있는 결과를 요청합니다.
- Codex가 수락된 수정 사항을 적용하고 검사를 다시 실행합니다.
-
동일한 Claude Code 세션에서 최종 검토를 실행합니다.
- Claude Code에서
/codex:review를 사용할 수 있으면 사용합니다. - 결과를 먼저 버그/위험/테스트 문제로 취급하고, 스타일 제안은 그 다음으로 취급합니다.
- Codex가 차단 문제를 수정하고, 검사를 다시 실행하며, 최종 상태를 보고합니다.
- 사용자가 Claude Code 컨텍스트가 재사용되었는지 확인할 수 있도록 파트너 세션 영수증으로 종료합니다.
- 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를 읽으세요. 채팅 텍스트만 신뢰하는 대신 다섯 가지 신호를 선호합니다:
- 실행 중인 Claude Code 세션의 PTY 출력.
claude agents --json --cwd <repo>세션 상태.- 기본적으로 전체 메시지 본문을 덤프하지 않는 Claude JSONL 전사 구조.
~/.claude/tasks/<sessionId>/아래의 선택적 작업 파일.- 저장소 증거:
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 세션 없음, 제한된 핸드오프 사용, 검사 통과)을 보고하세요.