Community생산성 & 협업github.com

issue-project-init

GitHub 저장소에 이슈 트래킹을 부트스트랩합니다: 표준 레이블, Status/Reach/Impact/Confidence/Effort/RICE 필드를 포함한 Projects v2 보드를 생성하고(처음부터 또는 참조 보드 복사), 저장소에 연결하고 워크플로를 문서화합니다. 새 저장소에 이슈와 프로젝트를 설정하거나 레이블/필드가 변경되었을 때 사용합니다.

issue-project-init란 무엇인가요?

이 스킬은 GitHub 저장소에서 일관된 이슈 트래킹 체계를 설정합니다. 표준 버그, 기능, 기술 부채, 에픽 레이블과 함께 에이전트 라우팅을 위한 ai/needs-context/needs-human 레이블을 생성하고, Status, Reach, Impact, Confidence(%), Effort(일), RICE 점수 필드를 가진 Projects v2 보드를 생성합니다. 참조 보드에서 필드와 뷰를 복사하거나 처음부터 만들 수 있습니다. 그런 다음 보드를 저장소에 연결하고 작업 흐름 규칙(레이블 규칙, 프로젝트 필드 설명, 이슈 바디 구조, 작업 전/중/후 절차)을 포함한 문서를 AGENTS.md 또는 CLAUDE.md에 추가합니다. 이 스킬은 GitHub CLI(gh)와 jq에 의존하며 모든 작업을 수행하기 전에 사용자 승인을 요청합니다. 다른 issue-* 스킬(issue-search, issue-file, issue-start 등)이 올바르게 작동하는 데 필요한 기본 규칙을 설정합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/marsv024/gh-issue-skills/tree/master/skills/issue-project-init

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

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

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

문서

저장소에 이슈 및 프로젝트 초기화

다른 issue-* 스킬이 가정하는 규칙을 설정합니다. 여기서는 GitHub에 쓰는 모든 작업(레이블, 프로젝트, 저장소 링크)을 수행합니다. 만들 내용을 먼저 설명하고 사용자의 승인을 받으세요. git에는 아무것도 푸시되지 않습니다.

전제 조건: gh auth status에서 repo 및 project 스코프가 표시되어야 합니다(그렇지 않으면 gh auth refresh -s project 실행). jq가 설치되어 있어야 합니다.

1. 검사 (읽기 전용)

REPO=$(gh repo view --json nameWithOwner -q .nameWithOwner); OWNER=${REPO%%/*}
gh label list --repo "$REPO" --limit 100
gh project list --owner "$OWNER"

2. 레이블

아래 표준 레이블을 생성합니다(이름|설명|색상). 저장소 고유의 컴포넌트 레이블을 추가합니다(기본 backend, frontend; 필요에 따라 제거하거나 추가). 요청이 없는 한 GitHub 기본 레이블(enhancement, documentation, ...)은 그대로 둡니다.

while IFS='|' read -r n d c; do
  gh label create "$n" --repo "$REPO" --description "$d" --color "$c" --force
done <<'EOF'
bug|무언가가 제대로 작동하지 않음|d73a4a
feature|새로운 사용자 대상 기능|a2eeef
tech-debt|관리 대상 기술 부채|fbca04
eopic|여러 이슈를 아우르는 작업|5319e7
backend|백엔드 / 서비스|0e8a16
frontend|프론트엔드 / 웹 앱|1d76db
performance|성능|fef2c0
security|보안|d93f0b
testing|테스트 / CI / E2E|c5def5
privacy|개인정보 / GDPR|bfdadc
ai|인간의 개입 없이 AI 에이전트가 처리 가능|7057ff
needs-context|빠른 확인이나 결정이 해결되면 AI가 처리 가능 (ai도 함께 포함)|fbca04
needs-human|디바이스, 상점/법무/소유자 결정, 외부 접근 또는 로드맵 선택 필요|d93f0b
wontfix|작업하지 않음|ffffff
EOF
g label list --repo "$REPO"      # create는 성공 시 자동 출력 없음: 확인

3. 보드

A. 참조 보드 복사 (항목 제외, 필드 및 뷰만):

gh project copy <소스-번호> --source-owner <소유자> --target-owner "$OWNER" --title "<저장소 이름>"

B. 처음부터 생성:

gh project create --owner "$OWNER" --title "<저장소 이름>" --format json -q '.number'   # $N으로 기록
for f in Reach Impact "Confidence (%)" "Effort (days)" RICE; do
  gh project field-create "$N" --owner "$OWNER" --name "$f" --data-type NUMBER
done

새 보드에는 이미 Status 필드와 Todo, In Progress, Done 값이 있습니다. 이것으로 충분합니다(보드 UI에서 Defer 옵션을 추가할 수 있습니다).

그런 다음 연결하고 확인합니다:

gh project link "$N" --owner "$OWNER" --repo "$REPO"
# 그런 다음 issue-project-fields의 "Resolve IDs first"를 따릅니다: 보드와 모든 필드를 찾을 수 있어야 함

4. 저장소에 문서화

이 섹션을 저장소의 에이전트 지침(AGENTS.md, CLAUDE.md 또는 둘 다)에 추가하고 <...> 자리 표시자(저장소, 보드 URL, 2단계에서 생성한 컴포넌트 레이블; 스킬이 플러그인에서 비롯된 경우 그 사실과 플러그인 이름을 명시)를 채웁니다. 기본 브랜치가 아닌 브랜치에 커밋합니다.

## 작업 추적 (GitHub 이슈)

백로그는 **GitHub 이슈**(`<소유자/저장소>`)에 있으며, **<보드 제목>** 프로젝트(<보드 URL>)에서 추적됩니다. 이슈는 컨텍스트 *및* 상태에 대한 진실 공급원입니다. 이슈 번호(`#123`)와 레이블로 작업을 참조합니다. 워크플로 스킬: `issue-search`, `issue-file`, `issue-start`, `issue-pr-refs`, `issue-close-out`, `issue-project-fields`, `issue-score`, `issue-link`, `issue-plan-doc`, `issue-file-found`, `issue-audit-scores`, `issue-project-init` (<출처>).

### 레이블

| 그룹 | 레이블 | 규칙 |
|---|---|---|
| 유형 | `bug`, `feature`, `tech-debt`, `epic` | 이슈당 정확히 하나 |
| 컴포넌트 | <예: `backend`, `frontend`> | 해당되는 만큼 |
| 주제 | `performance`, `security`, `testing`, `privacy` | 선택 사항 |
| 에이전트 라우팅 | `ai`, `needs-context`, `needs-human` | 선택 사항. `ai` = 에이전트가 무인으로 처리 가능; `needs-context` = 빠른 질문에 답변되면 에이전트가 처리 가능(`ai`도 함께 포함); `needs-human` = 디바이스, 외부 접근 또는 소유자 결정 필요 |

### 프로젝트 필드

| 필드 | 값 | 비고 |
|---|---|---|
| Status | Todo / In Progress / Done | 오케스트레이팅 에이전트만 설정 |
| Reach | 1–5 | 영향을 받는 사용자 수 |
| Impact | 0.5–3 | 효과의 크기 |
| Confidence (%) | 전체 백분율, 예: `70` | |
| Effort (days) | 숫자 | |
| RICE | `(Reach × Impact × Confidence) / Effort` | 본문에도 `**Score:** RICE x = (R × I × C%) / Ed` 형식으로 작성하여 이슈가 독립적으로 읽힐 수 있도록 함 |

### 이슈 본문 및 워크플로

**이슈 본문**에는 전체 기록(설명, 현재 상태, 해야 할 일, 중요한 이유, 관련 파일, 추정치)이 포함됩니다. 관련 작업은 `#n`으로 연결합니다. 순서는 "blocked by"(본문 텍스트 및 의존성 API, `issue-link` 참조)로 표현합니다. 큰 작업은 계획이 이슈 본문에 있고 하위 작업은 하위 이슈인 `epic`입니다.

- **시작 전:** 먼저 검색(`issue-search`); 중복 신청 대신 재사용 또는 확장합니다.
- **작업 중:** 항목을 In Progress로 설정하고 할당(`issue-start`); 브랜치 이름에는 이슈 번호를 포함(`feat/123-short-desc`). 버그와 기술 부채는 실패하는 테스트로 시작합니다. 관련 없는 발견은 범위를 확장하는 대신 새 이슈로 신고(`issue-file-found`).
- **완료 시:** 모든 PR은 해당 이슈를 참조(`Closes #n` 각 이슈별, `Part of #n` 에픽의 경우; `issue-pr-refs`); 머지 후 Status = Done으로 설정하고 관련 이슈 업데이트(`issue-close-out`).
- `gh`에는 `project` 스코프가 필요합니다(`gh auth refresh -s project`). 오케스트레이팅 에이전트만 이슈/프로젝트 상태를 변경합니다. 위임된 하위 에이전트는 이슈를 생성, 편집 또는 종료하지 않습니다.

5. 선택 사항: 에픽 시드

issue-file (유형 epic) → issue-plan-doc → 각 하위 작업별 issue-file + issue-link + issue-project-fields + issue-score.

주의 사항

  • gh label create, gh project copy|link|item-edit는 성공 시 자동 출력이 없습니다: 항상 확인하세요.
  • 복사된 보드는 빈 상태로 시작합니다. item-add는 멱등적입니다.
  • 하위 이슈 및 의존성 REST 호출은 이슈의 숫자형 데이터베이스 ID를 사용합니다(issue-link 참조).
  • Confidence는 전체 백분율입니다(70). 보드마다 ID가 다르므로 항상 다시 발견해야 합니다(issue-project-fields).

관련 스킬