/zenhub:manage — ZenHub 이슈·PR 상태 정리 도우미#

한마디로#

작업 진행 상황에 맞춰 ZenHub 보드의 카드(이슈)를 알맞은 칸으로 옮기고, 코드 변경(PR)과 이슈를 서로 연결해 주는 도구입니다. 칸반 보드에서 포스트잇을 "진행 중 → 검토 중 → 완료"로 옮겨 붙이는 일을 대신 해 준다고 보면 됩니다.

누가·언제 쓰나요#

• PR(코드 변경 묶음)을 만든 뒤, 그 PR을 관련 이슈와 연결해야 할 때
• 작업 단계가 바뀌어서 보드의 이슈 위치(파이프라인)를 옮겨야 할 때
• 작업을 시작했을 때, 리뷰를 요청할 때, 병합(merge)이 끝났을 때

무엇을 해주나요#

• PR과 이슈를 연결해 줍니다 (GitHub의 Closes #이슈번호 키워드 활용)
• 이슈를 적절한 보드 칸으로 이동시켜 줍니다 — 예: In Progress, Review/QA
• 이슈와 PR의 현재 상태를 확인해 줍니다
• 병합 후에는 이슈가 자동으로 닫혔는지 확인하고, 안 닫혔으면 대신 닫아 줍니다
• 보드의 칸 목록은 프로젝트마다 다르므로, 처음 실행할 때 자동으로 조회합니다 (대표 칸: New Issues, Icebox, Product Backlog, Sprint Backlog, In Progress, Review/QA — Done/Closed 칸은 없음, 닫힘은 GitHub state)

어떻게 쓰나요#

# PR을 이슈에 연결
/zenhub:manage link-pr --pr 1627 --issue 1413

# 이슈를 특정 보드 칸으로 이동
/zenhub:manage move --issue 1413 --to  " Review/QA " 

 # 이슈·PR 상태 확인
/zenhub:manage status --issue 1413

• link-pr — PR과 이슈를 연결합니다
• move --to "칸 이름" — 이슈를 해당 보드 칸으로 옮깁니다 (예: "In Progress", "Review/QA")
• status — 이슈나 PR의 현재 상태를 보여 줍니다

안에서 무슨 일이 벌어지나요#

작업 흐름에 맞춰 보통 다음 순서로 진행됩니다.

1. 작업 시작 — 이슈를 In Progress 칸으로 옮깁니다.
2. PR 생성 후 — PR 본문에 Closes #이슈번호를 넣어 GitHub가 자동 연결하게 하고, 이슈를 Review/QA 칸으로 옮깁니다.
3. 병합 후 — Closes # 키워드 덕분에 GitHub 이슈가 자동으로 닫히고 ZenHub도 Closed로 동기화됩니다. (Done 칸으로는 옮기지 않습니다 — Done은 "닫힘"과 다릅니다.) 자동으로 닫히지 않았으면 직접 닫아 마무리합니다.

참고: ZenHub에서는 PR을 이슈의 하위 항목으로 둘 수 없습니다. 그래서 GitHub의 Closes # 키워드로 연결하고, 상태 관리는 보드 칸 이동으로 합니다. 그리고 Epic > Story > Sub-task 계층 구조를 유지합니다.

/zenhub:manage {action} [--options]

const workspace = await mcp__zenhub__getWorkspacePipelinesAndRepositories();
// workspace.pipelines → [{ id, name }, ...]
// Live pipelines (6): New Issues, Icebox, Product Backlog, Sprint Backlog, In Progress, Review/QA
// (no  " Done " / " Closed "   column — close via gh issue close + updateIssue state:CLOSED)

# Move issue to In Progress
/zenhub:manage move --issue {issue_number} --to  " In Progress "

# Include  " Closes #{issue_number} "   in PR body (GitHub auto-link)
# Move issue to Review/QA
/zenhub:manage move --issue {issue_number} --to  " Review/QA "

# Issue auto-closes via  " Closes # "   keyword in PR body → ZenHub syncs to Closed.
# Never move to Done (Done ≠ closed). Verify + fallback:
#   gh issue view {n} --json state  → if not CLOSED: gh issue close {n} --reason completed
#   searchClosedIssues  " #{n} "         → if missing:    updateIssue state:CLOSED

## Related Issue
- Closes #1413
- Fixes #1413
- Resolves #1413

mcp__zenhub__searchLatestIssues({ query:  " 1413 "   })

// Query workspace info (on first call)
const workspace = await mcp__zenhub__getWorkspacePipelinesAndRepositories();
const reviewPipeline = workspace.pipelines.find(p = >   p.name ===  " Review/QA " );
// fail-closed: 못 찾으면 throw (이름 불일치 시 undefined.id 무음 누락 방지)
if (!reviewPipeline) throw new Error(` ' Review/QA '   파이프라인 없음. 라이브: ${workspace.pipelines.map(p = >   p.name).join( " ,  " )}`);

mcp__zenhub__moveIssueToPipeline({
  issueId:  " {issue_graphql_id} " ,
  pipelineId: reviewPipeline.id
})

// Repository ID + Pipeline ID
const workspace = await mcp__zenhub__getWorkspacePipelinesAndRepositories();

// Issue Type ID
const issueTypes = await mcp__zenhub__getIssueTypes();