Community연구 & 데이터 분석github.com

steipete/github-deep-review

GitHub 심층 리뷰: 버그, PR, 최적의 수정, 오래된 이슈 판별, 코드 우선 분석.

github-deep-review란 무엇인가요?

이 스킬은 GitHub 이슈 및 PR을 심층적으로 분석하여 단순한 요약이 아닌, 실제 버그 클래스를 이해하고 근본 원인을 찾아 최적의 수정 방법을 제안합니다. 코드 중심의 증거 기반 접근 방식을 따르며, 불확실한 경우 '입증되지 않음'을 명확히 표시합니다. `gh` CLI를 사용하여 이슈 및 PR 상세 정보와 diff를 가져오고, 로컬 리포지토리에서 `git` 명령어와 `rg`로 코드 컨텍스트를 분석합니다. 리뷰 시 버그의 근본 원인, 회귀(regression) 발생 시점, 제안된 수정의 적절성, 더 큰 리팩터링 필요성, 그리고 남아있는 위험 요소를 명시적으로 평가합니다. 또한 버그의 기원을 추적하는 'Provenance' 섹션과 PR 리뷰 시 구체적인 파일/라인/심볼 참조를 포함한 결과를 제공합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/github-deep-review

Installed? Explore more 연구 & 데이터 분석 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

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

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

문서

GitHub Deep Review

Peter처럼 리뷰하세요: 높은 신뢰도, 증거 우선, 코드 인지, 그리고 증거가 부족하면 "입증되지 않음"을 말할 용기. 목표는 일반적인 요약이 아닙니다. 목표는 버그 클래스를 이해하고, 가능하다면 실제 원인을 찾고, 충분한 코드를 읽은 후 최상의 수정을 결정하고, 더 큰 리팩터링이 설계를 개선할 수 있는지 여부를 지적하는 것입니다.

시작

GitHub 참조에는 웹 브라우징이 아닌 gh를 사용하세요:

gh issue view <n> --json number,title,state,author,body,comments,labels,updatedAt,url
gh pr view <n> --json number,title,state,author,body,comments,reviews,files,commits,statusCheckRollup,mergeStateStatus,headRefName,headRepositoryOwner,url
gh pr diff <n> --patch

PR의 경우, 작성자가 Peter(steipete 또는 명백히 Peter 소유 계정)가 아닌 한 기본적으로 작성자 컨텍스트를 수집하세요. ~/Projects/agent-scripts/skills/github-author-context/SKILL.md의 로컬 워크플로를 사용하고, 작성자가 Peter가 아닌 경우 리뷰 상단 근처에 짧은 Author context: 블록을 포함하세요. 머지/거부/종료/리뷰 후에, 상호작용이 지속적인 향후 리뷰 신호를 생성하는 경우에만 동일한 작성자 컨텍스트 워크플로를 사용하여 기여자 노트를 추가하세요.

로컬 리포지토리 리뷰의 경우, 다음도 검사하세요:

git status --short --branch
git fetch origin
git log --oneline --decorate -20
rg "<key symbol/error/config/endpoint>"

리포지토리에 로컬 지침, 이슈/PR 스킬, 문서 목록, 테스트 가이드, 또는 유지보수자 실행 가이드가 있다면, 결정하기 전에 먼저 읽으세요.

리뷰 계약

항상 다음 질문에 명시적으로 답변하세요:

  • URL/참조: 이슈 또는 PR 번호 및 영향 영역.
  • 수정 중인 버그 또는 동작은 무엇입니까?
  • 근본 원인을 식별할 수 있습니까? 그렇다면, 코드상 어디이며 왜 그런가요? 아니라면, 어떤 증거가 누락되었습니까?
  • 회귀(regression)의 경우, 누가/무엇이 언제 도입했습니까? 제한된 기록으로 추적 가능한 경우 커밋/PR 출처를 포함하고, 추측하지 말고 알 수 없음이라고 말하세요.
  • 현재/제안된 수정이 인접 코드를 읽은 후 가능한 최상의 수정입니까?
  • 더 큰 리팩터링이 정확성, 명확성 또는 향후 유지보수성을 개선할 수 있습니까?
  • 어떤 증거가 존재합니까: 테스트, 라이브 재현, CI 검사, 문서, 종속성 문서/소스, 출시/현재 동작.
  • 무엇이 위험하거나 검증되지 않았습니까?

코드 읽기 깊이

처음 수정된 파일만 읽지 마세요. 실제 호출 경로를 따르세요:

  • 진입점 -> 유효성 검사/파싱 -> 라우팅/디스패치 -> 소유자 모듈 -> 공유 헬퍼 -> 영속성/네트워크/런타임 경계
  • 구성/스키마/문서 -> 런타임 사용 -> 닥터/마이그레이션/수정 경로
  • 제공자/채널/플러그인 소유자 코드 -> 여러 소유자가 필요할 때만 일반 코어 인터페이스
  • 영향 영역 주변 테스트 및 인접 회귀 테스트

동작이 종속성에 의존하는 경우, 가정하기 전에 상위 문서/소스/타입 또는 현재 패키지 계약을 읽으세요.

이슈 댓글보다 현재 소스와 실행 가능한 증거를 선호하세요. 오래된 댓글, 오래된 CI, 오래된 릴리스 동작을 재확인될 때까지 힌트로 취급하세요.

출처

버그/회귀 리뷰의 경우, 가능할 때 간결한 Provenance: 답변을 포함하세요:

  • git log -S/-G, git blame, 연결된 PR/이슈 및 테스트를 사용하세요.
  • 작성자, 커미터/병합자, 현재 PR 작성자가 다를 경우 구분하세요.
  • introduced by, made visible by, 또는 carried forward by로 표현하세요.
  • 신뢰도를 포함하세요: clear, likely, 또는 unknown.
  • 기능, 문서, 리팩터링 또는 추적 불가능한 버그의 경우 N/A를 쓰거나 어떤 증거가 누락되었는지 말하세요.

수정 품질 기준

좋은 수정은 일반적으로:

  • 버그가 속한 소유권 경계에 있습니다.
  • 문제가 폐기에 관한 것이 아니라면 공개/하위 호환 동작을 유지합니다.
  • 가장 작은 의미 있는 지점에서 회귀 테스트를 추가합니다.
  • 광범위한 특수 사례, 숨겨진 마이그레이션, 의미론적 센티넬, 일반 코어의 제공자/채널 ID를 피합니다.
  • 사용자에게 보이는 동작이 변경될 때 문서/체인지로그를 업데이트합니다.
  • 확립된 계약인 경우 런타임 경로에서 명확하게 실패하고 닥터/마이그레이션 경로를 통해 복구합니다.

수정이 증상 수준에 불과할 때 이를 지적하세요. 약간 더 큰 리팩터링이 불변 조건을 명확하게 하고 향후 버그를 줄인다면 이를 권장하세요. 리팩터링이 버그 클래스를 개선하지 않으면서 위험을 확대한다면 그렇게 말하세요.

PR 리뷰 형식

PR을 리뷰할 때는 결과를 먼저 제시하세요. 결과에는 파일/라인/심볼 참조와 구체적인 실패 모드가 필요합니다. 모호한 "고려" 코멘트는 피하세요.

차단 문제가 없는 경우:

  • 차단하는 정확성 문제가 없음을 말하세요.
  • 확인된 가장 강력한 증거를 나열하세요.
  • 남아있는 위험/테스트 격차를 명시하세요.
  • 설계가 가능한 최상의 형태인지 답변하세요.

사용자가 해당 작업을 요청하지 않는 한 승인, 댓글, 종료, 머지, 푸시 또는 적용(land)하지 마세요.

이슈 리뷰 형식

버그/이슈의 경우:

  1. 신고자의 시나리오와 영향을 받는 버전/영역을 재구성하세요.
  2. 현재 main 브랜치가 이미 수정했는지 확인하세요.
  3. 가능할 때 최소한의 로컬/라이브 증거를 재현하거나 생성하세요.
  4. 명확하다면 근본 원인과 제안된 수정을 식별하세요.
  5. main에서 해결된 경우, 사용자가 요청할 때만 댓글/종료하고 증거와 알려진 정식 커밋/PR을 포함하세요.

재현이 불가능한 경우, 무엇이 막고 있는지와 어떤 증거가 결정을 신뢰할 수 있게 만들지 정확히 말하세요.

출력 템플릿

사용자가 "이게 뭐에 관한 거야?", "이게 최선의 수정이야?" 또는 "무엇을 고쳤어?"라고 물을 때 이 형태를 사용하세요:

Ref: #123 / PR #456
Surface: <runtime/CLI/provider/channel/docs>

Bug: <한두 문장>
Cause: <코드 경로 + 신뢰도>
Provenance: <introduced/made visible/carried forward by commit/PR/date, or N/A/unknown>
Best fix: <무엇을 바꿔야 하고 왜 그런지>
Refactor: <예/아니오, 구체적인 형태>
Proof: <tests/live/CI/source/dependency docs>
Risk: <남아있는 불확실성>

간결하게 유지하되, 원인/수정/리팩터링/증거 결정을 건너뛰지 마세요.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

steipete/nano-banana-pro

Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.

관련 스킬