Zhaozhao-max/write-requirement-notes

write-requirement-notes은(는) 무엇을 하나요?

제품 내부 검토를 위한 요구사항 및 버그 노트를 정리하는 Codex Skill

개요

이 스킬은 제품 개발 중 수집된 요구사항과 버그 리포트를 내부 검토자(예: 제품 관리자, QA 팀, 개발자)가 쉽게 이해하고 평가할 수 있도록 구조화된 노트로 변환합니다.

주요 기능

• 요구사항 정리: 산발적인 요구사항을 논리적으로 그룹화하고, 각 항목에 우선순위(P1, P2 등)를 부여합니다.
• 버그 노트 생성: 버그의 재현 단계, 영향 범위, 심각도(심각/보통/경미)를 명확히 기술합니다.
• 내부 검토 최적화: 리뷰어가 빠르게 판단할 수 있도록 요약 섹션과 세부 내용을 분리합니다.
• 마크다운 출력: 표준 마크다운 형식으로 출력하여 문서 도구, Wiki, 또는 리포지토리에 바로 사용할 수 있습니다.

사용법

1. 스킬을 활성화합니다 (예: Codex 설정에서 해당 스킬을 추가).
2. 원시 요구사항이나 버그 목록을 입력으로 제공합니다.
3. 스킬이 자동으로 정리된 노트를 생성합니다.
4. 생성된 노트를 복사하여 내부 검토 문서에 붙여넣습니다.

예시 입력

- 버그: 로그인 페이지에서 폰트 깨짐 현상
- 요구사항: 다크 모드 지원 필요
- 버그: 결제 모듈에서 500 에러 발생 (특정 카드사)
- 요구사항: 사용자 프로필 편집 기능 UX 개선

예시 출력

# 제품 내부 검토 노트

## 요구사항

### P1: 다크 모드 지원
- **설명**: 사용자 요청에 따라 다크 모드를 추가해야 합니다.
- **영향 범위**: 전체 UI
- **제안**: 시스템 설정을 따르거나 수동 전환 옵션 제공

### P2: 사용자 프로필 편집 UX 개선
- **설명**: 프로필 편집 화면의 직관성을 높여야 합니다.
- **세부 사항**: 필드 순서 재조정, 저장 버튼 위치 변경

## 버그

### 심각: 결제 모듈 500 에러
- **재현 단계**: 특정 카드사(Visa)로 결제 시도 시 발생
- **영향**: 해당 카드사 사용자 전체 결제 불가
- **우선순위**: 즉시 수정 필요

### 보통: 로그인 페이지 폰트 깨짐
- **재현 환경**: Chrome 최신 버전, macOS
- **원인 추정**: 웹폰트 로딩 실패
- **권장 조치**: fallback 폰트 설정 확인

호환성

• 플랫폼: Codex (OpenAI Codex 기반 에이전트)
• 언어: 입력은 자연어(영문 또는 한글)를 지원하며, 출력은 마크다운 기반입니다.

참고 사항

• 노트는 내부 검토용이므로 외부 공개 시 주의가 필요합니다.
• 생성된 노트는 편집 가능하며, 필요에 따라 추가 정보를 덧붙일 수 있습니다.