القائمة
이슈 스펙 대비 구현 완료 여부를 독립 감사인 관점에서 검증합니다. 이슈 감사, 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