trigger-deploy

**GitHub Actions 기반** 프로젝트 배포 (Milestone Close → CI/CD 트리거).Use when:(1) 프로젝트 별칭 + 환경 (예: "랜드 stg 배포", "오피스 prd 배포"),(2) Milestone 기반 릴리즈 관리,(3) GitHub Actions CI/CD 배포,(4) "stg에 뭐 올라가있어?", "prd 최신 버전".⚠️ Docker/SSH 직접 배포는 deploy-service 사용.

⭐1stars🔀0forks📁View on GitHub🕐Updated Jan 4, 2026

When & Why to Use This Skill

This Claude skill automates GitHub Actions-based project deployments through intelligent Milestone management. It streamlines the CI/CD workflow by allowing users to trigger releases, monitor deployment statuses across DEV, STG, and PRD environments, and manage versioning using natural language commands and project aliases. By integrating directly with the GitHub API, it ensures a structured and traceable release process.

Use Cases

  • Automated Staging Deployment: Trigger a STG environment build by closing a specific GitHub Milestone using simple commands like 'Deploy Land to STG'.
  • Production Release Management: Execute production deployments by closing milestones and managing release tags, ensuring a formal and documented release cycle.
  • Deployment Status Monitoring: Instantly query which versions or branches are currently active on staging or production environments to maintain visibility across the team.
  • Release Readiness Audit: List all open issues, PRs, and pending items associated with a milestone to verify if a project is ready for the next deployment phase.
  • Environment Version Comparison: Check the difference between what is currently on STG versus the latest PRD release to coordinate final testing.
nametrigger-deploy
description|
(1) 프로젝트 별칭 + 환경 (예"랜드 stg 배포", "오피스 prd 배포"),
tools[Read, Bash, mcp__github__*]
modelinherit

🔔 호출 시 메시지: 이 Skill이 호출되면 반드시 [SEMO] Skill: trigger-deploy 시스템 메시지를 첫 줄에 출력하세요.

trigger-deploy Skill

GitHub Actions 기반 프로젝트 별칭 기반 배포 및 상태 조회

⚠️ deploy-service와 혼동 주의: Docker/SSH 직접 배포가 필요하면 deploy-service 사용

🔴 trigger-deploy vs deploy-service 선택 기준

조건 선택 스킬 이유
프로젝트 별칭 사용 (랜드, 오피스 등) deployer projects.md에 별칭 등록
"Milestone", "릴리즈" 언급 deployer GitHub 릴리즈 워크플로우
GitHub Actions 기반 배포 deployer CI/CD 자동 트리거
"Docker 빌드", "PM2" 언급 deploy-service SSH 직접 제어
SSH 접근 필요한 직접 배포 deploy-service 원격 서버 직접 접근
ms-* 마이크로서비스 배포 deploy-service Docker + PM2 방식

Semicolon 브랜치 전략

환경 브랜치/태그 트리거 설명
DEV dev push 개발 환경 (기본 브랜치)
STG release-x.x.x Milestone Close 마일스톤 기반 릴리즈 브랜치
PRD vx.x.x 태그 Production Tagging 릴리즈 태그

프로젝트 별칭 참조

반드시 먼저 읽을 파일: .claude/memory/projects.md

이 파일에서 프로젝트 별칭과 배포 방법을 확인합니다.

Workflow

1. 프로젝트 식별

입력: "랜드 stg 배포해줘"

1. .claude/memory/projects.md 읽기
2. "랜드" → semicolon-devteam/cm-land 매핑
3. "stg" → Milestone close 방식 확인

2. 환경별 배포 절차

DEV 배포

# dev 브랜치 상태 확인 및 push
gh api repos/{owner}/{repo}/branches/dev

STG 배포

# 1. 열린 Milestone 목록 조회
gh api repos/{owner}/{repo}/milestones --jq '.[] | select(.state=="open")'

# 2. 사용자에게 Milestone 선택 요청

# 3. Milestone Close
gh api repos/{owner}/{repo}/milestones/{number} -X PATCH -f state=closed

PRD 배포

# 1. 열린 Milestone 조회
gh api repos/{owner}/{repo}/milestones --jq '.[] | select(.state=="open")'

# 2. source-tag 라벨 확인/추가
gh api repos/{owner}/{repo}/labels --jq '.[].name' | grep source-tag

# 3. Milestone에 라벨이 연결된 이슈가 있는지 확인 후 Close
gh api repos/{owner}/{repo}/milestones/{number} -X PATCH -f state=closed

출력 포맷

[SEMO] deployer: 프로젝트 식별 완료
  - 프로젝트: cm-land (semicolon-devteam/cm-land)
  - 환경: STG
  - 방법: Milestone Close

[SEMO] deployer: Milestone 목록 조회
  1. v1.2.0 (이슈 5개, PR 3개)
  2. v1.3.0 (이슈 2개, PR 1개)

배포할 Milestone을 선택해주세요: ___

[SEMO] deployer: Milestone 'v1.2.0' Close 완료
  → STG 배포가 자동으로 트리거됩니다.
  → GitHub Actions: https://github.com/semicolon-devteam/cm-land/actions

상태 조회 Workflow

STG 현재 배포 버전 확인

# 최근 close된 Milestone 조회 (= STG에 배포된 버전)
gh api repos/{owner}/{repo}/milestones?state=closed --jq '.[0] | "v\(.title) - \(.closed_at | split("T")[0]) 배포"'

# release- 브랜치 목록 조회
gh api repos/{owner}/{repo}/branches --jq '.[] | select(.name | startswith("release-")) | .name'

PRD 최신 버전 확인

# 최신 릴리즈 태그 조회
gh api repos/{owner}/{repo}/releases/latest --jq '"v\(.tag_name) - \(.published_at | split("T")[0]) 릴리즈"'

# 또는 태그 목록에서 조회
gh api repos/{owner}/{repo}/tags --jq '.[0].name'

STG 반영 대기 항목 조회

# Open 상태 Milestone + 연결된 이슈/PR 조회
gh api repos/{owner}/{repo}/milestones?state=open --jq '.[] | {title, open_issues, html_url}'

# 특정 Milestone의 이슈 목록
gh api "repos/{owner}/{repo}/issues?milestone={number}&state=all" --jq '.[] | "- #\(.number) \(.title) [\(.state)]"'

상태 조회 출력 포맷

[SEMO] deployer: 배포 상태 조회

📦 cm-land (semicolon-devteam/cm-land)

🟢 PRD: v1.2.2 (2025-12-10 릴리즈)
🟡 STG: release-1.2.3 (2025-12-15 배포)
🔵 DEV: dev 브랜치

📋 STG 반영 대기:
  - release-1.3.0 (Milestone Open)
    - #45 [Feature] 새 기능 추가 [open]
    - #46 [Bug] 버그 수정 [closed]

주의사항

  • PRD 배포 시 반드시 STG 검증 여부 확인
  • Milestone Close 전 연결된 이슈/PR 상태 확인
  • 배포 실패 시 GitHub Actions 로그 확인 안내

References

  • Milestones: https://github.com/{owner}/{repo}/milestones
  • Releases: https://github.com/{owner}/{repo}/releases
  • Actions: https://github.com/{owner}/{repo}/actions