Smart Linear Issue

Linear MCP 서버를 활용하여 Gitmoji 기반 한글 이슈를 생성/수정하고, 작업 히스토리를 코멘트로 기록하는 스킬입니다.

When to Use This Skill

Auto-activate when users request Linear issue operations:

이슈 생성 트리거

한글:

• "이슈 생성해줘" / "이슈 만들어줘" / "이슈 등록"

• "Linear 이슈 생성" / "버그 리포트" / "새 태스크"

• "티켓 만들어" / "이슈 추가"

영문:

• "create issue" / "new issue" / "add issue"

• "create Linear issue" / "bug report" / "new task"

이슈 수정 트리거

한글:

• "이슈 수정해줘" / "이슈 업데이트"

• "우선순위 변경" / "상태 변경" / "담당자 변경"

• "이슈 상태 바꿔줘"

영문:

• "update issue" / "modify issue"

• "change priority" / "change status" / "assign to"

코멘트 추가 트리거 (작업 히스토리)

한글:

• "코멘트 추가" / "작업 기록" / "히스토리 추가"

• "진행상황 업데이트" / "작업 로그"

영문:

• "add comment" / "log work" / "add history"

• "update progress" / "work log"

Do NOT activate for:

• Linear 관련 일반 질문이나 설명 요청

• 이슈 목록 조회만 하는 경우

• 프로젝트/팀 정보 확인

Workflow A: 이슈 생성

이슈 생성 요청 시 다음 단계를 순차적으로 수행합니다.

Step 1: 요청 분석

사용자 요청에서 핵심 정보를 추출합니다.

1.1 이슈 유형 파악:

• 버그/오류 → 🐛 bug

• 새 기능 → ✨ feature

• 리팩토링 → ♻️ refactor

• 문서 → 📝 docs

• 성능 → ⚡ perf

• 디자인/UI → 🎨 design

• 설정/환경 → 🔧 config

• 테스트 → ✅ test

• 보안 → 🔒 security

1.2 핵심 내용 추출:

• 문제 상황 또는 구현할 기능

• 영향 범위

• 기대 동작

Gitmoji 선택 가이드: references/gitmoji_mapping.md

Step 2: Linear 정보 조회

Linear MCP 도구로 필요한 정보를 조회합니다.

2.1 팀 목록 조회:

mcp__linear-server__list_teams

2.2 프로젝트/사이클/라벨 조회 (팀 선택 후):

mcp__linear-server__list_projects (team 파라미터) mcp__linear-server__list_cycles (teamId 파라미터) mcp__linear-server__list_issue_labels (team 파라미터)

2.3 사용자 목록 조회:

mcp__linear-server__list_users

Step 3: 이슈 내용 생성

3.1 제목 생성:

Format:

<gitmoji> 한글 핵심 요약 (max 50자)

3.2 Description 생성:

템플릿 참조: references/field_templates.md

버그 템플릿:

문제 상황

[현재 발생하는 문제 설명]

재현 방법

1. [단계 1]
2. [단계 2]

기대 동작

[정상 동작 설명]

영향 범위

[영향받는 기능/사용자]

기능 템플릿:

배경

[왜 필요한지]

구현 내용

• [핵심 기능 1]
• [핵심 기능 2]

성공 기준

[완료 조건]

3.3 품질 규칙:

✅ MUST follow:

• 한글 우선 (기술 용어는 영어 허용)

• 제목 50자 이내

• Description 300자 이내 권장

• 도메인 중심 언어 (기능 설명)

❌ MUST NOT include:

• AI 서명 (- Claude , Generated by AI , Co-Authored-By: Claude )

• 코드 참조 (클래스명, 메서드명, 변수명, 파일명)

• 추적 코드 (TASK-123, SC-003)

좋은/나쁜 예시: references/issue_examples.md

Step 4: 사용자 확인 (⚠️ 필수)

CRITICAL RULE - NEVER SKIP THIS STEP

반드시 AskUserQuestion 도구를 사용하여 사용자 승인을 받아야 합니다.

4.1 미리보기 표시:

📋 생성할 이슈:

제목: <gitmoji> <한글 제목>

내용: <description>

필드 설정:

4.2 옵션 제공:

• ✅ 이대로 생성

• ✏️ 제목/내용 수정

• 🔧 필드 변경

• ❌ 취소

4.3 사용자 선택 처리:

• Choice 1: Step 5 진행

• Choice 2: 수정 내용 입력받고 Step 4 다시

• Choice 3: 필드 변경 옵션 표시 후 Step 4 다시

• Choice 4: 워크플로우 종료

Step 5: 이슈 생성 실행

5.1 이슈 생성:

mcp__linear-server__create_issue

필수 파라미터:

• title: 생성된 제목

• team: 선택된 팀

• description: 생성된 내용

선택 파라미터 (사용자 지정 시):

• assignee, priority, estimate, labels, project, cycle, milestone

Step 6: 결과 보고

성공:

✅ 이슈 생성 완료

📋 이슈 ID: [identifier] 🔗 URL: [issue URL] 👤 담당자: [assignee] 📊 우선순위: [priority]

실패:

❌ 이슈 생성 실패

원인: [error message] 확인 사항:

• 팀 접근 권한
• 필수 필드 누락
• Linear 연결 상태

Workflow B: 이슈 수정

Step 1: 이슈 확인

1.1 이슈 ID 확인:

• 사용자가 제공한 ID 사용

• 또는 최근 이슈 목록에서 선택

1.2 현재 상태 조회:

mcp__linear-server__get_issue (id, includeRelations: true)

Step 2: 변경 사항 분석

사용자 요청에서 변경할 필드를 파악합니다.

변경 가능 필드:

• title: 제목

• description: 내용

• state: 상태 (Backlog, Todo, In Progress, Done, Canceled)

• assignee: 담당자

• priority: 우선순위 (0-4)

• estimate: 예상 소요

• labels: 라벨

• project: 프로젝트

• cycle: 사이클

Step 3: 변경 미리보기 (⚠️ 필수)

CRITICAL RULE - NEVER SKIP THIS STEP

3.1 변경사항 표시:

📝 이슈 수정 미리보기

이슈: [identifier] - [현재 제목]

변경 내용:

3.2 옵션 제공:

• ✅ 변경 적용

• ✏️ 다른 필드도 수정

• ❌ 취소

Step 4: 이슈 수정 실행

mcp__linear-server__update_issue

Step 5: 상태 변경 시 코멘트 제안 (✨ 신규 기능)

상태가 변경된 경우, 관련 코멘트 작성을 제안합니다.

In Progress 변경 시:

💡 작업 시작 코멘트를 추가할까요?

제안 내용:

🚀 작업 시작

• 시작 일시: [현재 날짜/시간]
• 예상 완료: [estimate 기반 또는 미정]
• 접근 방식: [간단한 계획]

선택:

1. ✅ 코멘트 추가
2. ✏️ 내용 수정 후 추가
3. ⏭️ 건너뛰기

Done 변경 시:

💡 완료 보고 코멘트를 추가할까요?

제안 내용:

✅ 작업 완료

• 완료 일시: [현재 날짜/시간]
• 구현 내용: [변경 요약]
• 테스트: [검증 방법]

선택:

1. ✅ 코멘트 추가
2. ✏️ 내용 수정 후 추가
3. ⏭️ 건너뛰기

Step 6: 결과 보고

✅ 이슈 수정 완료

📋 이슈: [identifier] 🔗 URL: [issue URL] 📝 변경된 필드: [changed fields]

Workflow C: 코멘트 추가 (작업 히스토리)

Step 1: 이슈 확인

mcp__linear-server__get_issue (id) mcp__linear-server__list_comments (issueId)

Step 2: 코멘트 내용 생성

2.1 기본 구조:

[이모지] [작업 유형]

날짜: [YYYY-MM-DD]

진행 상황

• [완료한 작업 1]
• [완료한 작업 2]

다음 단계

• [예정 작업]

차단 요소 (있는 경우)

• [블로커 설명]

2.2 작업 유형별 이모지:

• 🚀 작업 시작

• 📝 진행 상황 업데이트

• ✅ 작업 완료

• 🔍 조사/분석 완료

• ⚠️ 블로커 발생

• 💡 해결책 발견

Step 3: 사용자 확인

3.1 미리보기:

💬 추가할 코멘트:

이슈: [identifier] - [title]

[코멘트 내용]

선택:

1. ✅ 이대로 추가
2. ✏️ 내용 수정
3. ❌ 취소

Step 4: 코멘트 생성 실행

mcp__linear-server__create_comment (issueId, body)

Step 5: 결과 보고

✅ 코멘트 추가 완료

📋 이슈: [identifier] 💬 코멘트 ID: [comment id] 📅 작성 시간: [timestamp]

Edge Cases

팀/프로젝트 선택

• 팀이 여러 개인 경우 → 선택 옵션 제공

• 프로젝트 미지정 요청 → 프로젝트 없이 생성

이슈 ID 확인

• ID 형식 오류 → 올바른 형식 안내 (예: ABC-123)

• 이슈 없음 → 검색 또는 목록 제공

권한 오류

• 팀 접근 권한 없음 → 관리자 연락 안내

• 수정 권한 없음 → 담당자/생성자 확인 안내

네트워크 오류

• Linear API 연결 실패 → 재시도 또는 나중에 시도 안내

Checklist

이슈 생성 전:

• 사용자가 명시적으로 이슈 생성 요청

• 이슈 유형 파악 완료

• 적절한 Gitmoji 선택

• 한글 제목 (50자 이내)

• 도메인 중심 언어 사용 (코드 참조 없음)

• AI 서명 없음

• 사용자 승인 완료

이슈 수정 전:

• 이슈 ID 확인

• 현재 상태 조회 완료

• 변경 내용 미리보기 표시

• 사용자 승인 완료

코멘트 추가 전:

• 이슈 ID 확인

• 코멘트 내용 미리보기 표시

• 사용자 승인 완료

References

상세 참조 자료:

• references/gitmoji_mapping.md

• 이슈 타입별 Gitmoji 매핑 및 선택 가이드

• references/field_templates.md

• 필드 템플릿, 우선순위, 예상 소요 기준

• references/issue_examples.md

• 좋은/나쁜 이슈 예시 및 변환 사례

Integration with MY_RULES.md

이 스킬은 MY_RULES.md 규칙을 준수합니다:

✅ Enforced:

• 한글 우선 사용 (제목, 내용, 코멘트)

• AI 서명 절대 금지

• 사용자 승인 필수 (생성/수정 전)

• 도메인 중심 언어 (코드 참조 금지)

✅ Triggers:

• "이슈 생성", "이슈 수정", "코멘트 추가"

• "create issue", "update issue", "add comment"

✅ Quality:

• Gitmoji + 한글 제목 자동 생성

• 50자 제목 제한 준수

• 300자 내용 권장

• 사용자 승인 워크플로우