oss-clarify

name	oss-clarify
description	오픈소스 기여 가능성 분석. GitHub 레포 URL 또는 이슈 링크를 받아 기여 가능 여부를 판단. Analyze open source contribution viability — use when the user asks about contributing to a GitHub repo, wants to find good first issues, or asks if an issue is worth working on. Trigger on phrases like 'contribute', 'open source', 'good first issue', 'can I work on this', '기여', '오픈소스'.

OSS Contribution Clarify

오픈소스 기여 가능성을 분석하여 추천/비추천을 판단한다.

Step 0: Input Gathering

인자 없이 호출 시 현재 디렉토리가 git repo인지 확인:

git rev-parse --is-inside-work-tree
git remote get-url upstream 2>/dev/null || git remote get-url origin

• GitHub 레포 → 분석 유형 질문 (특정 이슈 / 전체 이슈)
• GitHub 아닌 경우 → 레포 URL 또는 이슈 URL 입력 요청

Step 1: Repository Analysis

gh CLI로 레포 정보를 수집한다. 순서대로:

1. 기여 가이드 확인 — CONTRIBUTING.md, README, PR 템플릿, 이슈 템플릿
2. PR 문화 파악 — 최근 merged PR 20개 확인: first-timer 머지 사례, 리뷰 속도, 기각 패턴
3. 후보 이슈 검색 (레포 URL인 경우) — good first issue, help wanted 라벨 이슈

gh pr list --repo {owner}/{repo} --state merged --limit 20
gh issue list --repo {owner}/{repo} --label "good first issue" --state open --limit 20
gh issue list --repo {owner}/{repo} --label "help wanted" --state open --limit 20

Step 2: Issue Analysis

대상 이슈별로 확인:

1. 관련 PR 체크 — 이미 PR이 올라왔거나 해결 중인지
2. 작업자 체크 — assignee, "I'll work on" 등 작업 선언 여부, Draft PR 존재 여부
3. 유효성 & 복잡도 — 이슈가 아직 유효한지, 난이도 (low/medium/high)

gh pr list --repo {owner}/{repo} --search "#{issue_number}" --state all
gh issue view {issue_number} --repo {owner}/{repo} --json assignees,comments

Step 3: Judgment

수집한 정보를 종합하여 판단한다. 핵심 기준:

• 자동 제외: 이미 PR로 해결 중 / 누군가 최근 2주 내 작업 선언 / 이슈 자체가 무효
• 추천: 기여 가이드 명확, PR 문화 개방적, 작업자 없음, 복잡도 적절
• 비추천: PR 문화 폐쇄적, 이슈 모호, 복잡도 과다

점수(100점 만점)와 함께 추천/조건부/비추천으로 판단.

Output Format

## OSS 기여 분석: {owner}/{repo}#{issue_number}

### 레포 분석
- 기여 가이드: {요약}
- PR 문화: {요약}

### 이슈 분석
| 항목 | 결과 |
|------|------|
| 관련 PR | {상태} |
| 작업자 | {상태} |
| 유효성 | {판단} |
| 복잡도 | {level} |

### 판단: {추천/조건부/비추천} ({점수}/100)
리스크: {있으면}
권장: {있으면}

Step 4: Next Action

점수 50+ 시 사용자에게 진행 여부 확인 → "네" 시 oss-process 호출.

Error Handling

상황	대응
GH CLI 인증 실패	gh auth login 안내
레포 접근 불가	private 여부 확인
후보 이슈 0개	"기여 가능한 이슈 없음" 안내