AI 에이전트가 쓴 PR 설명을 details/summary로 접어 두는 방법
Hide your slop PR descriptions behind <details><summary>
Simon Willison은 Claude Code나 Codex가 작성한 PR 설명이 너무 길어 읽기 부담이 크다고 지적하며, GitHub Markdown의 <details><summary> 태그로 전체 설명을 접어 두는 방식을 소개했다. 첫 문단에는 사람이 고른 짧은 요약을 두고 모델명을 summary로 써서 독자가 훑어볼 수 있게 한다. 기사에 따르면 그는 요즘 프로젝트 변경을 대부분 Claude Code나 Codex가 열어 준 PR 형태로 받는다. 에이전트가 쓴 PR 설명은 정확하고 포괄적이지만 분량이 많아 읽기 피로를 준다. 이를 줄이기 위해 PR 본문 첫 단락에는 사람이 직접 고른 짧은 소개를 두고, 필요하면 스크린샷을 함께 넣는다. 이어지는 전체 에이전트 작성 설명은 <details><summary> 안에 넣고 summary에는 'Claude Opus 5.5 Medium'처럼 모델명과 노력 수준을 적는다. GitHub Markdown이 이 태그를 지원하므로 이슈 댓글이나 PR 설명에 그대로 넣으면 접힌 상태로 표시된다. 그는 datasette의 PR #3052(행 페이지를 세로 필드 목록으로 재설계), PR #3043(현재 페이지 위치를 보여 주는 페이지네이션 바), PR #3042(edit-tools.js를 필요할 때만 로드) 등에 이 패턴을 적용한 예시를 들었다. 특히 PR #3042에서는 약 220KB 파일이 편집 권한이 없는 사용자에게도 매 페이지마다 로드되던 문제를 줄였다고 설명했다.
datasette-agent PR #51처럼 에이전트가 쓴 긴 설명을 <details><summary>로 접고 summary에 모델명과 노력 수준을 적으면, 리뷰어가 첫 문단만 읽고 PR의 목적과 우선순위를 빠르게 판단할 수 있다.
원문 출처
Simon Willison's Weblog