link-project

/tnh-tools:link-project — 현재 디렉토리에 Jira 프로젝트 키 연결

여러 Jira 프로젝트를 오가며 작업할 때, 매번 프로젝트 키를 입력하지 않도록 현재 작업 디렉토리에 Jira 프로젝트 키를 박아둡니다.

Arguments: $ARGUMENTS

---

동작 원리

jira-mcp 서버는 시작 시 다음 순서로 프로젝트 키를 찾습니다:

1. 환경변수 JIRA_PROJECT_KEY
2. <cwd>/.claude/settings.json 의 jira.projectKey
3. <cwd>/.jira-mcp.json 의 projectKey
4. 글로벌 ~/.config/tnh-tools/jira.json 의 JIRA_PROJECT_KEY (fallback)

이 skill은 3번 경로(.jira-mcp.json)에 키를 기록합니다. 디렉토리 단위로 명확히 분리되며, 팀 공유가 필요하면 git에 커밋하고 개인용이면 .gitignore에 추가하면 됩니다.

---

동작 흐름

1단계: 현재 cwd 확인

pwd 로 현재 작업 디렉토리를 확인하고 사용자에게 보여줍니다.

현재 디렉토리: /Users/.../my-service
이 디렉토리에 Jira 프로젝트 키를 연결합니다.

$ARGUMENTS 에 디렉토리 경로가 있으면 그 경로를 기준으로 합니다.

2단계: 기존 설정 확인

다음 파일들을 Read로 확인:

• <cwd>/.jira-mcp.json
• <cwd>/.claude/settings.json (있는 경우 jira.projectKey 필드만 확인)

이미 키가 설정되어 있으면:

현재 이 디렉토리의 Jira 프로젝트 키: ST (출처: .jira-mcp.json)
새 키로 변경할까요? 아니면 그대로 둘까요?

3단계: 프로젝트 키 입력 받기

이 디렉토리에서 사용할 Jira 프로젝트 키를 입력해주세요.
(이슈 키의 앞부분. 예: ST-1234 → ST)

$ARGUMENTS 에 키가 같이 넘어왔다면 (/tnh-tools:link-project ABC 형태) 그 값을 사용하고, 사용자에게 한 번 확인만 받습니다.

키 형식 검증: 영문 대문자/숫자만 허용 (/^[A-Z][A-Z0-9_]*$/). 위반 시 다시 묻습니다.

4단계: .jira-mcp.json 작성

Write 툴로 <cwd>/.jira-mcp.json 생성/덮어쓰기:

{
  "projectKey": "입력값"
}

기존 파일에 다른 필드가 있었다면 보존하고 projectKey 만 갱신합니다.

5단계: gitignore 안내

<cwd>/.gitignore 가 있는지 확인 후 사용자에게 물어봅니다:

.jira-mcp.json 을 어떻게 처리할까요?

  [A] 팀과 공유 (git에 커밋) — 모든 팀원이 같은 프로젝트 키 사용
  [B] 개인 설정 (.gitignore 에 추가) — 본인만 사용

선택해주세요. (A/B, 기본값 A)

• A 선택: 안내만 하고 종료. git add .jira-mcp.json && git commit 하라고 알려줍니다.
• B 선택: .gitignore 에 .jira-mcp.json 한 줄 추가. 파일이 없으면 생성.

6단계: 확인 메시지

✅ Jira 프로젝트 키 연결 완료

  디렉토리: /Users/.../my-service
  프로젝트 키: ST
  설정 파일: .jira-mcp.json (팀 공유 / 개인 설정)

이 디렉토리에서 Claude Code를 새로 시작하면 jira-mcp가 자동으로 ST 프로젝트를 사용합니다.
이미 Claude Code가 켜져 있다면 재시작이 필요합니다 (MCP 서버는 시작 시 한 번만 키를 로드합니다).

---

주의사항

• 이 skill은 자격증명을 다루지 않습니다. 자격증명은 글로벌 ~/.config/tnh-tools/jira.json 에 있고 /tnh-tools:setup 으로 관리합니다.
• 환경변수 JIRA_PROJECT_KEY 가 설정되어 있으면 .jira-mcp.json 보다 우선합니다. 환경변수가 설정되어 있다면 사용자에게 알립니다.
• MCP 서버는 Claude Code 세션 시작 시 한 번만 cwd 기준으로 설정을 읽습니다. 같은 세션 내에서 디렉토리를 옮겨도 키가 자동 갱신되지는 않습니다 — 새 세션을 여세요.