메뉴
Notion에서 백엔드 모듈의 API 명세를 MCP로 가져와 docs/backend/api-docs/{module}.md에 저장하는 스킬. "Notion API 가져와줘", "api-docs 동기화", "API 명세 불러와줘", "[모듈] API 문서 받아와", "api-docs 업데이트", "Notion에서 [모듈] 명세 내려받아" 요청 시 트리거한다. be-orchestrate가 Phase 1에서 내부적으로 사용하며 독립적으로도 트리거 가능하다.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
현재 PR의 리뷰 코멘트를 분석해 타당한 것만 반영하는 스킬. "리뷰 반영해줘", "PR 리뷰 처리해줘", "코드래빗 리뷰 봐줘", "리뷰 코멘트 반영", "follow review", "apply review" 요청 시 트리거한다. 사람 리뷰는 존중하고 AI 리뷰는 선별해 반영하며, 수정 후 검증한다.
백엔드 API를 frontend/src에 연동하는 스킬. "API 연동해줘", "백엔드 연결해줘", "엔드포인트 붙여줘", "쿼리 훅 만들어줘", "mutation 추가해줘", "이 API 호출하게 해줘" 요청 시 트리거한다. 타입·schema·API 함수·훅·MSW 핸들러를 기존 패턴대로 작성한다.
Figma 디자인을 가져와 frontend/src에 컴포넌트로 구현하는 스킬. "피그마 적용", "figma 디자인 구현해줘", "이 화면 만들어줘", "캡쳐한 디자인대로 만들어줘", figma.com URL 제공 시 트리거한다. 기존 디자인 토큰과 shared/ui 컴포넌트를 재사용해 구현한다.
frontend/.claude/skills/ 아래에 새 프론트엔드 스킬을 만드는 메타 스킬. "스킬 만들어줘", "skill 생성", "새 스킬 추가", "fe 스킬 만들어줘", "스킬 크리에이터" 요청 시 트리거한다. 기존 fe- 스킬과 형식·말투·범위를 일치시켜 SKILL.md를 생성한다.
frontend/src 코드에 테스트를 작성하는 스킬. "테스트 작성해줘", "test 짜줘", "테스트 추가해줘", "이거 테스트 커버해줘", "spec 작성" 요청 시 트리거한다. 대상에 맞는 도구를 골라 계약 중심 테스트를 작성한다.
frontend/src 변경을 시니어 개발자 시선으로 검증하는 QA 스킬. "QA 해줘", "검증해줘", "코드 리뷰", "리뷰해줘", "merge 전에 봐줘" 요청 시 트리거한다. 구현하지 않고 검증과 보고만 수행한다.
| name | be-api-sync |
| description | Notion에서 백엔드 모듈의 API 명세를 MCP로 가져와 docs/backend/api-docs/{module}.md에 저장하는 스킬. "Notion API 가져와줘", "api-docs 동기화", "API 명세 불러와줘", "[모듈] API 문서 받아와", "api-docs 업데이트", "Notion에서 [모듈] 명세 내려받아" 요청 시 트리거한다. be-orchestrate가 Phase 1에서 내부적으로 사용하며 독립적으로도 트리거 가능하다. |
Notion의 API 명세를 docs/backend/api-docs/{module}.md로 가져온다. 분석하거나 설계하지 않는다.
어떤 모듈의 API 명세를 가져올지 확인한다. 모듈명이 명시되지 않았으면 사용자에게 확인한다.
모듈명은 자유 입력이다. 사전에 정의된 목록에 없어도 요청한 이름 그대로 사용한다.
아래 순서로 검색한다:
도구: mcp__claude_ai_Notion__notion-search
쿼리 순서:
1. "{모듈명} API"
2. "{모듈명} 명세"
3. "{모듈명} endpoint"
검색 결과에서 API 명세 페이지를 특정한다. 찾지 못하면 사용자에게 Notion 페이지 URL 또는 ID를 요청한다.
도구: mcp__claude_ai_Notion__notion-fetch
입력: Step 2에서 찾은 페이지 URL 또는 ID
Notion 내용을 아래 형식으로 변환해 docs/backend/api-docs/{module}.md에 저장한다.
응답 형식 변환 규칙:
{ "data": ..., "success": true } 형태로 변환한다넘버링 보존 규칙: Notion 원본에 #N 형태의 번호가 있으면 섹션 제목에 그대로 유지한다 (## #1 GET /경로). 번호가 없으면 생략한다.
출력 파일 형식:
# {모듈명} API
> 최종 동기화: {YYYY-MM-DD}
>
> ⚠️ 변환 노트: (차이점 있으면 기록, 없으면 이 줄 삭제)
---
## #N {HTTP 메서드} {경로}
**설명:** {엔드포인트 설명}
**인증:** 필요 (JWT Bearer) / 불필요
### Request
**Path Parameters** (없으면 생략)
| 파라미터 | 타입 | 필수 | 설명 |
|---------|------|:----:|------|
**Query Parameters** (없으면 생략)
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---------|------|:----:|:-----:|------|
**Body** (없으면 생략)
```json
{}
```
{
"data": { ... },
"success": true
}
| 코드 | 조건 |
|---|---|
| 400 | 잘못된 입력 |
| 401 | 인증 실패 |
| 403 | 권한 없음 |
| 404 | 리소스 없음 |
## Step 5: Gap 리포트 출력
저장 완료 후 아래 형식으로 명세 완성도를 보고한다.
```markdown
## API 명세 동기화 완료
파일: docs/backend/api-docs/{module}.md
엔드포인트: {N}개 ({목록})
### 명세 완성도
| 엔드포인트 | 요청 | 응답 필드 | 에러 코드 | 인증 |
|-----------|:----:|:--------:|:--------:|:----:|
| GET /xxx | ✅ | ✅ | ⚠️ 누락 | ✅ |
### 보완 필요 항목
아래 항목은 설계 단계에서 자동 보완 가능한 것과 사용자 확인이 필요한 것으로 구분한다.
**자동 보완 가능** (schema 또는 컨벤션 기반):
- GET /xxx: 응답 필드 누락 → prisma/schema.prisma 기반으로 채울 수 있음
- POST /yyy: 에러 코드 누락 → 표준 400/401/403/404 적용 가능
**사용자 확인 필요** (비즈니스 로직 결정):
- PATCH /zzz: 요청 필드 필수/선택 여부 불명확
- (없으면 이 섹션 생략)
보완 필요 항목이 없으면 "명세 완성도 이상 없음"으로 보고한다.