Communitygithub.com

배포 후 검증 스킬

전역 연결된 패키지, 실행 중인 서비스 및 데몬에 대한 코드 변경 후 배포 상태를 검증하는 에이전트 스킬입니다.

배포 후 검증 스킬란 무엇인가요?

이 스킬은 코드 변경 후 전역 연결된 패키지, 실행 중인 서비스 및 데몬의 배포가 올바르게 적용되었는지 검증하는 절차를 제공합니다. 개발자가 직접 수동으로 확인해야 했던 배포 후 검증 과정을 자동화하여, 변경 사항이 실제로 실행 환경에 반영되었음을 보장합니다. 주로 Node.js 생태계의 npm 전역 링크 패키지, PM2/systemd/Windows 서비스, cron/Windows 작업 스케줄러와 같은 스케줄링 작업을 지원합니다. 에이전트는 변경된 리포지토리가 전역 링크된 패키지인지 감지하고, 빌드 후 CLI 버전 확인 또는 서비스 재시작 후 PID, 포트, 상태, 로그 등의 결정적 증거를 수집하여 검증을 완료합니다. 최종 응답에는 이러한 검증 증거가 반드시 포함되어야 합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add metyatech/skill-post-deploy

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

변경 후 배포 절차

감지

전역 연결된 패키지

  • 에이전트는 npm ls -g --depth=0을 실행하고 ->가 로컬 경로를 가리키는 항목을 찾아야 합니다(MUST).
  • 변경된 리포지토리가 전역 연결된 패키지와 일치하면 에이전트는 재빌드를 진행해야 합니다(MUST).

실행 중인 서비스 및 예약 작업

  • 에이전트는 리포지토리와 관련된 실행 중인 프로세스(서비스 이름, PM2/systemd/Windows 서비스 항목)를 확인해야 합니다(MUST).
  • 에이전트는 리포지토리를 참조하는 예약 작업(cron, Windows 작업 스케줄러)을 확인해야 합니다(MUST).

재빌드 및 검증

npm 연결된 패키지

  1. 리포지토리의 빌드 명령을 실행합니다(예: npm run build, tsc).
  2. CLI의 --version 또는 스모크 명령을 실행하여 재빌드된 출력을 검증합니다.
  3. 검증된 버전을 보고합니다.

서비스 및 데몬

  1. 서비스 구성 요소를 재빌드합니다.
  2. 서비스 관리자를 사용하여 재시작합니다(PM2 restart, systemctl restart 등).
  3. 결정적 증거로 검증합니다:
    • 새 PID(변경 전후 비교).
    • 포트 확인(수신 중인지 확인).
    • 서비스 상태 조회.
    • 업데이트된 동작 또는 버전을 보여주는 로그 항목.
  4. 검증 증거를 보고합니다.

완료 게이트

  • 에이전트는 실행 중인 인스턴스가 변경 사항을 반영할 때까지 완료를 주장해서는 안 됩니다(MUST NOT). 에이전트는 최종 응답에 검증 증거를 포함해야 합니다(MUST).

관련 스킬