메뉴
노션 기획문서와 실제 구현 코드를 비교 검토하여 누락/상이/권한 이슈를 찾아내고 일관된 양식의 마크다운 보고서를 생성하는 스킬입니다. 이 스킬은 다음 상황에서 사용됩니다: - 사용자가 노션 기획문서 링크를 제공하고 구현 검토를 요청할 때 - "/spec-review", "/spec-review <노션URL>" 형태로 호출할 때 - "기획문서 검토", "스펙 리뷰", "구현 검토" 등을 요청할 때
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | spec-review |
| description | 노션 기획문서와 실제 구현 코드를 비교 검토하여 누락/상이/권한 이슈를 찾아내고 일관된 양식의 마크다운 보고서를 생성하는 스킬입니다. 이 스킬은 다음 상황에서 사용됩니다: - 사용자가 노션 기획문서 링크를 제공하고 구현 검토를 요청할 때 - "/spec-review", "/spec-review <노션URL>" 형태로 호출할 때 - "기획문서 검토", "스펙 리뷰", "구현 검토" 등을 요청할 때 |
노션 기획문서와 코드베이스 구현을 비교 검토하여 Gap Analysis 보고서를 생성한다.
사용자가 URL을 제공하지 않은 경우, 노션 기획문서 링크를 요청한다.
검토할 노션 기획문서 링크를 알려주세요.
Notion MCP를 사용하여 기획문서 전체 내용을 수집한다.
2.1 page_id 추출:
https://www.notion.so/{workspace}/{title}-{page_id}- 이후 32자 (하이픈 제외)2ff471f8dcff81ca94d3fc48c83840b7 → 2ff471f8-dcff-81ca-94d3-fc48c83840b72.2 페이지 메타데이터 조회:
mcp__notion__API-retrieve-a-page(page_id)
2.3 본문 블록 수집:
mcp__notion__API-get-block-children(block_id=page_id)
2.4 대용량 문서 처리: 문서가 클 경우 (토큰 초과 시) 결과가 파일로 저장됨. jq로 파싱:
# JSON 추출 후 임시 파일 저장
cat {saved_file} | jq -r '.[0].text' > /tmp/notion_blocks.json
# 헤딩 추출 (문서 구조 파악)
jq -r '.results[] | select(.type | startswith("heading")) |
"\(.type): \(.heading_1.rich_text[0].plain_text // .heading_2.rich_text[0].plain_text // .heading_3.rich_text[0].plain_text)"' /tmp/notion_blocks.json
# 코드 블록 추출 (API 스펙, 타입 정의)
jq -r '.results[] | select(.type == "code") | .code.rich_text[0].plain_text' /tmp/notion_blocks.json
2.5 테이블 블록 처리: 권한, 필드 명세 등 중요 정보가 테이블에 포함됨. 테이블 블록 ID 추출 후 children 별도 조회:
# 테이블 블록 ID 목록
jq -r '.results[] | select(.type == "table") | .id' /tmp/notion_blocks.json
# 각 테이블의 행(row) 조회
mcp__notion__API-get-block-children(block_id={table_id})
문서에서 다음 항목을 추출한다:
| 항목 | 찾을 패턴 | 주요 위치 |
|---|---|---|
| API 엔드포인트 | GET/POST/PUT/PATCH/DELETE, URL 패턴 | code 블록 |
| 화면 필드 | 테이블 형태의 필드 목록 | table 블록 |
| 비즈니스 로직 | "~해야 한다", 검증 규칙, AC(인수조건) | quote/paragraph 블록 |
| 권한 요구사항 | "권한", "Role", 역할별 권한 테이블 | table 블록 |
| 에러 케이스 | "오류", "예외", "실패 시" | quote 블록 |
기획문서에서 추출한 항목을 기반으로 코드베이스를 탐색한다.
4.1 API 엔드포인트 검색:
# 도메인 키워드로 Controller 찾기
Grep(pattern="company|Company", path="modules/application/api", glob="*Controller.kt")
# 특정 Controller 읽기
Read(file_path="...Controller.kt")
4.2 권한 검색:
# @PreAuthorize 어노테이션 확인
Grep(pattern="@PreAuthorize", path="modules/application/api/src/main/kotlin/.../controller")
# 권한 표현식 확인
Grep(pattern="hasAuthority|hasRole", path="modules")
4.3 DTO/Request/Response 검색:
# 요청/응답 DTO 확인
Glob(pattern="**/*Request.kt", path="modules/application/api")
Glob(pattern="**/*Response.kt", path="modules/application/api")
4.4 도메인 모델 검색:
# 도메인 엔티티 및 VO 확인
Grep(pattern="require|check", path="modules/domain")
references/checklist.md를 참조하여 다음 카테고리별로 분석한다:
심각도 분류:
6.1 디렉토리 생성:
mkdir -p docs/spec-review
6.2 보고서 작성:
assets/report-template.md 양식을 사용하여 보고서를 생성한다.
출력 위치: docs/spec-review/{문서제목}_{YYYYMMDD}.md
파일명 규칙:
-로 대체회사-정보_20260215.mdchecklist.md — 검토 체크리스트 및 판단 기준report-template.md — 보고서 마크다운 템플릿jh_kim dev 계정(dev Keycloak)으로 E2E API 테스트를 수행하는 스킬입니다. 로컬 main 빌드 API + dev DB + dev Keycloak PKCE 토큰 조합으로, dev API 서버에 아직 배포되지 않은 머지 코드를 실데이터 환경에서 검증할 때 사용합니다. "/e2e-test-dev", "dev 계정으로 E2E", "jh_kim으로 API 테스트", "dev DB로 E2E 테스트" 등을 요청할 때 사용됩니다. (로컬 Docker Keycloak 기반 테스트는 e2e-test 스킬 사용)
plan-master(기획용 FE 코드 + docs/specs 기획서)와 bitda-back(구현된 BE 코드) 사이의 갭을 분석하여 누락된 기능·API·정책을 GitHub 이슈로 자동 생성하는 스킬입니다. 기획서→이슈 전달 과정에서 발생하는 누락을 방지하기 위해 FE 코드를 1차 소스로 사용합니다. "/gap-analyze", "/gap-analyze BOM", "/gap-analyze production" 등을 요청할 때 사용됩니다.
plan-master FE 코드만을 유일한 1차 소스로(기획서 .md 배제) 멀티팀 에이전트가 BE가 보장해야 할 비즈니스 로직과 FE 작업에 필요한 API 항목을 도출하고, 총괄 에이전트가 bitda-back BE 구현과 실측 대조하여 누락 갭을 발굴, 직렬 verifier로 확정한 뒤 GitHub 이슈로 생성하는 스킬입니다. gap-analyze의 변종으로, 기획서가 구현완료를 선언해 갭을 가리는 오염을 제거하기 위해 기획서를 의도적으로 보지 않습니다. /gap-fe-code 생산현황, 기획서 빼고 FE 코드로 갭 분석, FE 코드만 보고 누락 API 이슈 만들어 등을 요청할 때 사용됩니다.
실제 API 서버(8080 포트)를 실행하고 Keycloak OAuth 인증을 통해 E2E API 테스트를 수행하는 스킬입니다. 테스트 결과와 요청/응답을 docs/e2e-test/{test}/ 디렉토리에 markdown 형식으로 기록합니다. 이 스킬은 다음 상황에서 사용됩니다: - 특정 API의 실제 동작을 테스트하고 싶을 때 - API 변경 후 실제 환경에서 검증이 필요할 때 - 사용자가 "E2E 테스트", "API 테스트", "/e2e-test" 등을 요청할 때
Creates phase-based feature plans with quality gates and incremental delivery structure. Use when planning features, organizing work, breaking down tasks, creating roadmaps, or structuring development strategy. Keywords: plan, planning, phases, breakdown, strategy, roadmap, organize, structure, outline.
Swagger 스냅샷(api-docs.json)과 코드베이스를 기반으로 Notion API 맵핑 DB에 API 문서를 등록하고 상세 페이지를 작성하는 스킬입니다. (notion-api.py REST wrapper 사용 버전) 이 스킬은 다음 상황에서 사용됩니다: - 특정 API를 Notion에 문서화할 때 (MCP 비활성화 환경) - mcp__notion__* 도구 deprecated/불안정한 경우 - 사용자가 "api 노션 등록 (api 모드)", "/api-to-notion-api" 등을 요청할 때