팀모드 (Teammode)
이름 있는 Codex 워커 팀을 리더 세션이 지휘하며, 디스크에 상태를 남기고 병렬로 작업하게 하는 오케스트레이션 스킬.
자동화·워크플로고급★ 67,531⑂ 5,507AI 점수 7/10마지막 업데이트: 2026. 8. 9.
무엇을 해주나
여러 명의 Codex 워커를 하나의 '팀'으로 묶어 병렬 작업을 시키는 오케스트레이션 규칙입니다.
- 전송 방식 자동 판별: 세션에 어떤 협업 도구가 있는지 먼저 확인해 네이티브 MultiAgentV2 에이전트, Codex App 스레드, 또는 단순 서브에이전트 분할 중 무엇으로 갈지 사용자에게 먼저 알려줍니다.
- 영속 상태 관리: 번들된 Node 스크립트(
team.mjs)가.omo/teams/{session_id}/에team.json, 자동 생성 멤버 매뉴얼guide.md, 공유 폴더artifacts/를 만들고 잠금(lock) 기반으로 안전하게 갱신합니다. - 역할이 아닌 '담당 영역'으로 팀 구성: "백엔드 개발자" 같은 모호한 직함 대신 코드베이스의 특정 부분·소유 영역·관점(lens)으로 멤버를 정의해 업무 중복을 막습니다.
- 워크트리 격리와 통합: 같은 파일을 건드릴 멤버에게 git worktree를 지급하고, 끝나면
integrate로 머지 커밋을 만들어 정리합니다. - 정리 규칙: 작업이 끝나면 아카이브 → 삭제까지 강제해 좀비 팀 상태가 남지 않게 합니다.
이런 분께 추천
- Codex 환경에서 여러 스레드/에이전트를 동시에 굴려 대형 리팩터링이나 조사 작업을 하는 분
- 이미
.omo/plans/에 계획 파일을 만들어 두고 웨이브 단위로 병렬 실행하고 싶은 분 - 병렬 작업 중 파일 충돌을 worktree로 깔끔히 분리하고 싶은 분
- (주의) 반대로 완전히 독립된 단일 작업이라면 이 스킬 대신 일반 서브에이전트를 쓰라고 스킬 자체가 권고합니다.
활용 예시
- 대형 버그 조사: "이 서버 종료 지연 문제를 팀으로 파봐" → 리더가
app-server-lifecycle,mailbox-delivery두 멤버를 만들어 각자 영역을 조사하게 하고, 서로의 발견을 실시간으로 중계받아 종합합니다. - 계획 파일 병렬 실행:
.omo/plans/auth-refactor.md의 1웨이브 독립 todo 3개를 멤버 3명에게 하나씩 배정하고, 겹치는 파일이 있는 멤버에게만 worktree를 만들어 준 뒤 완료 후integrate로 머지합니다. - 정리: 작업이 끝나면 각 멤버에게 마무리 통보 →
archive→worktree-remove→delete순으로 팀 상태를 깨끗이 지웁니다.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 code-yeongyu/oh-my-openagent 의 packages/omo-codex/plugin/components/teammode/skills/teammode 폴더를 내 ~/.claude/skills/teammode/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/code-yeongyu/oh-my-openagent.git && mkdir -p ~/.claude/skills && cp -r oh-my-openagent/packages/omo-codex/plugin/components/teammode/skills/teammode ~/.claude/skills/teammode⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 원하는 작업 폴더로 이동합니다.
- 저장소를 내려받습니다:
git clone https://github.com/code-yeongyu/oh-my-openagent.git - 스킬 폴더를 만듭니다:
mkdir -p ~/.claude/skills - 스킬을 복사합니다:
cp -r oh-my-openagent/packages/omo-codex/plugin/components/teammode/skills/teammode ~/.claude/skills/teammode scripts/team.mjs파일이 함께 복사됐는지 확인합니다. 이 스크립트가 없으면 팀 상태를 만들 수 없습니다.- Node.js(또는 Bun)가 설치돼 있는지 확인합니다:
node -v - Claude Code / Codex 세션을 재시작한 뒤 "팀 모드로 이 작업 나눠서 해줘" 같이 요청하면 스킬이 활성화됩니다.
- 참고: 이 스킬은 Codex의 MultiAgentV2 또는
codex_app.*도구가 있어야 실제 팀을 만들 수 있습니다. 없으면 순차 진행으로 안내합니다.
GitHub에서 원본 보기 ↗라이선스: NOASSERTION