oss-process

name	oss-process
description	오픈소스 기여 실행. oss-clarify 분석 후 실제 기여 작업 수행 — 브랜치 생성, 코드 수정, 테스트, 커밋 메시지 추천. Execute open source contribution after oss-clarify analysis. Use when the user says 'proceed', 'contribute now', 'OSS 작업 시작', '기여 진행', or confirms they want to start working on an issue.

OSS Contribution Process

oss-clarify 분석 결과를 바탕으로 실제 기여 작업을 수행한다.

Core Principles

• 최소 변경: 이슈 해결에 필요한 변경만. 관련 없는 리팩토링/포맷팅 금지.
• 컨벤션 준수: 해당 프로젝트의 기존 패턴을 따른다.
• GH CLI는 조회 전용: 코멘트, PR 생성 등 쓰기 작업 금지.
• 커밋까지만: push, PR 생성은 사용자가 직접 수행.

Execution

Phase 1: Convention Analysis

기여 가이드와 기존 코드를 분석하여 컨벤션을 파악한다:

• Git: 브랜치 네이밍, 커밋 메시지 포맷, squash merge 여부
• 코드: 들여쓰기, 네이밍, import 순서, 타입 어노테이션
• 테스트: 프레임워크, 파일 위치, 작성 패턴
• 빌드: dev setup, 의존성 설치, lint/format/test/build 명령

# 최근 커밋 패턴 확인
git log --oneline -10
# 기존 브랜치 패턴 확인
gh pr list --repo {owner}/{repo} --state merged --limit 5 --json headRefName

Phase 2: Branch & Implementation

git fetch origin && git checkout main && git pull origin main
git checkout -b {branch-name}  # 컨벤션에 맞게

구현 시 체크:

• 기존 코드 스타일과 일관성 유지
• 기존 패턴/추상화 활용
• breaking change 지양
• 이슈 범위 외 변경 금지

Phase 3: Verification

모든 체크를 순서대로 실행. 하나라도 실패하면 수정 후 재검증.

{lint-command}       # e.g., npm run lint
{format-command}     # e.g., cargo fmt --check
{typecheck-command}  # e.g., mypy
{test-command}       # e.g., pytest
{build-command}      # e.g., npm run build

Phase 4: Commit Message

최근 10개 커밋 메시지 패턴을 분석하여 1~2개 옵션 추천.

git add {changed-files}
git commit -m "{recommended-message}"

Output

## OSS 기여 작업 완료

### 요약
| 항목 | 내용 |
|------|------|
| 레포 | {owner}/{repo} |
| 이슈 | #{issue_number} |
| 브랜치 | {branch-name} |

### 변경 사항
{변경된 파일 및 내용 요약}

### 검증 결과
| 항목 | 결과 |
|------|------|
| 린트 | PASS/FAIL |
| 테스트 | PASS/FAIL |
| 빌드 | PASS/FAIL |

### 커밋 메시지 추천

{recommended commit message}

### 다음 단계 (사용자 수행)
1. 커밋 확인 후 push: `git push origin {branch-name}`
2. PR 생성: `gh pr create`
3. PR 템플릿에 맞게 설명 작성

Critical Rules

1. GH CLI 쓰기 작업 금지 (코멘트, PR 생성 등)
2. push/PR 생성은 사용자가 직접
3. 검증 실패 시 진행 금지
4. 이슈 범위 외 변경 금지