code-review-team

name	code-review-team
description	PR diff에 대해 정적분석·설계·보안 3 리뷰어 + 리팩토러 4인 팀을 운영한다. 트리거 - "코드 리뷰", "PR 리뷰", "리뷰 재실행", "다시 실행", "리뷰 보고서".
allowed-tools	TeamCreate, AgentTool, TaskCreate, SendMessage, TeamDelete, Read, Write, Bash(gh pr diff, gh pr comment)

code-review-team

4인 리뷰어 팀 오케스트레이터. 리더는 텍스트를 쓰지 않는다 — 워커 4인이 모든 보고서를 생산한다.

사용 시점

• PR 번호가 주어지고 코드 리뷰를 요청받았을 때
• "리뷰 재실행", "다시 실행" 같이 동일 PR을 같은 팀으로 재돌릴 때
• 사용자가 "코드 리뷰 팀 만들어줘" 같이 책 11장 팀을 직접 지칭할 때

6 Phase 워크플로 (의사코드)

공식 도구: TeamCreate, AgentTool, TaskCreate, SendMessage, TeamDelete. 의사 함수 (실 구현 필요): parseDiff, waitForTeamCompletion, mergeReports, $ (셸 실행 헬퍼).

async function codeReviewTeam(prNumber: number) {
  // ──────────────────────────────────────────────
  // Phase 0 — 입력 수집
  // ──────────────────────────────────────────────
  const diff = await $(`gh pr diff ${prNumber}`);  // 의사: $
  await Write(`_workspace/input/pr-${prNumber}.diff`, diff);
  const parsed = parseDiff(diff);                  // 의사: parseDiff

  // ──────────────────────────────────────────────
  // Phase 1 — TeamCreate + AgentTool × 4 (worktree 격리)
  // ──────────────────────────────────────────────
  const team = await TeamCreate({
    name: "code-review",
    description: "PR diff를 4개 렌즈로 리뷰한다"
  });

  const roleMap = [
    "static-analyzer",
    "design-reviewer",
    "security-auditor",
    "refactorer"
  ];
  for (const role of roleMap) {
    await AgentTool({
      team: team.id,
      agent: role,
      isolation: "worktree"
    });
  }

  // ──────────────────────────────────────────────
  // Phase 2 — TaskCreate × 4 (for-루프)
  // ──────────────────────────────────────────────
  // 책 주의: 단건 호출은 TaskCreate 1회씩이지만, 의사 표기로는 배열 표기로도 자주 그려진다.
  // 실제로는 for-루프로 4회 호출.
  const taskSpecs = [
    { agent: "static-analyzer",  name: "정적 분석",  output: "_workspace/review/01_static.md"   },
    { agent: "design-reviewer",  name: "설계 검토",  output: "_workspace/review/02_design.md"   },
    { agent: "security-auditor", name: "보안 감사",  output: "_workspace/review/03_security.md" },
    { agent: "refactorer",       name: "리팩토링",   output: "_workspace/review/04_refactor.md",
      depends_on: ["정적 분석", "설계 검토", "보안 감사"] }
  ];
  for (const t of taskSpecs) {
    await TaskCreate({
      team: team.id,
      agent: t.agent,
      name: t.name,
      input: `_workspace/input/pr-${prNumber}.diff`,
      output: t.output,
      depends_on: t.depends_on
    });
  }

  // ──────────────────────────────────────────────
  // Phase 3 — 팬아웃 (리뷰어 3인 병렬). 동료 SendMessage는 리더 미경유.
  // ──────────────────────────────────────────────
  await waitForTeamCompletion(team.id, { tasks: ["정적 분석", "설계 검토", "보안 감사"] });
  // 워커 간 SendMessage는 워커 정의(.md)의 팀 통신 프로토콜에 따라 자율 호출.

  // ──────────────────────────────────────────────
  // Phase 4 — 생성-검증 루프 (최대 3회)
  // ──────────────────────────────────────────────
  // refactorer는 depends_on 대기 후 자동 시작. 본인이 생성·검증을 내부에서 3회 상한으로 진행.
  await waitForTeamCompletion(team.id, { tasks: ["리팩토링"] });

  // ──────────────────────────────────────────────
  // Phase 5 — 통합 · 게시 · 정리
  // ──────────────────────────────────────────────
  const reports = [
    Read("_workspace/review/01_static.md"),
    Read("_workspace/review/02_design.md"),
    Read("_workspace/review/03_security.md"),
    Read("_workspace/review/04_refactor.md")
  ];
  const merged = mergeReports(reports, { priority: ["P0", "P1", "P2"] });
  await Write("_workspace/review_report.md", merged);

  await $(`gh pr comment ${prNumber} -F _workspace/review_report.md`);
  await TeamDelete(team.id);  // workspace 보존
}

도구 분류 (책 본문 메모)

공식 5종 (실제 호출 가능):

• TeamCreate
• AgentTool
• TaskCreate
• SendMessage (워커 정의에서 직접 호출)
• TeamDelete

의사 함수 4종 (구현자가 직접 만들어야 함):

• parseDiff(diff) — diff 텍스트를 파일·라인 메타로
• waitForTeamCompletion(teamId, opts) — 작업 완료 대기
• mergeReports(reports, opts) — 4 보고서를 우선순위 정렬해 통합
• $(cmd) — Bash 실행 헬퍼

주의

• 리더 무발화: 본 스킬은 호출만 한다. 리뷰 본문 텍스트는 워커 4인이 생산.
• 자동 커밋 금지: 본 스킬은 gh pr comment까지만. git commit·gh pr merge는 호출하지 않는다.
• workspace 보존: TeamDelete 후에도 _workspace/ 디렉토리는 남는다. 사람이 재검토할 수 있게.
• 재실행 트리거: "리뷰 재실행" 키워드로 동일 prNumber 재돌리기 가능 (이전 결과 덮어쓰기).