makdoong2-team 1.3.0

package/skills/_lib/load-secret.sh

@@ -0,0 +1,149 @@
+# Shared credential loader sourced by skills/*/run-*.sh.
+#
+# Contract: load_secret_from_makdoong2_config TAG VAR_NAME [HELP_HINT]
+#   TAG        short caller label used in stderr prefix
+#   VAR_NAME   .secrets.<VAR_NAME> lookup key AND exported env var name
+#   HELP_HINT  optional trailing hint printed on the missing-token path
+#
+# Exit codes (propagated to opencode's MCP-spawn error surface):
+#   65 jq missing   66 makdoong2-team.json missing
+#   67 invalid JSON 68 .secrets.<VAR_NAME> null/empty
+
+set -uo pipefail
+
+load_secret_from_makdoong2_config() {
+  local tag="${1:?load_secret: TAG missing}"
+  local var_name="${2:?load_secret: VAR_NAME missing}"
+  local help_hint="${3:-}"
+
+  local cfg_dir="${MAKDOONG2_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/opencode}"
+  local cfg_file="$cfg_dir/makdoong2-team.json"
+
+  if ! command -v jq >/dev/null 2>&1; then
+    printf '[%s] jq not found on PATH — install jq to load credentials from %s\n' \
+      "$tag" "$cfg_file" >&2
+    return 65
+  fi
+
+  if [ ! -f "$cfg_file" ]; then
+    cat >&2 <<EOF
+[$tag] makdoong2-team.json not found at $cfg_file
+
+Run 'npx makdoong2-team install' to seed it, then edit the file and set:
+
+  {
+    "secrets": {
+      "$var_name": "<your token>"
+    }
+  }
+EOF
+    return 66
+  fi
+
+  # `jq -e` fails when the file cannot be parsed; capture stderr for diagnostics.
+  local token jq_err
+  jq_err=$(mktemp 2>/dev/null || echo "/tmp/load-secret.$$.err")
+  token=$(jq -r --arg k "$var_name" '.secrets[$k] // empty' "$cfg_file" 2>"$jq_err")
+  local jq_status=$?
+  if [ "$jq_status" -ne 0 ]; then
+    printf '[%s] makdoong2-team.json is not valid JSON: %s\n' "$tag" "$cfg_file" >&2
+    if [ -s "$jq_err" ]; then sed -e "s/^/[$tag] jq: /" "$jq_err" >&2; fi
+    rm -f "$jq_err"
+    return 67
+  fi
+  rm -f "$jq_err"
+
+  if [ -z "$token" ] || [ "$token" = "null" ]; then
+    cat >&2 <<EOF
+[$tag] .secrets.$var_name is not set in $cfg_file
+
+Edit the file and add:
+
+  {
+    "secrets": {
+      "$var_name": "<your token>"
+    }
+  }
+
+Then restart opencode so the skill re-spawns.
+EOF
+    if [ -n "$help_hint" ]; then printf '[%s] %s\n' "$tag" "$help_hint" >&2; fi
+    return 68
+  fi
+
+  local existing_token
+  eval "existing_token=\${$var_name:-}"
+  
+  if [ -n "$existing_token" ] && [ "$existing_token" != "$token" ]; then
+    cat >&2 <<EOF
+[$tag] WARNING: $var_name mismatch detected
+  opencode.json (or pre-set env): ${existing_token:0:20}...
+  makdoong2-team.json (SSoT):     ${token:0:20}...
+
+makdoong2-team plugin enforces SSoT policy: using makdoong2-team.json value.
+To avoid this warning, update opencode.json or ensure both files have identical tokens.
+EOF
+    unset "$var_name"
+  fi
+
+  # shellcheck disable=SC2163
+  export "$var_name=$token"
+  return 0
+}
+
+# Contract: load_host_from_makdoong2_config TAG VAR_NAME [HELP_HINT]
+#   TAG        short caller label used in stderr prefix
+#   VAR_NAME   .hosts.<VAR_NAME> lookup key AND exported env var name
+#   HELP_HINT  optional trailing hint printed on the missing-host path
+#
+# Exit codes:
+#   65 jq missing   66 makdoong2-team.json missing
+#   67 invalid JSON 69 .hosts.<VAR_NAME> null/empty
+load_host_from_makdoong2_config() {
+  local tag="${1:?load_host: TAG missing}"
+  local var_name="${2:?load_host: VAR_NAME missing}"
+  local help_hint="${3:-}"
+
+  local cfg_dir="${MAKDOONG2_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/opencode}"
+  local cfg_file="$cfg_dir/makdoong2-team.json"
+
+  if ! command -v jq >/dev/null 2>&1; then
+    printf '[%s] jq not found on PATH — install jq to load hosts from %s\n' \
+      "$tag" "$cfg_file" >&2
+    return 65
+  fi
+
+  if [ ! -f "$cfg_file" ]; then
+    printf '[%s] makdoong2-team.json not found at %s\n' "$tag" "$cfg_file" >&2
+    return 66
+  fi
+
+  local host
+  host=$(jq -r --arg k "$var_name" '.hosts[$k] // empty' "$cfg_file" 2>/dev/null)
+  if [ $? -ne 0 ]; then
+    printf '[%s] makdoong2-team.json is not valid JSON: %s\n' "$tag" "$cfg_file" >&2
+    return 67
+  fi
+
+  if [ -z "$host" ] || [ "$host" = "null" ]; then
+    cat >&2 <<EOF
+[$tag] .hosts.$var_name is not set in $cfg_file
+
+Edit the file and add your on-prem endpoint:
+
+  {
+    "hosts": {
+      "$var_name": "<your host or base URL>"
+    }
+  }
+
+Then restart opencode so the skill re-spawns.
+EOF
+    if [ -n "$help_hint" ]; then printf '[%s] %s\n' "$tag" "$help_hint" >&2; fi
+    return 69
+  fi
+
+  # shellcheck disable=SC2163
+  export "$var_name=$host"
+  return 0
+}

package/skills/bamboo-ci/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: bamboo-ci
+description: Bamboo CI/CD 스킬. Bamboo 대상. 빌드 실행, 배포, 빌드 플랜 조회/생성, 빌드 상태 확인, 실패 로그 요약 시 사용. 검색 키는 조직의 기본 Bamboo 프로젝트로 고정이며, 플랜 생성·트리거·배포 실행 권한을 갖는다.
+mcp:
+  bamboo:
+    command: bash
+    args: ["-c", 'exec "${XDG_CONFIG_HOME:-$HOME/.config}/opencode/skills/bamboo-ci/run-bamboo.sh"']
+---
+
+# Skill: bamboo-ci
+
+> Bamboo CI/CD 작업 스킬 — 설정된 `BAMBOO_URL` (makdoong2-team.json `.hosts`)
+
+## 사전 조건 (필수)
+
+이 스킬의 `bamboo` MCP 는 lazy-load 다. `skill_mcp(mcp_name="bamboo", ...)` 를 부르기 전에 반드시 `skill(name="bamboo-ci")` 로 skill 을 이 세션에 로드해야 한다. 로드 없이 호출하면 `MCP server "bamboo" not found` 로 실패한다.
+
+## MCP
+
+- **bamboo** (Atlassian Bamboo MCP) — mcp_name 은 `bamboo` 다. `skill_mcp(mcp_name="bamboo", ...)` 로 호출한다.
+
+## 트리거 조건
+
+다음 중 하나에 해당하면 이 스킬을 사용한다:
+
+- 빌드 실행, 배포 요청
+- 빌드/배포 상태 확인
+- 파이프라인 설정, 빌드 플랜 조회
+- "테스트", "빌드", "배포", "Bamboo", "CI/CD" 언급
+
+## 워크플로우
+
+```
+1. 프로젝트 검색
+   └─ 검색 키: 조직 기본 프로젝트 (예: "Example Project") 고정
+   └─ 프로젝트 이름 기준으로 플랜 매칭 (대소문자 무시)
+
+2. 빌드 플랜 확인
+   ├─ 플랜 존재 → 3단계로
+   └─ 플랜 미존재 → 빌드 플랜 생성
+
+3. 빌드 실행 / 상태 조회
+   ├─ 실행 요청 시: 빌드 트리거
+   └─ 상태 확인 시: 최근 빌드 결과 조회
+      - 성공/실패 상태
+      - 실패 시 로그 요약
+
+4. 결과 정리
+   └─ 빌드 키, 상태, 실행 시간 포함
+   └─ 출처 URL 명시
+```
+
+## 출력 형식
+
+```
+### 빌드: {PLAN_KEY}-{BUILD_NUMBER}
+- **상태**: {SUCCESS|FAILED|BUILDING}
+- **트리거**: {manual|scheduled|code change}
+- **소요 시간**: {duration}
+- **실패 원인** (실패 시): {로그 요약}
+- **출처**: {BAMBOO_URL}/browse/{PLAN_KEY}-{BUILD_NUMBER}
+```
+
+## 권한
+
+- **읽기 + 쓰기 허용**.
+  - 빌드 플랜 생성 가능
+  - 빌드 트리거 가능
+  - 배포 실행 가능
+
+## 고정 규칙
+
+- 검색 키는 **조직의 기본 Bamboo 프로젝트**로 고정한다. 다른 프로젝트 키를 사용하지 않는다.
+- 프로젝트 이름 매칭 시 대소문자를 구분하지 않는다.
+- 빌드 플랜이 없으면 사용자 확인 없이 직접 생성한다.
+
+## 사용 예시
+
+- "Example Project 최근 빌드 실패했어?" → 최근 빌드 상태 + 실패 시 로그 요약
+- "foo 서비스 빌드 돌려줘" → 해당 플랜 트리거
+- "foo 배포 플랜 없는데 만들고 돌려줘" → 플랜 생성 후 트리거

package/skills/bamboo-ci/run-bamboo.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+set -uo pipefail
+HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+. "$HERE/../_lib/load-secret.sh"
+
+export NODE_TLS_REJECT_UNAUTHORIZED="0"
+
+load_host_from_makdoong2_config \
+  "run-bamboo" \
+  "BAMBOO_URL" \
+  "Example: https://bamboo.example.com (Bamboo base URL)."
+status=$?
+if [ "$status" -ne 0 ]; then exit "$status"; fi
+
+load_secret_from_makdoong2_config \
+  "run-bamboo" \
+  "BAMBOO_TOKEN" \
+  "See your Bamboo instance — profile → Personal Access Tokens."
+status=$?
+if [ "$status" -ne 0 ]; then exit "$status"; fi
+
+exec npx -y bamboo-mcp-server@latest

package/skills/bitbucket-research/SKILL.md

@@ -0,0 +1,87 @@
+---
+name: bitbucket-research
+description: Bitbucket DC 코드/PR 조사 스킬. Bitbucket DC 대상. 소스 코드 검색, 특정 파일/클래스/메서드 위치 파악, PR 조회 및 리뷰 상태 확인, 브랜치/커밋 이력 확인 시 사용. 읽기 전용이며 PR 생성·코드 수정·브랜치 생성은 하지 않는다.
+mcp:
+  repos:
+    command: bash
+    args: ["-c", 'exec "${XDG_CONFIG_HOME:-$HOME/.config}/opencode/skills/bitbucket-research/run-repos.sh"']
+---
+
+# Skill: bitbucket-research
+
+> Bitbucket DC 코드/PR 조사 스킬 — 설정된 `BITBUCKET_API_BASE_PATH` (makdoong2-team.json `.hosts`)
+
+## 사전 조건 (필수)
+
+이 스킬의 `repos` MCP 는 lazy-load 다. `skill_mcp(mcp_name="repos", ...)` 를 부르기 전에 반드시 `skill(name="bitbucket-research")` 로 skill 을 이 세션에 로드해야 한다. 로드 없이 호출하면 `MCP server "repos" not found` 로 실패한다.
+
+## MCP
+
+- **repos** (Bitbucket DC MCP)
+
+## 트리거 조건
+
+다음 중 하나에 해당하면 이 스킬을 사용한다:
+
+- 소스 코드 검색, 특정 클래스/메서드/설정 파일 위치 파악
+- PR(Pull Request) 조회, 리뷰 상태 확인
+- 브랜치 상태, 최근 커밋 이력 확인
+- "Bitbucket", "저장소", "PR" 언급
+
+## 워크플로우
+
+```
+1. 검색
+   └─ repos MCP로 코드/PR/저장소 검색
+   └─ 프로젝트 키 + 저장소명이 명확하면 범위 한정
+
+2. 파일 내용 조회
+   └─ 검색된 파일의 내용 조회
+   └─ 특정 라인 범위가 필요하면 해당 범위만 추출
+
+3. PR 히스토리 확인 (필요시)
+   └─ PR 목록 조회 (상태: OPEN / MERGED / DECLINED)
+   └─ PR 상세: 리뷰어, 승인 상태, diff 요약
+   └─ 관련 커밋 메시지 수집
+
+4. 브랜치 상태 (필요시)
+   └─ 브랜치 목록 조회
+   └─ 특정 브랜치의 최신 커밋 확인
+
+5. 결과 정리
+   └─ 파일 경로, 저장소, 프로젝트 키 명시
+   └─ 출처 URL 포함
+```
+
+## 출력 형식
+
+### 코드 검색 결과
+
+```
+### {프로젝트}/{저장소} — `{파일 경로}`
+- **브랜치**: {branch}
+- **내용**: (관련 코드 발췌)
+- **출처**: https://{BITBUCKET_HOST}/projects/{PROJECT}/repos/{REPO}/browse/{PATH}
+```
+
+### PR 조회 결과
+
+```
+### PR #{id}: {제목}
+- **상태**: {OPEN|MERGED|DECLINED}
+- **작성자**: {author}
+- **리뷰어**: {reviewers + 승인 상태}
+- **변경 파일**: {파일 수} files
+- **출처**: https://{BITBUCKET_HOST}/projects/{PROJECT}/repos/{REPO}/pull-requests/{ID}
+```
+
+## 제약
+
+- **읽기 전용**. PR 생성, 코드 수정, 브랜치 생성 불가.
+- 대용량 파일(바이너리, 1000줄 초과)은 관련 부분만 발췌.
+
+## 사용 예시
+
+- "XYZ 클래스 정의된 곳 찾아줘" → 코드 검색 후 파일 경로/범위 반환
+- "PROJECT/repo의 오픈 PR 리스트" → 상태 필터 PR 목록 조회
+- "PR #123 리뷰 상태" → PR 상세 + 승인 현황 요약

package/skills/bitbucket-research/run-repos.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+set -uo pipefail
+HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+. "$HERE/../_lib/load-secret.sh"
+
+export NODE_TLS_REJECT_UNAUTHORIZED="0"
+
+load_host_from_makdoong2_config \
+  "run-repos" \
+  "BITBUCKET_API_BASE_PATH" \
+  "Example: https://bitbucket.example.com/rest (Bitbucket DC REST base URL)."
+status=$?
+if [ "$status" -ne 0 ]; then exit "$status"; fi
+
+load_secret_from_makdoong2_config \
+  "run-repos" \
+  "BITBUCKET_API_TOKEN" \
+  "See your Bitbucket DC instance — profile → Manage account → HTTP access tokens."
+status=$?
+if [ "$status" -ne 0 ]; then exit "$status"; fi
+
+exec npx -y @atlassian-dc-mcp/bitbucket

package/skills/confluence-research/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: confluence-research
+description: 사내 Confluence 문서 조사 스킬. Confluence DC 대상. 위키, 설계문서, 운영 가이드, 회의록, 온보딩 문서 조회 시 사용. docs MCP 우선, 접근 실패 시 chrome-devtools-mcp로 브라우저 fallback. 읽기 전용이며 문서 생성·수정·코멘트는 하지 않는다.
+mcp:
+  docs:
+    command: bash
+    args: ["-c", 'exec "${XDG_CONFIG_HOME:-$HOME/.config}/opencode/skills/confluence-research/run-docs.sh"']
+---
+
+# Skill: confluence-research
+
+> 사내 Confluence 문서 조사 스킬 — 설정된 `CONFLUENCE_HOST` (makdoong2-team.json `.hosts`)
+
+## 사전 조건 (필수)
+
+이 스킬의 `docs` MCP 는 lazy-load 다. `skill_mcp(mcp_name="docs", ...)` 를 부르기 전에 반드시 `skill(name="confluence-research")` 로 skill 을 이 세션에 로드해야 한다. 로드 없이 호출하면 `MCP server "docs" not found` 로 실패한다. `chrome-devtools-mcp` fallback 은 opencode.json 의 site-wide MCP 로 등록돼 있으므로 별도 로드 불필요.
+
+## MCP
+
+- **docs** (Confluence MCP) — 1차 수단
+- **chrome-devtools-mcp** — fallback (docs MCP로 접근 불가 시)
+
+## 트리거 조건
+
+다음 중 하나에 해당하면 이 스킬을 사용한다:
+
+- "사내 문서", "위키", "Confluence" 언급
+- 설계 문서, 운영 가이드, 회의록, 온보딩 문서 등 조회 요청
+- 특정 프로젝트/시스템의 내부 문서화 상태 확인
+
+## 워크플로우
+
+```
+1. docs MCP 검색
+   └─ 키워드 기반 문서 검색
+   └─ 스페이스 키가 명확하면 스페이스 한정 검색
+
+2. 페이지 내용 조회
+   └─ 검색 결과에서 관련 페이지 본문 조회
+   └─ 첨부 파일 목록 확인 (필요시)
+
+3. fallback: chrome-devtools-mcp
+   └─ docs MCP로 내용 조회 실패 시
+   └─ 브라우저로 Confluence 호스트 직접 탐색
+   └─ 페이지 렌더링 후 내용 추출
+
+4. 결과 정리
+   └─ 문서 제목 + 스페이스 + 최종 수정일 포함
+   └─ 핵심 내용 구조화 요약
+   └─ 출처 URL 명시
+```
+
+## 출력 형식
+
+```
+### {문서 제목}
+- **스페이스**: {space key / space name}
+- **최종 수정**: {날짜} by {작성자}
+- **요약**: {핵심 내용, 5줄 이내}
+- **출처**: https://{CONFLUENCE_HOST}/pages/viewpage.action?pageId={pageId}
+```
+
+복수 문서인 경우 관련도 순으로 나열한다.
+
+## 제약
+
+- **읽기 전용**. 문서 생성, 수정, 코멘트 작성 불가.
+- 브라우저 사용 시 동기적 세션만 허용.
+- 문서 본문이 과도하게 길 경우 핵심 섹션만 발췌 요약.
+
+## 사용 예시
+
+- "FOO 프로젝트 설계문서 찾아줘" → docs MCP 검색 후 페이지 본문 요약
+- "지난주 팀 회의록" → 키워드 + 기간 범위 검색
+- "운영 가이드: 배포 롤백 절차" → 스페이스 한정 검색 후 본문 발췌

package/skills/confluence-research/run-docs.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+set -uo pipefail
+HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+. "$HERE/../_lib/load-secret.sh"
+
+export NODE_TLS_REJECT_UNAUTHORIZED="0"
+
+load_host_from_makdoong2_config \
+  "run-docs" \
+  "CONFLUENCE_HOST" \
+  "Example: confluence.example.com (Confluence DC host, no scheme)."
+status=$?
+if [ "$status" -ne 0 ]; then exit "$status"; fi
+
+load_secret_from_makdoong2_config \
+  "run-docs" \
+  "CONFLUENCE_API_TOKEN" \
+  "See your Confluence DC instance — profile → Personal Access Tokens."
+status=$?
+if [ "$status" -ne 0 ]; then exit "$status"; fi
+
+exec npx -y @atlassian-dc-mcp/confluence

package/skills/github-oss-research/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: github-oss-research
+description: GitHub 오픈소스 참조 스킬. 공개 라이브러리/프레임워크의 소스 코드, README, 이슈, 릴리즈 노트 조회 시 사용. 단일 파일은 raw.githubusercontent.com WebFetch 우선, 페이지 탐색은 chrome-devtools-mcp 사용. 읽기 전용이며 public 저장소만 접근한다.
+---
+
+# Skill: github-oss-research
+
+> GitHub 오픈소스 참조 스킬 — `github.com`
+
+## MCP
+
+- **chrome-devtools-mcp** — 브라우저 탐색
+- WebFetch — raw 콘텐츠 직접 조회
+
+## 트리거 조건
+
+다음 중 하나에 해당하면 이 스킬을 사용한다:
+
+- 오픈소스 라이브러리/프레임워크의 소스 코드 참조
+- GitHub 저장소의 README, 이슈, 릴리즈 노트 확인
+- 특정 오픈소스 설정 예제, 구현 패턴 조회
+- "GitHub", 특정 저장소 URL, 오픈소스 프로젝트명 언급
+
+## 워크플로우
+
+```
+1. 접근 방식 결정
+   ├─ raw 콘텐츠(단일 파일) → WebFetch 우선
+   │   └─ https://raw.githubusercontent.com/{owner}/{repo}/{branch}/{path}
+   └─ 페이지 탐색(이슈, PR, 릴리즈 등) → chrome-devtools-mcp
+
+2. 내용 조회
+   └─ 파일 내용, README, 이슈 본문, 릴리즈 노트 등 추출
+
+3. 결과 정리
+   └─ 저장소명, 파일 경로, 브랜치/태그 명시
+   └─ 출처 URL 포함
+```
+
+## 출력 형식
+
+```
+### {owner}/{repo} — `{파일 경로 또는 페이지}`
+- **브랜치/태그**: {branch or tag}
+- **내용**: {관련 내용 요약 또는 코드 발췌}
+- **출처**: {GitHub URL}
+```
+
+## 제약
+
+- **읽기 전용**.
+- 브라우저 사용 시 동기적 세션만 허용.
+- GitHub API 인증 불가 — public 저장소만 접근 가능.
+
+## 사용 예시
+
+- "openai/whisper setup.py 내용 보여줘" → raw WebFetch로 파일 직접 조회
+- "facebook/react 최신 릴리즈노트" → chrome-devtools-mcp로 releases 페이지 탐색
+- "특정 오픈소스 README" → raw WebFetch (기본 브랜치의 README.md)

package/skills/jira-research/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: jira-research
+description: Jira 이슈 조사 스킬. Jira DC 대상. 이슈 키(예 PROJ-1234) 감지, 티켓 상세 조회, 스프린트/백로그 확인, 이슈 간 관계(블로커/서브태스크/에픽) 재귀 탐색 시 사용. 읽기 전용이며 이슈 생성·수정·전환·코멘트 작성은 하지 않는다.
+mcp:
+  works:
+    command: bash
+    args: ["-c", 'exec "${XDG_CONFIG_HOME:-$HOME/.config}/opencode/skills/jira-research/run-works.sh"']
+---
+
+# Skill: jira-research
+
+> Jira 이슈 조사 스킬 — 설정된 `JIRA_HOST` (makdoong2-team.json `.hosts`)
+
+## 사전 조건 (필수)
+
+이 스킬의 `works` MCP 는 lazy-load 다. `skill_mcp(mcp_name="works", ...)` 를 부르기 전에 반드시 `skill(name="jira-research")` 로 skill 을 이 세션에 로드해야 한다. 로드 없이 호출하면 `MCP server "works" not found` 로 실패한다.
+
+## MCP
+
+- **works** (Jira MCP)
+
+## 트리거 조건
+
+다음 중 하나에 해당하면 이 스킬을 사용한다:
+
+- 사용자가 Jira 이슈 키(예: `PROJ-1234`)를 언급
+- "이슈 찾아줘", "티켓 확인", "백로그", "스프린트", "jira" 등 Jira 관련 키워드
+- 특정 기능/버그/작업의 진행 상태 질문
+- 이슈 간 관계(블로커, 서브태스크, 링크) 파악 요청
+
+## 워크플로우
+
+```
+1. 검색
+   └─ works MCP 검색 도구로 키워드/이슈 키 검색
+
+2. 상세 조회
+   └─ 검색된 이슈의 상세 정보 조회
+      - 요약(summary), 상태(status), 담당자(assignee)
+      - 설명(description), 코멘트(comments)
+      - 우선순위(priority), 라벨(labels), 컴포넌트
+
+3. 재귀 탐색 (필요시)
+   └─ 링크된 이슈, 서브태스크, 에픽 관계를 따라 탐색
+   └─ 탐색 깊이: 최대 3단계
+   └─ 순환 참조 방지: 이미 조회한 이슈 키는 스킵
+
+4. 결과 정리
+   └─ 이슈 키 + 제목 + 상태 + 담당자 형태로 요약
+   └─ 출처 URL: https://{JIRA_HOST}/browse/{ISSUE_KEY}
+```
+
+## 출력 형식
+
+```
+### {ISSUE_KEY}: {요약}
+- **상태**: {status}
+- **담당자**: {assignee}
+- **설명**: {description 요약, 3줄 이내}
+- **주요 코멘트**: {최신 또는 핵심 코멘트 요약}
+- **링크된 이슈**: {관련 이슈 목록}
+- **출처**: https://{JIRA_HOST}/browse/{ISSUE_KEY}
+```
+
+## 제약
+
+- **읽기 전용**. 이슈 생성, 수정, 전환, 코멘트 작성 불가.
+- 재귀 탐색 시 깊이 3단계 초과 금지.
+- 민감 정보(보안 이슈 등)는 사용자에게 직접 확인 유도.
+
+## 사용 예시
+
+- "PROJ-1234 상태 어때?" → 단일 이슈 상세 조회
+- "이번 스프린트 내 담당 티켓" → 담당자 필터 + 스프린트 범위 검색
+- "PROJ-1234 블로커까지 따라가서 요약" → 링크 이슈 재귀 탐색 (깊이 2~3)

package/skills/jira-research/run-works.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+set -uo pipefail
+HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+. "$HERE/../_lib/load-secret.sh"
+
+export NODE_TLS_REJECT_UNAUTHORIZED="0"
+
+load_host_from_makdoong2_config \
+  "run-works" \
+  "JIRA_HOST" \
+  "Example: jira.example.com (Jira DC host, no scheme)."
+status=$?
+if [ "$status" -ne 0 ]; then exit "$status"; fi
+
+load_secret_from_makdoong2_config \
+  "run-works" \
+  "JIRA_API_TOKEN" \
+  "See your Jira DC instance — profile → Personal Access Tokens."
+status=$?
+if [ "$status" -ne 0 ]; then exit "$status"; fi
+
+exec npx -y @atlassian-dc-mcp/jira