AgentSkillsCN

ext-github-release-manager

通过外部插件委派执行 GitHub Release Manager 工作流

SKILL.md
--- frontmatter
name: ext-github-release-manager
description: 외부 플러그인 위임으로 github-release-manager 워크플로우 실행
type: external
user-invocable: true

ext-github-release-manager

[EXT-GITHUB-RELEASE-MANAGER 활성화]

목표

github-release-manager 플러그인에 위임하여 GitHub Release 문서를 자동 생성·수정·삭제함. 도메인 컨텍스트(Git 태그, 릴리스 이력, 커밋 로그 등)를 수집하고 적절한 실행 경로를 분기하여 외부 스킬에 위임.

Top

선행 요구사항

github-release-manager 플러그인이 설치되어 있어야 함.

  • •확인: claude plugin list
  • •설치:
    • •claude plugin marketplace add unicorn-plugins/github-release-manager
    • •claude plugin install github-release-manager@github-release-manager
  • •GitHub CLI (gh) 설치 및 인증 완료 필수
  • •Context7 MCP 서버 설치 (공식 문서 조회용)

Top

활성화 조건

사용자가 /dmap:ext-github-release-manager 호출 시 또는 "릴리스 생성", "Release 만들어줘", "릴리스 문서", "GitHub Release" 키워드 감지 시.

Top

크로스-플러그인 스킬 위임 규칙

스킬 목록 결정: github-release-manager 플러그인 명세서의 "제공 스킬" 섹션 참조.

외부 스킬FQN용도
recommend-templategithub-release-manager:recommend-template프로젝트 특성 분석 기반 Release 문서 구성 추천
create-releasegithub-release-manager:create-release커밋·PR·이슈 분석 후 Release 문서 자동 생성
edit-releasegithub-release-manager:edit-release기존 Release 문서 분석 및 수정
delete-releasegithub-release-manager:delete-releaseRelease 문서 삭제 및 태그 관리

Top

도메인 컨텍스트 수집

수집 대상 결정: github-release-manager 플러그인 명세서의 "도메인 컨텍스트 수집 가이드" 참조.

수집 대상소스용도대응 ARGS 키
프로젝트 디렉토리현재 작업 디렉토리 (cwd)모든 스킬의 필수 입력project_dir
기존 릴리스 목록gh release list --limit 10경로 분기 판단 (첫 릴리스 여부, 수정/삭제 대상 선택)—
Git 태그 목록git tag --sort=-v:refname버전 결정, base_ref 추론version, base_ref
최근 커밋 이력git log {last_tag}..HEAD --onelineRelease 본문 자동 생성 소스—
릴리스 구성 파일.github/release.yml 존재 여부Recommend→Create vs Direct Create 경로 분기—
패키지 버전package.json, pyproject.toml 등 버전 필드릴리스 버전 자동 추론version

Top

워크플로우

Phase 0: 선행 확인 (ulw 활용)

github-release-manager 플러그인 설치 여부 확인.

  1. •claude plugin list 출력에서 github-release-manager 존재 여부 확인
  2. •미설치 시 사용자에게 설치 안내 후 중단:
    • •claude plugin marketplace add unicorn-plugins/github-release-manager
    • •claude plugin install github-release-manager@github-release-manager
  3. •gh auth status로 GitHub CLI 인증 상태 확인
  4. •미인증 시 gh auth login 안내 후 중단

Phase 1: 도메인 컨텍스트 수집 (ulw 활용)

도메인 컨텍스트 수집 테이블에 따라 병렬로 수집:

  1. •project_dir ← 현재 작업 디렉토리
  2. •gh release list --limit 10 ← 기존 릴리스 목록
  3. •git tag --sort=-v:refname ← Git 태그 목록
  4. •git log {last_tag}..HEAD --oneline ← 최근 커밋 이력 (태그가 없으면 전체 이력)
  5. •.github/release.yml 존재 여부 확인
  6. •package.json 또는 pyproject.toml 등에서 버전 필드 추출

수집 결과를 사용자에게 요약 제시.

Phase 2: 경로 분기 결정

수집된 컨텍스트를 기반으로 실행 경로 결정.

경로 결정: github-release-manager 플러그인 명세서의 "경로 분기 판단 기준" 참조.

조건경로외부 스킬
기존 릴리스 0건 또는 .github/release.yml 미존재Recommend → Createrecommend-template → create-release
기존 릴리스 1건 이상 + .github/release.yml 존재Direct Createcreate-release
사용자가 특정 릴리스 수정 요청Direct Editedit-release
사용자가 특정 릴리스 삭제 요청Direct Deletedelete-release

경로 분기 결과를 사용자에게 안내하고 확인.

Phase 3: 외부 스킬 위임

결정된 경로에 따라 외부 스킬에 위임.

경로 A: Recommend → Create

Step 1 → Skill: github-release-manager:recommend-template

  • •INTENT: 프로젝트 분석 후 Release 문서 구성 추천
  • •ARGS: { "source_plugin": "dmap", "project_dir": "{Phase 1에서 수집한 project_dir}" }
  • •RETURN: Release 구성 추천안 (버전 네이밍 규칙, 섹션 구조, 작성 가이드)

Step 2 → Skill: github-release-manager:create-release

  • •INTENT: 추천 구성 기반 Release 문서 생성
  • •ARGS: { "source_plugin": "dmap", "project_dir": "{Phase 1에서 수집한 project_dir}", "version": "{Phase 1에서 추론한 버전 또는 사용자 입력}" }
  • •RETURN: Release 문서 생성 완료

경로 B: Direct Create → Skill: github-release-manager:create-release

  • •INTENT: Release 문서 직접 생성
  • •ARGS: { "source_plugin": "dmap", "project_dir": "{Phase 1에서 수집한 project_dir}", "version": "{Phase 1에서 추론한 버전 또는 사용자 입력}", "base_ref": "{Phase 1에서 추론한 이전 태그}" }
  • •RETURN: Release 문서 생성 완료

경로 C: Direct Edit → Skill: github-release-manager:edit-release

  • •INTENT: 기존 Release 문서 수정
  • •ARGS: { "source_plugin": "dmap", "project_dir": "{Phase 1에서 수집한 project_dir}", "version": "{사용자가 지정한 수정 대상 버전}", "changes": "{사용자가 요청한 수정 내용}" }
  • •RETURN: Release 문서 수정 완료

경로 D: Direct Delete → Skill: github-release-manager:delete-release

  • •INTENT: Release 문서 삭제
  • •ARGS: { "source_plugin": "dmap", "project_dir": "{Phase 1에서 수집한 project_dir}", "version": "{사용자가 지정한 삭제 대상 버전}", "delete_tag": "{사용자 확인 후 결정}" }
  • •RETURN: Release 문서 삭제 완료

Phase 4: 결과 검증 및 보고 (ulw 활용)

외부 스킬 완료 후 산출물 검증:

  1. •gh release list --limit 5로 릴리스 상태 확인
  2. •생성/수정/삭제 결과를 사용자에게 요약 보고
  3. •Release URL 제공 (생성/수정 시)

Top

완료 조건

  • • 외부 플러그인 설치 확인
  • • 도메인 컨텍스트 수집 완료
  • • 경로 분기 결정 및 사용자 확인
  • • 외부 스킬 위임 및 워크플로우 완료
  • • 산출물 존재 확인 (gh release list로 검증)

Top

검증 프로토콜

산출물 검증 절차:

경로검증 방법성공 기준
Create (A, B)gh release view {version}Release 문서 존재 + 본문 비어있지 않음
Edit (C)gh release view {version}수정 내용 반영 확인
Delete (D)gh release list대상 Release 미존재 확인

Top

상태 정리

완료 시 임시 파일 없음 (상태 파일 미사용).

Top

취소

사용자가 "cancelomc" 또는 "stopomc" 요청 시 즉시 중단.

Top

재개

마지막 완료된 Phase부터 재시작 가능.

Top

MUST 규칙

#규칙
1외부 플러그인 설치 여부를 Phase 0에서 반드시 확인
2도메인 컨텍스트 수집을 완료한 후 외부 스킬에 위임
3Skill→Skill 입력 전달 규약을 준수하여 ARGS 전달
4경로 분기 결정 후 사용자에게 확인 받음
5Delete 경로 시 태그 삭제 여부를 사용자에게 반드시 확인

Top

MUST NOT 규칙

#금지 사항
1외부 플러그인의 내부 워크플로우를 직접 실행하지 않음 (Skill 도구로 위임)
2자체 Agent를 생성하지 않음 (외부 플러그인이 Agent 보유)
3외부 플러그인의 산출물(Release 문서)을 임의로 수정하지 않음
4gh CLI 명령을 직접 실행하여 Release를 생성·수정·삭제하지 않음 (외부 스킬에 위임)

Top

검증 체크리스트

  • • 선행 요구사항 섹션에 외부 플러그인 설치 확인 방법이 기술되어 있는가
  • • 크로스-플러그인 스킬 위임 규칙에 외부 스킬 FQN이 명시되어 있는가
  • • 도메인 컨텍스트 수집 대상이 테이블로 정리되어 있는가
  • • 경로 분기 조건이 명확히 정의되어 있는가
  • • Skill→Skill 입력 전달 규약이 적용되어 있는가
  • • 워크플로우의 모든 직접 수행 단계에 스킬 부스팅이 명시되어 있는가
  • • 대상 플러그인 명세서(.dmap/plugins/github-release-manager.md)가 존재하는가

Top