By 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
- GH CLI 쓰기 작업 금지 (코멘트, PR 생성 등)
- push/PR 생성은 사용자가 직접
- 검증 실패 시 진행 금지
- 이슈 범위 외 변경 금지