Community코딩 & 개발github.com

결제 코드 리뷰

Java 또는 Kotlin 결제 코드(Spring Boot, Kafka, JPA)에서 돈을 잃거나 중복 청구하는 버그(멱등 키 누락, double/float 금액, 이중 쓰기로 인한 이벤트 손실, 멱등하지 않은 컨슈머, 자체 승인, 타임아웃 누락, 로그 내 카드 데이터)를 찾습니다. 번들 스캐너를 실행하고 각 발견 항목을 코드에서 확인한 후 수동 체크리스트를 수행합니다. 결제, 이체, 환불, 원장 또는 잔액을 생성, 이동, 승인, 확정 또는 조정하는 풀 리퀘스트나 서비스를 검토할 때 사용합니다.

결제 코드 리뷰란 무엇인가요?

이 스킬은 결제 파이프라인에서 실제 금전적 손실을 초래할 수 있는 버그를 식별하고 설명하는 데 특화된 코드 리뷰 도구입니다. Spring Boot, Kafka, JPA 스택의 Java 및 Kotlin 프로젝트에서 멱등성 키 누락, double/float 타입 금액 사용, 이중 쓰기 문제로 인한 이벤트 손실, 비멱등적 컨슈머, 자체 승인 가능성, 타임아웃 누락, 로그 내 카드 데이터 노출 등 20여 가지 이상의 구체적인 취약점을 찾아냅니다. Python 3.10+로 작성된 스캐너 스크립트가 코드를 분석하여 잠재적 문제점 목록을 생성하고, 리뷰어는 각 항목을 코드에서 직접 확인하여 위양성을 걸러냅니다. 또한 수동 체크리스트를 통해 스캐너가 탐지할 수 없는 경쟁 조건, 멱등 키 범위, 재시도 및 타임아웃 의미론, 상태 머신, 조정, 감사, 데이터 보호 문제까지 점검합니다. 최종 보고서는 금전적 영향도 기준으로 심각도를 매겨(높음/중간/낮음) 각 문제가 구체적으로 얼마나 손실을 초래할 수 있는지 예시와 함께 설명하고, 가장 작은 안전한 수정 사항을 제안합니다. 이 스킬은 결제, 이체, 환불, 원장, 잔액을 처리하는 모든 서비스 또는 풀 리퀘스트 리뷰에 적합합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Vidhidesai12/payments-review-skill/tree/main/payments-code-review

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

결제 코드 리뷰은(는) 무엇을 하나요?

결제 코드에서 실제 돈이 드는 버그를 찾고, 각각을 금전적 관점에서 설명합니다: 누가 두 번 청구되는지, 어떤 확정(booking)이 손실되는지, 누가 자신의 이체를 승인할 수 있는지.

워크플로

  1. 범위를 지정합니다. 돈을 생성, 이동, 승인, 확정 또는 조정하는 코드를 찾습니다: 컨트롤러, 서비스, 리스너, 엔티티, 마이그레이션. 스택(Spring Boot, Kafka, JPA, Kotlin)을 기록합니다.

  2. 이 스킬의 폴더에서 스캐너를 실행합니다. 프로젝트 또는 변경된 파일을 대상으로 합니다:

    python scripts/scan.py <path-to-code>                # 마크다운 테이블
    python scripts/scan.py <path-to-code> --format json  # 추가 처리를 위해
    

    Python 3.10+만 필요하며 다른 것은 필요하지 않습니다. --include-tests를 전달하지 않으면 테스트 소스를 건너뜁니다. 휴리스틱을 사용하여 소스 텍스트를 읽으므로 출력은 리드(leads) 목록입니다.

  3. 코드를 읽어 모든 발견 항목을 확인합니다. 각 리드에 대해 파일을 열고 다음을 확인합니다:

    • double 타입의 amount가 실제로는 백분율 또는 비율인 경우 PAY001이 아닙니다.
    • 중복 또는 4-눈(4-eyes) 검사가 스캐너가 따라가는 것보다 더 깊은 곳(세 번 호출)에 있으면 컨슈머나 승인 메서드는 괜찮습니다. 따라가서 그 위치를 말합니다.
    • 위양성은 한 줄로 이유를 설명하여 제거합니다. 그래야 독자가 나머지를 신뢰할 수 있습니다.
  4. references/checklist.md의 수동 체크리스트를 수행합니다. 각 스캐너 규칙을 잘못된 예와 올바른 예와 함께 설명하고, 어떤 스캐너도 볼 수 없는 것들(잔액에 대한 경쟁 조건, 멱등 키 범위, 재시도 및 타임아웃 의미론, 상태 머신, 조정, 전송 중인 돈, 감사, 데이터 보호)을 나열합니다. 검토 중인 코드가 필요한 만큼만 깊이 들어갑니다.

  5. 아래 형식으로 보고서를 작성합니다. 금전적 영향이 가장 큰 것부터 시작합니다.

보고서 형식

## 결제 리뷰: <서비스 또는 PR>

**평가:** <한 문장: 병합해도 안전함 / 병합 전 수정 필요 / 재설계 필요>

| # | 심각도 | 위치 | 문제 | 금전적 영향 |
|---|---|---|---|---|
| 1 | 높음 | `TransferController.java:24` | POST /transfers에 멱등 키 없음 | 클라이언트 재시도 후 타임아웃으로 두 번째 이체 생성됨 |

### 1. <제목>
**중요한 이유:** <무엇이 잘못되는지, 구체적인 예시 금액과 함께>
**수정:** <가장 작은 안전한 변경, 짧은 코드 스니펫 포함>

### 확인됨, 이상 없음
- <올바른 것으로 확인된 사항들, 위치 포함; 리뷰의 정직성을 유지>

### 검토되지 않음
- <확인할 수 없었던 사항, 예: 이 저장소에 없는 데이터베이스 제약 조건>

리뷰 규칙

  • 심각도는 금전적 기준입니다. 높음 = 돈이 잘못된 사람에 의해 손실, 중복 또는 이전될 수 있음. 중간 = 장애나 부하 시 발생 가능. 낮음 = 위생.
  • 모든 발견 항목에 대해 file:line으로 라인을 인용합니다. 확인되지 않은 스캐너 리드를 보고하지 마십시오.
  • 가장 작은 안전한 수정을 선호합니다. 예를 들어 재작성 대신 고유 제약 조건과 Idempotency-Key 헤더를 추가합니다. 올바른 수정이 구조적(트랜잭셔널 아웃박스)이라면 그렇게 명확히 말합니다.
  • 규정 준수를 주장하지 마십시오. 이 리뷰는 PCI DSS 또는 SOX 감사가 아닙니다. 요청받으면 그렇게 말하십시오.
  • 데이터베이스도 확인합니다. 이러한 보장 중 상당수는 제약 조건(UNIQUE, CHECK, 트리거)에 속합니다. 저장소에 있는 경우 마이그레이션(Flyway, Liquibase)을 살펴봅니다.

관련 스킬