gh-issues

• 명확하게 범위가 정해진 버그 이슈 백로그가 있고 사람이 검토하기 전에 자동화된 1차 수정 시도를 원하는 경우.
• 예약된 CI/cron 파이프라인을 운영하며 수동 개입 없이 이슈를 자동으로 분류하고 PR을 생성하고 싶은 경우 (--cron 모드).
• 포크 기반 기여 모델로 작업하며 업스트림 저장소를 대상으로 하는 PR과 함께 브랜치를 포크에 푸시해야 하는 경우 (--fork).
• PR 리뷰 댓글을 자동으로 처리하고 싶은 경우 — --reviews-only를 사용하면 gh-issues가 열린 fix/issue-* PR을 스캔하고 요청된 변경 사항에 대한 수정을 푸시합니다.

• 이슈가 모호하거나, 아키텍처적이거나, 범위가 매우 넓은 경우 — gh-issues의 서브 에이전트는 자체적으로 신뢰도를 평가하여 7/10 미만으로 평가된 이슈는 건너뜁니다. 단, 매우 복잡한 이슈는 수동으로 처리해야 합니다.
• 정확성이 반드시 보장되어야 하는 경우 — 서브 에이전트는 가능한 경우 테스트를 실행하지만, 자동 생성된 수정 사항은 프로덕션에 병합하기 전에 검토해야 합니다.
• GitHub 토큰(GH_TOKEN)이 없는 경우 — 토큰 없이는 gh-issues가 GitHub API에 인증할 수 없습니다.

최대 8개의 서브 에이전트가 동시에 실행되며, 각각 단일 이슈를 처음부터 끝까지 처리합니다: 브랜치 생성, 코드 분석, 수정 구현, 테스트 실행, 커밋, 푸시, PR 열기. 각 에이전트는 60분의 시간 예산을 가지며 내장된 신뢰도 검사를 수행합니다 — 신뢰도 ≥7/10으로 처리할 수 없는 이슈는 건너뜁니다.

PR이 열린 후, Phase 6은 리뷰, 인라인 댓글, 일반 PR 댓글, 그리고 임베디드 봇 리뷰(예: Greptile)까지 가져옵니다. 실행 가능한 댓글은 추가 서브 에이전트를 트리거하여 브랜치를 체크아웃하고, 요청된 변경 사항을 적용하고, 업데이트를 푸시하며, 각 댓글에 커밋 SHA로 답글을 답니다.

--fork user/repo를 전달하면 모든 브랜치를 내 포크에 푸시하고, 포크에서 업스트림 소스 저장소를 대상으로 PR을 열 수 있습니다 — 업스트림에 대한 쓰기 권한 없이도 표준 오픈소스 기여 워크플로우를 그대로 따를 수 있습니다.

--cron은 실행 후 잊어버리는(fire-and-forget) 스케줄링을 활성화합니다: 오케스트레이터가 처리 가능한 이슈 하나를 선택하고, 서브 에이전트를 생성한 후 즉시 종료합니다 — 몇 분마다 크론 작업에서 호출하기에 안전합니다. --watch는 오케스트레이터를 계속 실행 상태로 유지하며, 설정 가능한 간격으로 새로운 이슈와 리뷰 댓글을 폴링합니다.

스폰하기 전에, 스킬은 기존의 열린 PR, 푸시 레포의 진행 중인 브랜치, 그리고 2시간 만료 기한이 있는 로컬 클레임 파일을 확인합니다. 이를 통해 겹치는 크론 실행 또는 감시 사이클에서 동일한 이슈를 두고 중복 서브 에이전트들이 경쟁하는 것을 방지합니다.

Telegram 채널 ID와 함께 --notify-channel을 전달하면 PR 링크와 이슈별 결과가 포함된 최종 요약 메시지를 받을 수 있습니다. 중간 상태 업데이트는 전송되지 않으며, 최종 결과만 전송됩니다.

스케줄된 작업에서 /gh-issues owner/repo --label bug --limit 10 --cron을 실행하세요. 각 호출은 다음으로 처리되지 않은 버그 이슈를 선택하고, 수정 사항을 구현하기 위한 서브 에이전트를 생성한 후 종료됩니다. 시간이 지남에 따라 실행 사이에 사람의 개입 없이 백로그가 점진적으로 처리됩니다.

/gh-issues upstream/project --fork myfork/project --label good-first-issue 명령어를 사용하면 스킬이 업스트림 저장소에서 이슈를 가져오고, 수정 브랜치를 포크에 푸시하며, 업스트림을 대상으로 PR을 열어 표준 기여자 워크플로우를 준수합니다.

기존 PR 파이프라인과 함께 /gh-issues owner/repo --reviews-only --cron을 스케줄링하세요. 각 실행 시 열려 있는 fix/issue-* PR에서 처리되지 않은 CHANGES_REQUESTED 리뷰 또는 인라인 댓글을 스캔하고, 처리되지 않은 첫 번째 PR을 선택한 후 요청된 변경 사항을 적용하고 답변하는 에이전트를 생성합니다.

스프린트 계획 세션 중에 /gh-issues owner/repo --label enhancement --watch --interval 10을 실행하세요. 이 스킬은 이슈를 가져온 후 처리할 항목을 확인하도록 요청하고, 에이전트를 생성하며, 10분마다 새로운 이슈와 리뷰 피드백을 폴링하여 'stop'이라고 말할 때까지 누적된 결과를 표시합니다.