메뉴
jira-start — Jira 이슈를 조회하고 feature 브랜치를 생성한 뒤 상태를 In Progress로 전환합니다. Jira 이슈 작업을 시작할 때, '이슈 시작해줘', '작업 시작', '브랜치 만들어줘', 'feature 브랜치 생성', 'In Progress로', 'jira start', '티켓 잡아줘' 등의 요청에 이 스킬을 사용하세요. Jira 워크플로우의 첫 단계로, /jira-clarify 또는 /jira-plan 이전에 사용합니다.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
커밋 전 최종 품질 게이트. aggregate-verdict 확인 + 프로젝트별 빌드/타입체크/린트를 종합 검증합니다. '/harness-gate', 'harness gate', '품질 게이트', '커밋 전 검증' 요청 시 사용 — 커밋 직전 최종 게이트(jira-commit 의 DoD 검증과 독립).
Jira 개발 가이드(dev-guide)를 읽고 Sprint Contract를 보충 생성합니다. /jira-plan 이후에 실행하여 DoD, Verify Targets, Out of Scope를 명시화합니다. '/harness-plan', 'harness plan', 'Sprint Contract 만들어줘', '계획 보충' 요청 시 사용.
이전 세션의 체크포인트를 복원하여 작업을 이어갑니다. workflow-state.json과 checkpoint.md를 읽어 중단된 단계부터 재개합니다. '/harness-resume', 'harness resume', '이어서 작업', '이전 작업 복원' 요청 시 사용.
코드 변경 사항에 대해 프로젝트별 전문 에이전트를 병렬 fan-out으로 리뷰하고 종합 verdict(PASS/ITERATE/ESCALATE)를 생성합니다. '/harness-review', 'harness review', 'harness 리뷰', '품질 리뷰' 요청 시 사용.
Post-merge VALID/INVALID 채점 — 머지 후 7일 이상 경과한 이슈의 aggregate-verdict.md에 사후 평가를 기록합니다. Harness의 catch rate/false positive rate 측정에 사용. 자기 채점 편향 방지를 위해 별도 세션에서 외부 증거와 함께 수행. '/harness-score', 'harness score', '사후 평가', 'post-merge scoring', 'catch rate 측정' 요청 시 사용.
AI Agent Harness Engineering infrastructure auto-provisioner. Detects project stack (Spring Boot, Vue, React, etc.) and generates project-scoped agents, hooks, settings, CLAUDE.md rules, runtime directories, and metrics infrastructure. Idempotent — safely run on new or partially configured projects; only adds what's missing. Use this skill whenever: the user says 'harness setup', 'set up harness', 'configure harness', 'harness-setup', 'add harness to project', 'init harness', 'harness 설정', 'harness 구성', 'harness 초기화', 'harness 세팅', 'new project harness', 'upgrade harness', 'check harness status', 'harness check'. Also trigger when user asks to add agents, hooks, or quality gates to a project even without explicitly saying 'harness'.
| name | jira-start |
| description | jira-start — Jira 이슈를 조회하고 feature 브랜치를 생성한 뒤 상태를 In Progress로 전환합니다. Jira 이슈 작업을 시작할 때, '이슈 시작해줘', '작업 시작', '브랜치 만들어줘', 'feature 브랜치 생성', 'In Progress로', 'jira start', '티켓 잡아줘' 등의 요청에 이 스킬을 사용하세요. Jira 워크플로우의 첫 단계로, /jira-clarify 또는 /jira-plan 이전에 사용합니다. |
Jira 이슈를 조회하고 feature 브랜치를 생성한 뒤 상태를 In Progress로 전환합니다. 지라에 댓글이나 설명을 작성할 때에는 한글로 작성합니다.
/jira-start <ISSUE-KEY>
ISSUE-KEY: Jira 이슈 키 (예: SURINP-20, SCRUM-42, PROJ-100)작업 디렉토리에서 프로젝트 스택을 자동 감지합니다 — 감지 매핑은 ~/.claude/skills/_stack-detection.md §1 참조.
감지된 스택 정보를 이후 단계의 컨텍스트로 활용합니다.
MCP Atlassian 도구를 사용하여 이슈 정보를 조회합니다:
git checkout -b feature/<ISSUE-KEY>
작업을 시작하는 사람이 이슈의 책임자라는 게 명확해야 추적·리뷰·알림이 정확해집니다. 따라서 이슈 상태를 바꾸기 전에 담당자를 현재 개발 중인 유저로 잡습니다.
mcp__atlassian__atlassianUserInfo 로 현재 인증된 Jira 유저 정보를 조회 → accountId 확보assignee.accountId 와 비교:
mcp__atlassian__editJiraIssue 로 fields.assignee = { "accountId": "<현재 유저 accountId>" } 패치🔁 담당자: <이전> → <현재 유저 displayName> 표기atlassianUserInfo 호출이 실패하거나 accountId 를 못 얻으면 담당자 지정은 건너뛰고 경고만 출력 (작업 시작 자체는 막지 않음)Cloud Jira 는 username 이 아니라
accountId만 받습니다. 절대로 email/username 으로 assignee 를 패치하지 마세요.
getTransitionsForJiraIssue → transitionJiraIssue)작업 시작: feature/<ISSUE-KEY> 브랜치 생성 (스택: <감지된 스택>, 담당: <현재 유저 displayName>)✅ <ISSUE-KEY> 작업 시작
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📋 제목: <이슈 제목>
🎯 우선순위: <우선순위>
📌 상태: <이전 상태> → In Progress
👤 담당자: <현재 유저 displayName> (<accountId 앞 8자>)
🔧 스택: <감지된 스택>
📝 주요 작업 내용:
<이슈 설명 요약>
🌿 브랜치: feature/<ISSUE-KEY>
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
다음 단계: 개발 작업 수행 후 /jira-test 실행
사용자가 /jira-start <KEY> --subtasks 로 호출하고 부모 이슈에 하위 작업이 있으면, 부모 처리 후 추가로 다음을 수행:
subtasks 필드에서 하위 키 목록 추출<PARENT> 의 일부로 작업 시작. 같은 feature 브랜치 feat/<PARENT> 공유.")자세한 정책: ~/.claude/skills/_subtasks-convention.md § 3 (스킬별 액션 매트릭스), § 5 (댓글 템플릿)