code-review-team

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 보존
}