project-stage-gate은(는) 무엇을 하나요?
跨项目에서 재사용 가능한 Codex 스킬: 테스트, 승인 및 Git 증거를 기반으로 단계 완료 및 대화 전환 판단
개요
이 스킬은 Codex AI 어시스턴트가 프로젝트의 각 단계(Stage) 완료 여부를 자동으로 판단하고, 완료 시 다음 단계로 전환하거나 대화를 요약하는 Stage Gate 메커니즘을 제공합니다. 테스트 통과, 승인 완료, Git 커밋과 같은 객관적인 증거를 바탕으로 단계 전환을 결정합니다.
주요 기능
- 단계 완료 판단: 현재 단계의 완료 조건(테스트 통과, 승인, Git 상태)을 검사
- 대화 전환: 단계 완료 시 자동으로 다음 단계 관련 대화로 전환
- 증거 기반 검증: Git 커밋 메시지, 테스트 결과, 승인 기록을 종합적으로 분석
- 跨项目 재사용: 여러 프로젝트에서 동일한 스킬 설정을 재사용 가능
사용 방법
# 스킬 활성화
codex skill enable stellakim5551/project-stage-gate
# 단계 게이트 확인
codex run stage-gate:check
구성
| 설정 키 | 설명 | 기본값 |
|---|---|---|
stage_gate.test_required | 단계 완료 조건에 테스트 통과가 필요한지 여부 | true |
stage_gate.approval_required | 승인 완료가 필요한지 여부 | false |
stage_gate.git_evidence | Git 증거(Git 커밋 등) 사용 여부 | true |
동작 원리
- 사용자가 단계 완료 명령을 내리거나, 조건이 충족되면 스킬이 활성화됩니다.
- 스킬은 현재 단계의 완료 조건 목록을 확인합니다.
- 각 조건을 테스트 결과, 승인 상태, Git 히스토리와 비교하여 검증합니다.
- 모든 조건이 충족되면 단계 전환을 수행하고, 그렇지 않으면 누락된 항목을 사용자에게 알립니다.
예시
- 개발 단계 완료: 모든 유닛 테스트가 통과되고, 코드 리뷰 승인이 완료되면 다음 단계(리뷰/배포)로 전환
- 문제 해결 단계 완료: Git 커밋에 'fix' 또는 'resolve'가 포함되고, 관련 이슈가 닫히면 완료 판단
참고 사항
- 이 스킬은 Codex의
skill명령어와 함께 사용하도록 설계되었습니다. - Git 저장소가 연결되어 있어야 Git 증거 확인 기능이 정상 동작합니다.
- 스킬 설정은 프로젝트별로
.codex/skills.json파일에서 재정의할 수 있습니다.