SlopGuard 문서

빠른 시작

GitHub 앱을 레포나 조직에 설치하면 끝입니다. 공개 레포는 무료이고, 설정 파일 없이 기본값으로 바로 동작합니다. 새 PR이나 이슈가 들어오면 점수를 매기고, 임계값 이상이면 slop-quarantine 라벨과 근거 코멘트를 답니다. 절대 자동으로 닫지 않습니다.

슬래시 명령

관리자는 코멘트로 답합니다. 모든 동작은 사람이 결정합니다.

/slop approve

격리를 해제하고 정상 기여로 표시합니다 (slop-cleared).

/slop reject

본인이 직접 닫는 동작입니다. AI 슬롭으로 판단해 PR을 닫습니다.

/slop false-positive

오탐을 알리는 튜닝 이슈를 열고 격리를 해제합니다.

점수와 임계값

모든 기여는 0(깨끗)에서 100(거의 확실한 슬롭) 사이 점수를 받습니다. 기본값으로 50 이상이면 격리, 85 이상이면 코멘트를 더 강하게 표현합니다. 점수가 어떻게 나오는지는 동작 방식에서 볼 수 있습니다.

SLOP_POLICY.yml 설정

레포에 .github/SLOP_POLICY.yml 파일을 두면 동작을 바꿀 수 있습니다. 전부 선택이고, 적은 항목만 덮어씁니다.

# .github/SLOP_POLICY.yml  (all fields optional)
version: 1
enabled: true

scan:
  pull_requests: true
  issues: true

thresholds:
  quarantine: 50        # score at/above this gets a label + comment
  high_confidence: 85   # phrased more strongly (still never auto-closes)

allowlist:
  authors: [dependabot[bot], renovate[bot]]
  paths: ["docs/**", "**/*.md"]

heuristics:
  weight: 0.4           # blended with the LLM score (llm weight = 1 - this)

llm:
  enabled: true
  provider_order: [anthropic, grok, openai]

주요 옵션

enabled

끄지 않고 SlopGuard를 잠시 멈추는 마스터 스위치.

scan

PR과 이슈 중 무엇을 검사할지.

thresholds

격리(quarantine)와 강조(high_confidence) 점수 기준.

labels

격리/정상 확인/고확신 라벨 이름.

allowlist

신뢰하는 작성자나 경로(글롭)는 검사에서 제외.

heuristics

규칙 점수 가중치(0~1). 오탐을 줄일 때 조정.

llm

LLM 판정 사용 여부와 프로바이더 순서.

comment_template

PR 코멘트 양식. {{score}} 같은 변수 지원.

notify

격리 시 Slack/Discord/웹훅 알림 (Team 플랜).