메뉴
Create structured PR. Default: create new PR. Args: update (existing PR body). Trigger: 'PR 만들어줘', 'PR 생성', 'PR 올려', 'create PR', 'PR 업데이트', 'Human Test'. NOT for DA (use run-da). NOT for PR 코멘트 (use review-pr-feedback). NOT for 머지 후 종결 절차 (use finish-pr).
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
Manage encrypted secrets with agenix (.age) and 1Password (op CLI, Service Account token, SSH/Automation vault). Covers .age re-encryption, decryption failures, github-pat 무인 gh 인증, SA token 90일 rotation, SSH device key. Trigger: '시크릿', '암호화', '복호화', 'agenix', 'secrets.nix', 'age key', '.age', '토큰 추가', 're-encrypt', '/run/agenix', '1Password', '1password', 'op CLI', 'op_get', 'opnix', 'service account token', 'SA token', 'Automation vault', 'SSH vault', 'github-pat', 'gh 무인 인증', '90일 rotation', 'op read', 'biometric unlock', 'SSH device key', 'mobile-ssh', 'Termius'.
Attach explicitly provided file evidence (screenshots, demo videos, logs) to a GitHub issue or PR with the gh-attach CLI — content-inspection masking gate, irreversible-upload staging, fail-open ATTACH_STATUS reporting. Trigger: standalone attach requests on an existing issue/PR ('이 스크린샷 이슈에 올려줘', 'gh attach로 첨부'), or another GitHub publishing skill reaching for the evidence-attachment procedure. Format/size limits delegated to the GitHub server; Discussions unsupported. NOT for issue/PR creation or body authoring (use create-issue/create-pr).
Create a structured GitHub issue with auto-enriched labels. Trigger: '이슈 등록', '이슈 만들어', 'todo 등록', '버그 등록', '이슈 추가'. NOT for PR 본문 (use create-pr).
사용자가 `/analyzing-da-sessions` 슬래시 명령으로 명시 호출했을 때만 DA 세션 로그 정량 통계를 측정한다. 자연어 trigger 매칭은 사용하지 않는다 — 자연어로 측정을 원하더라도 사용자가 명시 호출해야 한다.
Run Codex CLI subprocesses for explicit codex exec requests, Claude Code or headless automation, and non-interactive code review. Use when requests mention `codex exec` or `비대화형 codex`. Use using-claude-p for Claude headless execution.
Run Devil's Advocate review on plans or code. Args: for_plan, for_pr, both, audit. Modifier: MAX, fresh, agent=<profile>, 사용자 지정 model/effort/tier (key=value 또는 자연어 지정). Trigger: 'DA', '피드백 루프', 'YAGNI 리뷰', '코드 리뷰 루프', 'run-da', 'HALLUCINATION 관점에서 코드 검증', '설계 검토', '코드 품질 리뷰', '간단한 변경 DA 필요 여부', 'DA 필요', 'DA 생략', '사이드이펙트 조사', '회귀 조사', '회귀 감사', '병렬 감사'. Also trigger when the user asks whether a simple change can skip DA; this skill owns the SKIP/LITE/FULL decision path. NOT for PR/AI review-comment HALLUCINATION classification (use review-pr-feedback). NOT for PR 코멘트 (use review-pr-feedback). NOT for 일반 전수조사/코드베이스 조사 (스킬 없이 직접 수행). NOT for DA session log/statistics/verdict 분포 정량 분석 (use analyzing-da-sessions, 사용자 명시 호출 전용).
SOC 직업 분류 기준
| name | create-pr |
| argument-hint | [update] |
| description | Create structured PR. Default: create new PR. Args: update (existing PR body). Trigger: 'PR 만들어줘', 'PR 생성', 'PR 올려', 'create PR', 'PR 업데이트', 'Human Test'. NOT for DA (use run-da). NOT for PR 코멘트 (use review-pr-feedback). NOT for 머지 후 종결 절차 (use finish-pr). |
스킬 호출 인자로 update를 수신하면 기존 PR 본문을 업데이트하고, 인자가 비어있거나 다른 값이면 새 PR을 생성한다.
| 항목 | 위치 |
|---|---|
| 7섹션 PR 본문 템플릿 상세 | references/pr-template.md |
PR 본문은 반드시 다음 7개 섹션을 포함한다.
| # | 섹션 | 역할 |
|---|---|---|
| 1 | Summary | 핵심 변경 1-3 bullet + Closes #N |
| 2 | 기존 문제/배경 | Pain point — 왜 이 변경이 필요한지 |
| 3 | CIR (Change Intent Record) | 발견 경위 + 설계 의도 + 대안 검토 이력. 검토 라운드/finding ID/partial hash chain 포함 금지 (변경 의도는 자연어로) |
| 4 | ADR (Architecture Decision Record) | 대안 비교 테이블 (대안/설명/장점/단점/결정) |
| 5 | 구현 상세 | 변경 파일 테이블 + 핵심 코드 스니펫 |
| 6 | 참고 레퍼런스 | 관련 PR/이슈/외부 링크 (안정 식별자: PR 번호, 이슈 번호, 또는 머지된 SHA — partial hash chain 금지) |
| 7 | Human Test Plan | 단계별 기대동작 + 실패 시 진단 가이드 |
각 섹션의 작성 규칙, 예시, 흔한 실수는 references/pr-template.md 참조.
PR을 생성하기 전에, 작업 결과의 처리 방향을 결정한다:
| 선택지 | 조건 | 행동 |
|---|---|---|
| PR 생성 | 리뷰가 필요한 변경 | 이 스킬의 절차를 진행 |
| 직접 merge | 사용자가 명시적으로 승인한 단순 변경 | main에 현재 브랜치를 git merge 후 종료 |
| 보류 (keep) | 추가 작업이 필요하거나 다른 브랜치와 조율 필요 | 사용자에게 보고 후 종료 |
| 폐기 (discard) | 접근 방식이 잘못되었거나 불필요해짐 | 사용자 확인 후 브랜치 삭제 |
판단이 어려우면 PR 생성을 기본으로 선택한다.
수신한 인자가 비어있거나 update가 아닌 경우 새 PR을 생성한다.
변경 분석: git diff main...HEAD와 커밋 히스토리(git log main..HEAD --oneline)를 분석하여 변경 범위를 파악한다.
연관 이슈 탐색: 커밋 메시지, 브랜치명, 변경 내용에서 이슈 번호를 추출한다. 관련 이슈가 있으면 Summary에 Closes #N을 포함한다.
CIR 수집: 코드 인라인 주석(# CIR:, # === Change Intent Record ===)과 커밋 메시지에서 의사결정 이력을 추출한다. 현재 대화 컨텍스트에서도 방향 전환/대안 거부 이력을 수집한다. 워크트리에 implementation-notes.md가 있으면 아래 흡수 계약을 적용한다.
흡수 계약 (finding-unknowns 방법론 — 이 정의가 정본이며 update 경로도 동일 적용):
<!-- owner: finding-unknowns -->이고, git ls-files --error-unmatch -- implementation-notes.md가 실패(=untracked)해야 흡수 대상이다. header가 없거나 tracked 파일이면 방법론 산출물로 단정하지 말고 흡수·삭제 없이 충돌로 보고한다.<!-- methodology: finding-unknowns -->를 포함한다 — finish-pr 퀴즈 게이트가 별도 세션에서도 방법론 적용 PR을 판별하는 1차 신호다.ADR 테이블 구성: 검토한 대안들을 비교 테이블로 정리한다. 대안이 1개뿐이면 ADR 섹션을 간소화한다.
7섹션 템플릿 작성: references/pr-template.md의 템플릿에 따라 전체 PR 본문을 작성한다. 명시적 시각 증빙 후보가 있으면 using-gh-attach 스킬의 절차를 적용한다 — 처리 결과를 반영한 본문 사본을 아래 6단계의 --body-file로 게시하고(성공한 후보의 첨부는 유지, 실패·skip 후보만 제외), 정본이 정의한 ATTACH_STATUS를 최종 응답에 포함한다.
PR 생성: 본문을 임시 파일로 작성한 뒤 gh pr create --title "<제목>" --body-file <파일>로 PR을 생성한다 — 본문을 shell 인자로 싣지 않는다 (multiline 본문의 프로세스 목록/로그 노출 방지, review-pr-feedback의 파일/stdin 전달 규칙과 동일). 제목은 70자 미만, conventional commit 형식을 따른다.
구현 노트 정리: 3단계에서 implementation-notes.md를 흡수한 경우, 다음 세 조건을 모두 확인한 뒤에만 그 파일을 삭제한다 (남겨두면 finish-pr의 워크트리 정리가 dirty로 중단됨) — ① 1행 owner header 일치, ② git ls-files --error-unmatch -- implementation-notes.md 실패(untracked; tracked면 Git 밖 삭제 금지), ③ 생성된 PR 본문에 Decisions·Deviations·새로 발견된 미지 세 섹션 각각과 durable marker가 모두 반영되었는지 확인 (일부 섹션만 반영된 상태로 통과 금지). 하나라도 어긋나거나 PR 생성이 실패하면 파일을 보존하고 중단한다.
update)수신한 인자가 update인 경우 기존 PR 본문을 보강한다.
gh pr view --json body,title,number로 현재 PR 본문을 가져온다.implementation-notes.md가 있으면 새 PR 생성 절차의 흡수 계약을 그대로 적용한다 (provenance 확인, 세 섹션 전부, durable marker — marker가 본문에 없으면 이때 기록). 기존 user-attachments 링크는 보존하고 재업로드하지 않으며, 명시적으로 새로 제공된 시각 증빙 후보만 using-gh-attach 스킬의 절차를 적용한다 — 처리 결과를 반영한 본문을 4단계의 --body-file 업데이트에 사용하고 ATTACH_STATUS를 최종 응답에 포함한다.gh pr edit <number> --body-file <파일>로 업데이트한다 (본문 shell 인자 전달 금지 — 새 PR 생성 절차와 동일).implementation-notes.md를 흡수한 경우 새 PR 생성 절차의 구현 노트 정리 단계와 동일하게, 세 조건(owner header · untracked · 세 섹션 각각+marker 반영) 확인 후에만 삭제하고 실패 시 보존한다.#N, 이슈 번호 #N, 또는 머지된 commit SHA)를 사용한다. 본인 PR의 mid-flight commit hash 또는 squash 전 partial hash chain은 박제 금지 — squash 후 dangling 위험. "관련 PR 참조" 식의 모호한 레퍼런스도 금지.# CIR: 주석으로 "왜 이렇게 했는지(제거 시 주의)"를 남긴다 — 미래 세션의 의사결정·회귀 조사가 읽을 신호 품질을 높인다 (../run-da/references/decision-regression-audit.md).gh pr create 등)은 예외로 허용한다.Round N), DA finding ID(예: Correctness-1, CORR-2), partial commit hash chain, 워크트리 절대경로.
../../lib/pinning-patterns.sh이며, PR 본문 작성 시에는 본 가이드의 prose 규칙으로 직접 점검한다. 워크트리 절대경로는 본 가이드 자체에서 자연어 설명·repo-relative 경로로 대체하여 점검한다. PR 본문도 동일 정책을 따른다.