메뉴
이슈 스펙 대비 구현 완료 여부를 독립 감사인 관점에서 검증합니다. 이슈 감사, issue audit, 구현 검증, 크로스체크 시 사용합니다.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
이슈 단위로 스펙, 실행 계획, 수행 요약을 관리하는 워크플로우입니다. 이슈 작업, issue, 이슈 시작, 이슈 완료, 워크플로우 복구(--workflow-only), 이어하기, resume, 작업 재개(--resume), 이슈 정리, 작업공간 정리, 정리(--clear), audit 리포트 검토·피드백 후 승인 보정(--response) 시 사용합니다.
현재 스킬 repo의 skill을 선택하여 Claude Code·Agents·Antigravity·Codex·Junie 경로(~/.claude/skills/ 등 5개)에 설치합니다. --all(전체 경로)·--clear(클린 재설치)·--self(self-install 부트스트랩) 옵션을 지원합니다. skill 설치, install skills, 스킬 배포, 스킬 재설치, self-install 시 사용합니다.
대화 중 중요한 맥락(배경, 결정, 미결 사항, 다음 액션)을 `.ai/99_workspace/notes/` 아래 마크다운 파일로 저장합니다. 맥락 저장, context save, 임시 저장, 논의 스냅샷, 작업 메모 시 사용합니다.
PR 제목과 메시지를 정책(Conventional Commits 제목 + 이슈별 비즈니스/테크 관점)에 맞게 작성합니다. PR 작성, PR 메시지·설명 작성, pull request, 풀리퀘스트, PR 올리기 전 정리, 리뷰어용 설명 정리 시 사용합니다. 실제 PR 생성·제출이 아니라 메시지 텍스트 작성용입니다.
멀티 repo 워크스페이스 루트의 로비 `.ai/AI-CONTEXT.md`를 생성하거나 진단·재구성합니다. `ai-workspace`의 자매 스킬로, building 안내판(=lobby) 역할의 lean 라우터를 만듭니다. 로비, lobby, AI-CONTEXT.md, building 인덱스, 워크스페이스 안내판 작업 시 사용합니다.
프로젝트를 분석하여 README.md를 생성하거나 최신 상태로 재작성합니다. README.md가 없으면 템플릿에 따라 새로 작성하고, 이미 있으면 현재 프로젝트 구조에 맞게 재작성합니다. README 작성, README 갱신, readme sync, 리드미 최신화 시 사용합니다.
| name | issue-audit |
| description | 이슈 스펙 대비 구현 완료 여부를 독립 감사인 관점에서 검증합니다. 이슈 감사, issue audit, 구현 검증, 크로스체크 시 사용합니다. |
이슈 스펙(요구사항) 대비 구현을 독립 감사인 관점에서 검증합니다. 구현을 수행한 AI가 아닌 다른 모델이 실행하는 것을 전제로, 두 단계로 감사를 수행합니다.
.ai/90_issues/ 의 스펙·계획·요약 파일을 감사 입력으로 활용합니다.
issue-work 계획의 마지막 고정 **Task N(교차모델 검증)**에서 이 스킬을 호출합니다 —
구현 모델과 다른 벤더 모델(Non-Anthropic 포함)로 사용자가 직접 수동 수행하며,
감사 결과는 issue-<번호>-summary.md의 모델 기록·Task별 결과에 반영합니다..ai/30_contract/, .ai/40_domain/ 문서를 비즈니스 검증에 참조합니다.
git-review와의 차이: git-review는 PR 단위 코드 품질 리뷰이고, issue-audit는 이슈 단위 스펙 충족 + 비판적 검증입니다.
.ai/10_rules/context-loading.md — 있으면 따르며, 이미 적재되어 있으면 재로딩하지 않습니다..ai/90_issues/active/ 하위 전체 또는 .ai/90_issues/archive/issue-<번호>/ 전체.ai/30_contract/index.md, .ai/40_domain/index.md — 도메인·계약 정합성 (index 먼저 → 관련 파일만 선택적으로).ai/50_adr/index.md — Phase 1 범위 검증 시 ADR과의 정합성 대조 (index 먼저 → 관련 ADR만 선택적으로).ai/60_codebase/index.md — 관련 기능의 호출 흐름이 스킬을 실행하는 AI는 독립 감사인입니다.
사용자로부터 아래 정보를 확인합니다.
| 항목 | 필수 | 설명 |
|---|---|---|
| 이슈 번호 | O | GitHub Issue 번호 또는 이슈 식별자 |
| 구현 브랜치 | △ | 미지정 시 현재 브랜치 사용 |
.ai/90_issues/active/issue-<번호>/ 또는 .ai/90_issues/archive/issue-<번호>/ 에서 스펙·계획·요약 파일을 읽는다.
.ai/60_codebase/index.md에 내용이 있으면 참고하여 관련 기능의 호출 흐름을 빠르게 파악한다.
/code-map)" 의견을 남긴다..ai/30_contract/index.md, .ai/40_domain/index.md, .ai/50_adr/index.md를 먼저 읽고 관련 문서만 선택적으로 확보한다 (있는 경우).목적: 이슈 스펙에서 요구한 사항이 빠짐없이 구현되었는지 대조한다.
.ai/30_contract/, .ai/40_domain/, .ai/50_adr/ 의 관련 문서가 있으면 구현이 이와 충돌하지 않는지 검증한다.각 항목에 대해 아래 중 하나로 판정한다.
| 판정 | 의미 |
|---|---|
| PASS | 스펙 요구사항을 충족함 |
| FAIL | 스펙 요구사항을 충족하지 않음 |
| PARTIAL | 부분적으로 충족하나 불완전함 |
| N/A | 현재 변경 범위에서 판정 불가 |
목적: "이 구현이 왜 잘못되었을 수 있는가?"를 전제로 적극적으로 문제를 탐색한다.
각 발견 사항에 대해 아래 중 하나로 분류한다.
| 위험도 | 의미 |
|---|---|
| HIGH | 장애·데이터 손실·보안 이슈로 이어질 수 있음 |
| MEDIUM | 기능 오작동 또는 사용성 저하 가능성 |
| LOW | 개선 권장 사항 또는 잠재적 기술 부채 |
| INFO | 참고 사항, 조치 불필요 |
templates/issue-audit-report-template.md를 참조하여 감사 리포트를 작성한다..ai/99_workspace/issue-<번호>-audit-report.md에 저장한다.OpenAI, GPT-5.x / Google, Gemini 3.x). 이는 issue-work의 summary 모델 기록과 동일한 형식이며, 리포트 템플릿의 '감사 모델' 줄(#26)도 이 형식을 따른다.감사 완료 후 사용자에게 아래 형식으로 요약을 보고한다.
## Issue #<번호> 감사 결과 요약
### Phase 1: 적합성 검증
- PASS: N건 / FAIL: N건 / PARTIAL: N건
### Phase 2: 비판적 검증
- HIGH: N건 / MEDIUM: N건 / LOW: N건 / INFO: N건
### 주요 발견 사항
1. ...
2. ...
> 상세 리포트: .ai/99_workspace/issue-<번호>-audit-report.md