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

steipete/github-project-triage

GitHub 이슈/PR 트라이징: 대기열, CI, 차단 요소, 위험, 증명, 다음 작업.

github-project-triage란 무엇인가요?

이 스킬은 GitHub 저장소의 이슈 및 풀 리퀘스트를 효율적으로 트라이징(분류 및 우선순위 지정)하기 위한 전문 도구입니다. 사용자가 'triage'라고 입력하면 현재 저장소의 GitHub 프로젝트를 자동으로 분석하여 각 항목의 URL, 내용, 중요성, 작성자 신뢰도, 적합성, 위험도, 증명/테스트 상태, 차단 요소 및 다음 조치를 상세히 설명합니다. 단순히 대기열 번호만 반환하지 않고, URL을 우선으로 표시하여 실무 유지보수자(maintainer)가 즉시 조치를 취할 수 있도록 합니다. 이 스킬은 Claude Code, Cursor, Codex와 같은 AI 에이전트 플랫폼에서 사용하도록 설계되었으며, 특히 로컬 개발 환경에서 명령어 실행, CI 상태 확인, 코드 리뷰, 그리고 안전한 자율 작업 모드를 지원합니다. 주요 기능으로는 `repobar`를 통한 빠른 저장소 대기열 탐색, `gh` CLI를 통한 세부 이슈/PR 조회, 로컬 저장소 상태 확인(깨끗한 작업 트리, main 브랜치 여부), 자율 작업 모드에서의 순차적 이슈 처리, 작성자 신뢰도 평가, 그리고 코드 변경 전후의 철저한 검증(로컬 테스트, 코드 리뷰, CI 확인)을 포함합니다. 이 스킬은 OpenClaw 및 ClawdBot 대기열에 특화되어 있으며, Peter/소유자의 의견을 최우선으로 따르고 VISION.md를 제품 적합성의 기준으로 활용합니다.

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

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

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

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

문서

GitHub Project Triage

사용자가 triage를 입력할 때마다 이 스킬을 사용하세요. 단, 요청이 명시적으로 GitHub 도메인이 아닌 대상을 목표로 하는 경우는 예외입니다. 저장소 안에서는 기본적으로 현재 GitHub 프로젝트를 사용하세요. 트라이징(Triage)은 유지보수자(maintainer)를 위한 항목 카드를 의미합니다: URL, 각 이슈/PR의 내용, 그 중요성, 작성자 신뢰도, 적합성, 위험도, 증명/테스트 상태, 차단 요소, 다음 조치. 대기열 번호나 불투명한 참조만 반환하지 마십시오.

출력은 URL 우선입니다: 표시되는 모든 이슈/PR/저장소 항목은 해당 항목의 첫 줄이나 첫 문장에 GitHub URL을 포함해야 합니다. 요약 목록을 제공하는 경우 항목당 하나의 URL을 출력하세요.

RepoBar를 관련 소유자/조직에 대한 광범위한 대기열 발견의 첫 번째 패스로만 사용하세요. RepoBar는 수동 gh repo list 루프보다 빠르고 프로필 인식 기능이 뛰어나며, 저장소 활동, 이슈 수, PR 수, 로컬 프로젝트, 인증, 캐시 및 필터를 이미 이해하고 있습니다.

설정

설치된 경우 실제 repobar 바이너리를 선호하세요. 이 작업 공간에서는 ~/Projects/RepoBar에 SwiftPM 제품으로만 존재할 수 있습니다.

repobar_cmd() {
  if command -v repobar >/dev/null 2>&1; then
    repobar "$@"
  elif [ -x "$HOME/Projects/RepoBar/.build/debug/repobarcli" ]; then
    "$HOME/Projects/RepoBar/.build/debug/repobarcli" "$@"
  else
    swift run --package-path "$HOME/Projects/RepoBar" repobarcli "$@"
  fi
}

repobar_cmd status --json

광범위한 트라이징을 위한 기본 소유자: steipete, openclaw. 광범위/기본 대기열 트라이징의 경우 openclaw/openclaw에 대한 세부 패스를 포함하세요. 저장소 수에서 첫 번째가 아니더라도, 이것이 주요 ClawdBot/OpenClaw 대기열이기 때문입니다. 사용자가 명명하거나, 현재 저장소가 이미 해당 소유자 아래에 있거나, 작업이 명시적으로 all/everything을 요청하지 않는 한 amantus-ai 또는 다른 소유자를 포함하지 마십시오. 정확한 소유자별 작업의 경우, 명명된 소유자를 넘어 확장하지 마십시오.

로컬 저장소 게이트

로컬 프로젝트 내에서 작업을 시작하기 전에 체크아웃이 준비되었는지 확인하세요:

git status --short --branch
git branch --show-current
git pull --ff-only
git status --short --branch

브랜치가 main이고, 풀(Pull)이 성공하며, 작업 트리(Worktree)가 깨끗할 때만 진행하세요. 브랜치가 main이 아니거나, 풀이 실패하거나, git status --short에 변경 사항이 있으면 중단하고 Peter에게 무엇을 해야 할지 물어보세요. 명시적인 지시 없이 브랜치를 전환, 스태시, 커밋, 리셋, 복원, 정리하지 마십시오.

범위 규칙

사용자가 triage라고 말하고 현재 작업 디렉토리가 GitHub 원격 저장소가 있는 Git 저장소인 경우, 해당 프로젝트만 트라이징하세요. 사용자가 broad, all, everything이라고 말하거나, 여러 소유자/조직을 명명하거나, 저장소 간 트라이징을 요청하지 않는 한 모든 Peter/조직 대기열로 확장하지 마십시오.

저장소에 VISION.md가 있으면 자율적으로 처리할 수 있는 항목을 판단하기 전에 이를 읽으세요. 제품 적합성의 진실 공급원(Source of Truth)으로 사용한 다음 이 스킬의 위험/테스트 가능성 규칙을 적용하세요. VISION.md가 없으면 아래의 자율 적합성 규칙을 사용하세요.

현재 프로젝트 찾기:

repo=$(gh repo view --json nameWithOwner --jq .nameWithOwner 2>/dev/null || true)
if [ -z "$repo" ]; then
  url=$(git remote get-url origin 2>/dev/null || true)
  repo=$(printf '%s\n' "$url" |
    sed -E 's#^[email protected]:##; s#^https://github.com/##; s#\.git$##')
fi
printf '%s\n' "$repo"

현재 프로젝트 트라이징은 다음으로 시작합니다:

gh issue list --repo "$repo" --state open --limit 50 \
  --json number,title,author,labels,createdAt,updatedAt,url
gh pr list --repo "$repo" --state open --limit 50 \
  --json number,title,author,isDraft,reviewDecision,mergeStateStatus,createdAt,updatedAt,url

어떤 이슈나 PR에 대해 조치를 취하기 전에 모든 댓글을 읽고 Peter/소유자의 댓글을 권위 있는 라우팅 지침으로 취급하세요. Peter가 좋아 보인다, 변경이 필요하다, 대체되었다, 제품 승인되었다, 또는 원하지 않는다고 말하면, 이는 봇 레이블과 일반적인 트라이징 판단을 무효화합니다. Peter/소유자 댓글이 없으면 유지보수자의 판단을 사용하고 결정은 당신의 몫이라고 말하세요.

그런 다음 표시된 모든 항목을 설명할 수 있을 만큼 충분한 세부 정보를 조사하세요. 소규모 대기열(약 10개의 열린 항목 이하)의 경우 모든 항목을 조사하세요. 더 큰 대기열의 경우 최우선 순위 항목을 조사하고 확장되지 않은 항목이 무엇인지 말하세요.

gh issue view <n> --repo "$repo" \
  --json number,title,author,body,comments,labels,createdAt,updatedAt,url
gh pr view <n> --repo "$repo" \
  --json number,title,author,body,comments,files,commits,isDraft,reviewDecision,mergeStateStatus,statusCheckRollup,createdAt,updatedAt,url
gh pr diff <n> --repo "$repo" --patch

강력한 증거가 있을 때만 댓글 달기, 닫기, 병합, 재실행 또는 패치를 수행하세요.

트라이징 출력

사용자가 triage라고 말하면 항상 현재 저장소의 열린 이슈와 열린 PR을 스캔하세요. 반환:

  • 자율 후보(Autonomous candidates): 더 이상의 제품 입력 없이 수정/적용 가능해 보이는 항목. URL, 자격을 갖춘 이유, 필요한 확인, 확신 수준을 포함합니다. 이는 검토를 위한 선택이며, 사용자가 자율 실행을 요청하지 않는 한 작업을 시작할 수 있는 권한이 아닙니다.
  • Peter 필요(Needs Peter): Peter/소유자 결정, 제품 방향, 누락된 자격 증명/액세스, 얻을 수 없는 라이브 공급자 증명, 보안/개인정보 보호 판단, 또는 변경을 요청하는 권위 있는 Peter 댓글로 인해 차단된 항목.
  • 연기/닫기/대체(Defer/close/supersede): 오래되거나, 중복되거나, 품질이 낮거나, 겹치는 항목으로, 예상되는 조치가 새 코드가 아닌 항목.

모든 그럴듯한 자율 후보에 대해, 도구 지원이 존재하는 경우 사용 가능한 고추론 하위 에이전트, 오라클 또는 독립 에이전트 검토를 사용하여 제시하기 전에 실현 가능성을 확인하세요. 하위 에이전트에게 작업 로컬 증거만 제공하고 항목을 자율적으로 완료할 수 있는지, 어떤 확인이 필요한지, 무엇이 안전하지 않게 만들 수 있는지 물어보세요. 하위 에이전트를 사용할 수 없으면 직접 동일한 깊이로 수행하고 그렇게 말하세요.

자율 작업 모드

사용자가 do work autonomously, work you can do autonomously, keep going 또는 이와 유사하게 말하면, 대기열 요약이나 하나의 로컬 패치 후에 멈추지 마세요. 이를 안전한 자율 항목이 더 이상 남지 않거나, 각 항목이 증거와 함께 적용/닫기/연기되거나, Peter가 필요한 차단 요소가 발생할 때까지 적격 이슈/PR 대기열을 순차적으로 처리할 수 있는 권한으로 취급하세요.

여러 티켓을 동시에 작업하지 마십시오. 각 항목에 대해:

  1. 이슈/PR, 관련 코드, 문서, CI 및 VISION.md(있는 경우)를 읽으세요. 사실이 오래되었거나 불명확할 수 있는 경우 Google/공식 문서를 사용하세요.
  2. 자율적인지 결정하세요:
    • 진행(Go): 복잡성이 너무 증가하지 않는 한 성능 개선; 재현/근본 원인 및 검증 경로가 있는 버그 수정; 작은 UI/UX 조정; 문서 수정; 좁은 테스트/내부 수정; 녹색 증거가 있는 저위험 의존성/CI 정리.
    • 먼저 물어보기(Ask first): 새 기능, 제품/비전 선택, 광범위한 동작 변경, 위험한 의존성, 강력한 증거가 없는 보안에 민감한 변경, 사용 가능한 자격 증명이 없는 라이브 공급자 작업, 종단 간 테스트할 수 없는 모든 것.
    • 리팩터 선호: 자율 항목에 대한 더 나은 수정인 경우 깔끔하고 경계가 명확한 리팩터를 선택하세요. 더 나쁜 설계를 남기는 경우 "작은 패치"를 기본값으로 사용하지 마십시오.
  3. 최상의 유지 관리 가능한 방식으로 PR을 구현하거나 수정하세요. 쓰기 가능한 경우 기여자 PR을 업데이트하는 것을 선호하세요. 그렇지 않으면 크레딧과 함께 로컬에서 다시 생성하세요.
  4. 가능한 경우 로컬 및 라이브 종단 간 확인하세요. UI 동작의 경우 Peekaboo, browser-use, 스크린샷 또는 VM 증명과 같은 저장소의 예상 라이브 UI 증명 경로를 사용하세요. API/공급자 동작의 경우 사용 가능한 경우 예상 비밀 워크플로를 통해 실제 사용 가능한 키/계정을 사용하세요. 액세스가 없으면 항목이 완료된 것처럼 가장하기 전에 중단하고 Peter에게 도움을 요청하세요.
  5. 커밋/적용 전에 Codex Auto Review를 실행하세요(사소하거나 문서 전용 또는 명시적으로 건너뛴 경우 제외). 수락된/실행 가능한 발견 사항을 해결하세요.
  6. CI가 녹색이고, PR 설명/변경 로그가 양호하며, 적용/닫기/댓글을 증거와 함께 남기고, main으로 돌아가서 --ff-only 풀을 수행하고, 다음 자율 항목을 선택하기 전에 깨끗한 작업 트리를 확인하세요.
  7. 모든 적용된 PR 후에, PR 댓글에 테스트 방법(로컬 명령어, 라이브/UI/API 증명, CI 실행/검사 상태, 적용된 커밋 및 모든 주의 사항)을 정확히 게시하세요. 확인 이미지를 적용할 수 있는 경우 사용 가능할 때 gh image로 업로드/게시하세요. 업로더를 사용할 수 없으면 그렇게 말하고 스크린샷 경로 또는 대체 GitHub 첨부 파일 증명을 포함하고, 이미지를 조용히 생략하지 마십시오.

차단되지 않는 한 더티 파일이나 푸시되지 않은 로컬 수정으로 자율 모드를 종료하지 마십시오. 차단된 경우 정확한 차단 요소, 현재 브랜치/상태, 이미 수집된 증명 및 필요한 다음 결정을 명시하십시오.

자율 작업은 여전히 범위에 의해 제한됩니다: 기본적으로 현재 저장소; 사용자가 broad/all/everything을 요청하거나 소유자/조직을 명명한 경우에만 광범위/모든 대기열.

신뢰 신호

추천하는 모든 비유지보수자 항목에 대해 작성자/오프너 신뢰도를 포함하세요. 저위험 Dependabot/내부 항목의 경우 간결한 봇/내부 신뢰 라인으로 충분합니다.

번들된 도우미를 선호하세요:

skills/github-project-triage/scripts/github-activity.sh --repo <owner/repo> --global <login>

이 스킬 체크아웃에 도우미가 없는 경우 대체:

~/Projects/clawdbot/.agents/skills/openclaw-pr-maintainer/scripts/github-activity.sh --repo <owner/repo> --global <login>

PR이 더 깊은 신뢰 판단을 필요로 할 때, 특히 OpenClaw, 보안에 민감한 변경, 광범위한 PR, 새 계정 또는 비정상적인 작성자 행동의 경우 github-author-context도 사용하세요. 먼저 기존 기여자 노트를 선호하세요:

~/Projects/maintainers/scripts/clawtributors find github <login>

신뢰 출력은 사실대로 유지해야 합니다:

신뢰: @login; 계정 2021-04-03; 저장소 12개월 동안 2 PR/1 이슈/0 커밋; GitHub 9 PR/3 이슈/12 리뷰; 신호: 알려진 기여자 / 새로운 단기 방문 / 봇 / 알 수 없음.

신뢰를 증명으로 취급하지 마십시오. 이는 검토 깊이를 변경할 뿐, 정확성을 변경하지 않습니다.

항목 평가

각 항목 분류:

  • 버그(bug): 가능한 경우 재현/로그/실패 테스트/현재-main 증명 필요; 수정/병합을 추천하기 전에 근본 원인 식별.
  • 기능(feature): 종단 간 테스트 계획 필요. 라이브 검증에 공급자 키, 계정, 장치, 서비스, 모델 액세스 또는 유료 API가 필요한 경우, 작업이 완료된 것으로 간주되기 전에 정확히 어떤 자격 증명/액세스가 누락되었는지 말하세요.
  • 의존성(dependency): 패키지 그룹, 주/부 위험, 실패한 검사, 런타임/엔진 변경 및 분할 여부 설명.
  • 보안(security): 우선 순위를 높이고, 신중한 코드 경로 증명, 테스트 및 신뢰/컨텍스트 필요; 근거만으로 병합하지 마십시오.
  • 문서/내부(docs/internal): 위험이 낮지만, 여전히 사용자에게 보이는 관련성과 오래된/생성된 변동 위험을 설명하십시오.

판단:

  • 적합성(Fit): 좋음 / 혼합 / 나쁨, 한 가지 이유 포함.
  • 위험(Risk): 낮음 / 중간 / 높음, 영향 범위 포함.
  • 증명(Proof): 현재 CI, 로컬 재현, 실패 테스트, 라이브 E2E 또는 누락된 증명.
  • 차단 요소(Blocker): 첫 번째 기여자 CI 승인, 실패한 검사, 누락된 키, 불명확한 제품 방향, 오래된 브랜치, 신뢰할 수 없는/광범위한 diff, 재현 불가, 충돌.
  • 다음(Next): CI 승인, 테스트 실행, 재현 요청, PR 분할, 로컬 패치, 녹색 후 병합, 증명과 함께 닫기 또는 연기.

빠른 대기열 맵

범위가 광범위할 때만 사용하세요. 저장소 수준 대기열 맵으로 시작하세요. 이는 열린 이슈 및/또는 PR이 있는 저장소를 찾고 개수를 제공합니다.

PR 대기열, 기본 트라이징 순서:

repobar_cmd repos \
  --scope all \
  --only-with work \
  --owner steipete \
  --owner openclaw \
  --sort prs \
  --json

이슈 압력, 이슈가 중요할 때 두 번째 패스:

repobar_cmd repos \
  --scope all \
  --only-with work \
  --owner steipete \
  --owner openclaw \
  --sort issues \
  --json

--forks 및 --archived는 사용자가 "all", "everything"을 말하거나 고고학을 요청할 때만 사용하세요. 기본 트라이징은 해당 대기열이 특별히 관련되지 않는 한 포크와 보관된 저장소를 생략해야 합니다.

간결한 터미널 보기의 경우:

repobar_cmd repos --scope all --only-with work --owner steipete --owner openclaw --sort prs --plain

유용한 jq 요약:

repobar_cmd repos --scope all --only-with work --owner steipete --owner openclaw --sort prs --json |
  jq -r '.[] | [.fullName, .openIssues, .openPulls, .activityTitle, .activityActor] | @tsv'

PR 정렬 대기열을 요약할 때 RepoBar의 PR 개수 순서를 유지하세요. 동일한 소유자 범위에서 PR이 더 많은 저장소를 생략하면서 PR이 더 적은 저장소를 포함하지 마십시오. 이슈가 0이고 PR이 열려 있는 저장소(예: openclaw/crabbox)는 여전히 트라이징 대상입니다.

세부 패스

광범위한 대기열 맵 후, 사용자가 명시적으로 철저한 세부 정보를 원하지 않는 한 상위 저장소만 검사하세요.

repobar_cmd issues <owner/name> --limit 50 --json
repobar_cmd pulls <owner/name> --limit 50 --json
repobar_cmd ci <owner/name> --limit 20 --json
repobar_cmd activity <owner/name> --limit 20 --json

병합 가능하거나 의심스러워 보이는 PR의 경우 gh로 전환하여 유지보수자 수준 상태를 확인하세요:

gh pr view <n> --repo <owner/name> --json number,title,state,author,isDraft,mergeStateStatus,reviewDecision,statusCheckRollup,updatedAt,url
gh pr diff <n> --repo <owner/name> --patch
gh run list --repo <owner/name> --branch <branch> --limit 10

이미 수정되었을 수 있는 이슈의 경우 gh issue view로 전환한 다음, 댓글을 달거나 닫기 전에 현재 소스를 검사하세요.

OpenClaw/ClawdBot 대기열의 경우 유용할 때 OpenClaw 유지보수자 패스를 사용하세요:

  • 사용 가능한 경우 gitcrawl로 중복/관련 스레드 검색;
  • 오프너/작성자 ID에 활동 도우미 사용;
  • 사용자가 유지보수자 소유 작업을 요청하지 않는 한 최상위 유지보수자 노이즈 억제;
  • 명확한 증거가 있는 외부/사용자 보고 버그 및 PR 선호.

로컬 교차 검증

작업이 로컬 프로젝트 상태, 더티 저장소 또는 "내가 여기서 무엇을 소유하고 있나"를 언급할 때 사용하세요.

repobar_cmd local --root "$HOME/Projects" --depth 1 --limit 200 --plain
repobar_cmd local --root "$HOME/Projects" --depth 1 --sync --limit 200 --json

사용자가 명시적으로 요청하지 않는 한 파괴적인 로컬 작업(local reset, 브랜치 삭제, 체크아웃 이동)을 실행하지 마십시오.

트라이징 휴리스틱

우선 순위:

  • 녹색 또는 거의 녹색 CI, 최근 유지보수자 활동 또는 저위험 의존성/문서/테스트 변경이 있는 PR.
  • 열린 PR 수가 많지만 최근 활동이 있는 저장소는 종종 명백한 정리 작업을 숨기기 때문입니다.
  • 재현 가능하고, 최근에 보고되었거나, 릴리스를 차단하는 이슈.
  • 보안, 릴리스, 인증, 설치, CI 및 데이터 손실 보고서

…

[번역을 위해 잘림]

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-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

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.

관련 스킬