GitHub 워크플로우
요청된 작업을 선택하고 해당 작업 참조를 따르세요. 각 작업은 이전 ghflow 작업이 없는 일반 이슈나 PR에 대해 동작합니다. 지금 필요한 작업과 공유 규칙만 로드하세요. 참조 로딩, 검색, 인계에는 작업 컨텍스트 및 도구 출력을 적용하세요.
작업 실행 방법을 선택하기 전에 실행 모드를 적용하세요. 로컬 모델 작업은 하위 에이전트 없이 현재 세션 내에서 유지됩니다. 이 모드는 작업자 파견이나 새 리뷰 세션 시작 지침보다 우선합니다.
소스 및 도구 찾기
이 SKILL.md 경로를 심볼릭 링크를 통해 확인하세요. 상위 디렉토리는 GHFLOW_SKILL_DIR입니다. 참조 및 하위 에이전트 인계를 위해 해당 디렉토리 아래의 절대 경로를 사용하세요. 명령 예제를 실행하기 전에 GHFLOW_CLI를 그 아래 cli/ghflow.py의 절대 경로로 설정하세요. 경로를 따옴표로 감싸세요. 명령 도구는 호출할 때마다 새 셸을 시작할 수 있으므로, 변수를 사용하는 각 명령에서 내보내거나 전체 경로를 작성하세요:
export GHFLOW_CLI="ABSOLUTE_SKILL_DIRECTORY/cli/ghflow.py"
python3 "$GHFLOW_CLI" --help
ABSOLUTE_SKILL_DIRECTORY를 확인된 디렉토리로 바꾸세요. 확인된 스킬 디렉토리가 소스 체크아웃 루트입니다. 해당 cli/ghflow.py를 직접 사용하세요. Git, GitHub, ID 설정이 해당 프로젝트를 사용하도록 대상 프로젝트에 현재 디렉토리를 유지하세요. 각 참조의 링크를 통해 작성 지침을 확인하되, 현재 디렉토리를 통하지 마세요. 소스 읽기에 외부 디렉토리 권한이 필요한 경우, 확인된 체크아웃 경로를 보고하고 소스 접근 권한의 설정 지침을 사용하세요. 에이전트 권한을 조용히 변경하지 마세요.
선택한 작업 참조는 필요한 공유 규칙을 명명합니다. 조건이 적용될 때 공유 참조를 열고, 결정을 소유한 섹션을 읽으세요. 첫 번째 작업 전에 모든 공유 참조를 읽지 마세요. 조건: 권한 부여는 권한 또는 범위 질문이 발생할 때; 증거는 결과를 보고하거나 식별자를 전달하기 전에; 결정은 사실이나 선택이 누락되었을 때; 에이전트 ID는 에이전트가 Git 또는 GitHub 명령을 실행하기 전에; GitHub 쓰기는 GitHub 레코드를 변경하기 전에. CLI 읽기는 쓰기 권한을 부여하지 않습니다.
요청된 작업 선택
사용자의 명시적 요청을 아래 작업과 일치시키세요. 사용자 요청 또는 대상 체크아웃에서 주제 저장소를 식별하세요. python3 "$GHFLOW_CLI" facts는 체크아웃, 저장소, 도구, ID 준비 상태 및 프로젝트 팩트 파일을 보고합니다. --issue ISSUE_URL을 추가하면 이슈의 브랜치, 작업 트리, PR 및 보드 항목도 추가합니다. 해당 상태에 대해 별도의 git 및 gh 읽기 대신 사용하고, .ghflow/project.md가 보고되면 읽으세요. 로컬 모델 세션 시작의 경우 preamble ISSUE_URL은 이러한 팩트를 첫 번째 프롬프트에 맞는 컴팩트 블록으로 출력합니다. 소스 체크아웃은 지침과 도구를 제공하며, 원격 저장소와 구성된 계정은 주제를 식별하지 않습니다. 선택한 저장소, 이슈 또는 PR이 누락된 경우, GitHub 검색 또는 파견 전에 필요한 입력을 반환하세요. 평가 전용 요청의 경우, 전달을 수행하지 않고 작업과 제한 사항을 설명하세요. 중요한 엔드포인트가 불명확한 경우, 해당 결정에 대해서만 질문하세요. 백로그 작업을 선택하거나 고정된 시퀀스를 추가하지 마세요. 전달 요청은 기본적으로 PR을 열린 상태로 두고 리뷰 후속 작업을 따릅니다. 해당 코디네이터 참조를 읽고 선택한 실행 모드를 적용하여 파견 및 리뷰 요구 사항을 처리하세요.
| 요청 | 작업 참조 |
|---|---|
| 기존 이슈 재평가 | reconsider-issue |
| 아이디어 또는 이슈 정의 (초안 전용 작업 포함) | define-issue |
| 사용자와 이슈 결정 사항 해결 | interview-issue |
| 광범위한 상위 이슈를 하위 이슈로 분할 | decompose-parent-issue |
| 검토된 이슈 초안 게시 | file-issue |
| 로컬 커밋을 통해 이슈 구현 | implement-issue |
| 코드 변경 사항 독립적으로 검토 | review-changes |
| 커밋된 변경 사항을 PR로 게시 | submit-pr |
| PR 피드백 대응 및 CI 복구 | address-pr-review |
| 명시적으로 승인된 PR 병합 | merge-pr |
| 선택된 하나의 이슈 전달 또는 해결 | express-issue |
| 합의된 상위 이슈 전달 | deliver-parent-issue |
| 관련 이슈를 테마별로 그룹화 | bundle-issues |
| 요청된 공개 이슈 세트 평가 | triage-issues |
| 입력이 필요한 이슈 해결 | sweep-needs-input |
| 승인된 이슈 정의 | sweep-needs-definition |
| 차단 해제된 이슈를 정의로 되돌리기 | sweep-blocked |
| 종료된 이슈 감사 | sweep-audit-closed |
| 요청된 보드 범위 우선순위 지정 | sweep-prioritize |
| 이슈를 Ready 큐로 분류 | curate-ready-queue |
| 명시적으로 요청된 Ready 큐 전달 | burndown-ready-queue |
| 프로젝트 팩트 파일 작성 또는 갱신 | prepare-project-facts |
실행 및 인계
지속적인 작업 또는 재구성 비용이 많이 드는 발견 사항에 대해 작업 노트를 적용하세요. 재개 또는 컨텍스트 압축 후, 연구를 반복하거나 결정을 재개하기 전에 기존 작업 노트를 읽으세요.
선택한 참조의 범위와 중단 지점을 따르세요. 포함된 작업 전반에 걸쳐 기존 권한을 유지하세요. 초안 전용 및 읽기 전용 제한은 여전히 적용되며, 구현 또는 제출은 병합 권한을 의미하지 않습니다.
위임 모드에서는 조정을 적용하세요. 하위 에이전트에 선택된 작업과 필요한 입력을 제공하세요. 위임 또는 필요한 리뷰어 모델을 사용할 수 없는 경우, 공유 규칙을 따르고 한계를 보고하세요.
작업의 실제 결과, 소스, 검사 및 남은 결정을 반환하세요. 누락된 기능과 불완전한 증거를 명시적으로 보고하세요.