メニュー
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: 요청 필드 필수/선택 여부 불명확
- (없으면 이 섹션 생략)
보완 필요 항목이 없으면 "명세 완성도 이상 없음"으로 보고한다.