wshobson/review-agent-setup

review-agent-setup은(는) 무엇을 하나요?

Claude Code에서 AI 에이전트의 PR 검토 작업에 대해 사람의 개입을 통한 게이팅(Human-in-the-loop)을 설정합니다. 에이전트가 PR 리뷰, 댓글, 머지, 또는 CI 설정 편집을 수행할 수 있는 프로젝트에서 암호화 방식으로 감사 가능한 승인 내역과 Cedar 기반 게이트를 원할 때 사용하세요.

사용 방법

1. 스킬 호출 - 프로젝트의 .claude/settings.json에 이 스킬을 추가합니다.
2. 설정 파일 생성 - cedar-policy.json 및 approval-config.json 파일을 프로젝트 루트에 생성합니다.
3. 게이트 정의 - 승인 정책과 최소 승인자 수, 승인자 목록을 정의합니다.
4. 에이전트 사용 - Claude Code가 설정된 게이트를 자동으로 준수합니다.

설정 예시

approval-config.json

{
  "minApprovals": 1,
  "approvers": ["user1", "user2"],
  "orgPolicies": {
    "requireApprovalFor": ["merge", "ci-config-edit"]
  },
  "audit": {
    "signingKey": "your-gpg-key-id"
  }
}

cedar-policy.json

{
  "policies": [
    {
      "effect": "forbid",
      "principal": "ClaudeCode",
      "action": ["MergePR", "EditCIConfig"],
      "condition": {
        "not": {
          "hasApproval": {
            "count": 1
          }
        }
      }
    }
  ]
}

지원 기능

• 게이트 유형: PR 리뷰, 댓글, 머지, CI 설정 편집
• 정책 언어: Cedar (AWS 기반 정책 엔진)
• 감사 추적: GPG 서명된 승인 증명
• 승인 제어: 최소 승인자 수, 특정 승인자 목록
• 범위 설정: 조직 수준, 저장소 수준, 작업 수준

참고 사항

• 모든 설정 파일은 버전 관리에 포함하는 것을 권장합니다.
• GPG 키는 안전하게 보관하고, 팀 내에서 공유하지 마십시오.
• 승인 정책이 너무 엄격하면 생산성이 저하될 수 있으므로 적절한 균형을 유지하세요.