코드 리뷰 (Flutter/Dart)
Flutter/Dart 프로젝트의 PR·MR·브랜치 변경분을 정해진 체크리스트로 리뷰하고 심각도별 피드백과 최종 판정을 내려주는 스킬.
개발·코딩중급★ 622⑂ 61AI 점수 9/10마지막 업데이트: 2026. 8. 28.
무엇을 해주나
- 현재 브랜치가 리뷰 대상(feature/bugfix/PR 브랜치)인지, 타깃 브랜치와 최신 상태인지 먼저 확인합니다.
- 변경·추가·삭제된 파일을 모두 나열하고, 커밋 메시지와 연관 파일·메서드를 추적해 "왜 이렇게 바뀌었는지"를 파악한 뒤 리뷰합니다.
- 파일별로 위치·네이밍·책임·가독성·로직 오류·에러 처리·보안·성능·SOLID·문서화·테스트·스타일을 표 기준으로 점검합니다.
- Flutter 특화 점검: 불필요한 리빌드(BlocBuilder → BlocSelector), 동적 위젯의 Key, 컨트롤러/스트림 dispose, const 생성자,
*.g.dart/*.freezed.dart수동 수정 여부. - refactoring.guru 기반 코드 스멜 분류표로 Bloaters·Couplers 등 냄새를 스캔합니다.
- 테스트 커버리지를 형식적으로 넘기지 않고, 테스트 파일 실존 여부와 목(mock)만 검증하는 무의미한 테스트인지까지 따집니다.
- 결과를 요약/이슈(suggestion·minor·major)/질문/판정(Approved · Approved with suggestions · Changes requested) 형식으로 정리합니다.
- 사용자가 명시적으로 동의할 때만 GitHub/GitLab에 인라인 코멘트를 게시하며, PreToolUse 훅(
scripts/protect-token.sh)이 토큰 값 노출을 차단합니다.
이런 분께 추천
- Flutter/Dart 앱을 팀으로 개발하며 리뷰 품질을 일정하게 유지하고 싶은 분
- 리뷰어 병목이 심해 1차 리뷰를 AI에게 맡기고 싶은 리드 개발자
- GitHub/GitLab MR에 인라인 코멘트를 자동으로 남기고 싶은 팀
활용 예시
- "이 브랜치 PR 리뷰해줘" → 변경 파일 목록, 파일별 이슈(심각도 표기), 최종 판정까지 한 번에 받기
- "머지 전에 diff 감사해줘" → CI 실패·린트 경고·테스트 누락을 blocking 이슈로 표시
- 리뷰 결과 확인 후 "이 코멘트들 GitLab MR에 올려줘" →
GITLAB_TOKEN을 사용해 파일·라인에 인라인 코멘트 게시
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/evanca/flutter-ai-rules/HEAD/skills/code-review/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 evanca/flutter-ai-rules 의 skills/code-review 폴더를 내 ~/.claude/skills/code-review/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/evanca/flutter-ai-rules.git /tmp/flutter-ai-rules && mkdir -p ~/.claude/skills && cp -r /tmp/flutter-ai-rules/skills/code-review ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 저장소를 클론합니다:
git clone https://github.com/evanca/flutter-ai-rules.git - 스킬 폴더를 만듭니다:
mkdir -p ~/.claude/skills - 스킬을 복사합니다:
cp -r flutter-ai-rules/skills/code-review ~/.claude/skills/ - 훅 스크립트에 실행 권한을 줍니다:
chmod +x ~/.claude/skills/code-review/scripts/protect-token.sh - (선택) 온라인 코멘트 게시를 원하면 리뷰 봇 토큰을 환경변수로 등록합니다:
export GITHUB_TOKEN=...또는export GITLAB_TOKEN=... - Flutter 프로젝트 폴더에서 Claude Code를 실행하고 "이 PR 리뷰해줘"라고 요청하면 스킬이 자동 발동합니다.
GitHub에서 원본 보기 ↗라이선스: MIT