belt CLI 스킬 설치:
npx skills add belt-sh/cli
제품 체인지로그
사용자가 읽고 관심을 갖는 체인지로그와 릴리스 노트를 inference.sh CLI를 통해 작성하세요.
빠른 시작
inference.sh CLI(
belt) 필요함. 설치 안내
belt login
# 기능 공지 시각 자료 생성
belt app run falai/flux-dev-lora --input '{
"prompt": "깔끔한 제품 UI 스크린샷 목업, 새로운 분석 차트 기능을 보여주는 현대적인 대시보드 인터페이스, 라이트 모드, 미니멀 디자인, 전문적인 SaaS 제품",
"width": 1248,
"height": 832
}'
항목 작성 형식
좋은 항목의 구성
### 신규: 대량 내보내기 📊
이제 모든 리포트 보기에서 한 번에 최대 10,000개의 행을 내보낼 수 있습니다.
행을 선택하고 내보내기를 클릭한 후 CSV 또는 Excel 형식을 선택하세요.
이전에는 내보내기당 500행으로 제한되었습니다.
구조: 카테고리 라벨 -> 사용자 대상 제목 -> 지금 할 수 있는 작업 -> 방법 -> 변경 사항 -> 시각 자료
사용자 중심 언어
❌ 내부 언어:
"내보내기 서비스를 위한 배치 처리 큐 구현"
"페이지네이션을 지원하도록 ReportExporter 클래스 리팩토링"
"CSV 직렬화 버그 수정 (PR #4521)"
✅ 사용자 중심 언어:
"이제 모든 리포트에서 한 번에 최대 10,000개의 행을 내보낼 수 있습니다"
"대용량 데이터 세트 필터링 시 리포트가 3배 더 빠르게 로드됩니다"
"내보낸 CSV 파일에 열이 누락되는 문제가 수정되었습니다"
규칙:
- 구축한 것이 아니라 사용자가 할 수 있는 것을 작성하세요.
- "이제 다음을 할 수 있습니다..." / "이제 ...합니다" / "다음 문제가 수정되었습니다..."로 시작하세요.
- 메커니즘뿐만 아니라 이점도 포함하세요.
- 현재 시제를 사용하세요.
카테고리
표준 카테고리
| 카테고리 | 색상 | 아이콘 | 용도 |
|---|---|---|---|
| 신규 | 초록색 | ✨ 또는 🆕 | 완전히 새로운 기능 또는 역량 |
| 개선 | 파란색 | ⚡ 또는 🔧 | 기존 기능 개선 |
| 수정 | 노랑/주황 | 🐛 또는 🔨 | 버그 수정 |
| 제거 | 빨간색 | 🗑️ 또는 ⚠️ | 지원 중단 또는 제거된 기능 |
| 보안 | 보라색 | 🔒 | 보안 패치 |
분류 규칙
- 신규 = 사용자가 이전에 전혀 할 수 없었던 것
- 개선 = 사용자가 할 수 있었지만 이제 더 좋아지거나, 빠르거나, 쉬워진 것
- 수정 = 고장 났던 것이 이제 제대로 작동하는 것
- "업데이트됨"은 사용하지 마세요. 의미가 없습니다. 개선되었나요, 수정되었나요?
버전 번호 부여
시맨틱 버저닝 (SemVer)
MAJOR.MINOR.PATCH
3 . 2 . 1
| 구성 요소 | 증가 시점 | 예시 |
|---|---|---|
| MAJOR | 호환되지 않는 변경, 주요 재설계 | 2.0.0 -> 3.0.0 |
| MINOR | 새 기능, 하위 호환 유지 | 3.1.0 -> 3.2.0 |
| PATCH | 버그 수정, 소규모 개선 | 3.2.0 -> 3.2.1 |
날짜 기반 버저닝
2026-02-08 또는 2026.02.08 또는 2026년 2월 8일
지속적 배포 환경의 SaaS 제품에 가장 적합합니다.
체인지로그 페이지 구조
# 체인지로그
## 2026년 2월 8일
### 신규
- **리포트 대량 내보내기** — 한 번에 최대 10,000개 행 내보내기. [자세히 알아보기 →](link)
- **다크 모드** — 설정 > 모양에서 다크 모드 전환.
### 개선
- **대시보드 로딩** — 대시보드가 대용량 데이터 세트에서 3배 더 빠르게 로드됩니다.
- **검색** — 검색 결과에 보관된 항목이 포함됩니다.
### 수정
- 내보낸 CSV 파일에 열 헤더가 누락되는 문제가 수정되었습니다.
- 날짜 선택기가 잘못된 시간대를 표시하는 버그가 수정되었습니다.
---
## 2026년 2월 1일
### 신규
- **API 웹훅** — 계정에서 이벤트가 발생할 때 알림을 받습니다.
### 수정
- 이메일 알림이 최대 2시간 지연되는 문제가 수정되었습니다.
시각적 체인지로그
시각 자료를 추가해야 할 때
| 변경 유형 | 시각 자료 |
|---|---|
| 새로운 UI 기능 | 새 기능 스크린샷 |
| UI 재설계 | 전후 비교 |
| 새 워크플로우 | 단계별 스크린샷 또는 짧은 동영상 |
| 성능 개선 | 개선 사항을 보여주는 차트 |
| 복잡한 기능 | 애니메이션 GIF 또는 동영상 데모 |
시각 자료 생성
# 기능 스크린샷 (앱이 실행 중인 경우 에이전트 브라우저 사용)
belt app run infsh/agent-browser --input '{
"url": "https://your-app.com/new-feature",
"action": "screenshot"
}'
# 전후 비교
belt app run infsh/stitch-images --input '{
"images": ["before-screenshot.png", "after-screenshot.png"],
"direction": "horizontal"
}'
# 콜아웃이 있는 주석 스크린샷
belt app run bytedance/seededit-3-0-i2i --input '{
"prompt": "오른쪽 상단 영역의 내보내기 버튼 주위에 빨간색 원 강조 표시 추가",
"image": "screenshot.png"
}'
# 기능 공지 배너
belt app run falai/flux-dev-lora --input '{
"prompt": "깔끔한 현대적인 제품 공지 배너, 파란색에서 보라색으로 그라데이션 배경, 추상적인 기하학적 모양, 전문적인 SaaS 미학, 와이드 형식",
"width": 1248,
"height": 832
}'
호환되지 않는 변경
호환되지 않는 변경은 특별한 처리가 필요합니다:
### ⚠️ 호환 중단: API v2 엔드포인트 지원 중단
**변경 사항:** API v1 엔드포인트가 2026년 3월 15일에 중단됩니다.
**해야 할 작업:**
1. API 호출을 v2 엔드포인트로 업데이트하세요 ([마이그레이션 가이드 →](link))
2. API 키 대신 Bearer 토큰을 사용하도록 인증을 업데이트하세요.
3. 3월 15일 이전에 통합을 테스트하세요.
**일정:**
- 지금: v2 엔드포인트 사용 가능, v1 계속 작동
- 3월 1일: v1이 지원 중단 경고 반환
- 3월 15일: v1 중단
마이그레이션에 도움이 필요하면 [email protected]으로 문의하세요.
배포 채널
| 채널 | 형식 | 시기 |
|---|---|---|
| 체인지로그 페이지 | 전체 세부 정보, 모든 항목 | 모든 릴리스 |
| 인앱 알림 | 1-2줄 요약 | 새 기능, 호환되지 않는 변경 |
| 이메일 | 선별된 주요 내용, 시각 자료 | 주요 릴리스 (월별/분기별) |
| 블로그 게시물 | 컨텍스트가 있는 심층 분석 | 대규모 출시 |
| 소셜 미디어 | 단일 기능 강조 | 주목할 만한 기능 |
| Slack/Discord | 간단한 공지 | 커뮤니티가 있는 경우 |
소셜 미디어 스니펫 형식
🆕 [Product]의 새로운 기능: [Feature Name]
[지금 할 수 있는 작업에 대한 1-2문장 설명]
[스크린샷 또는 데모 동영상]
지금 사용해 보세요 → [link]
작성 팁
권장 사항
- 관련 변경 사항을 함께 그룹화하세요.
- 가장 크거나 가장 많이 요청된 변경 사항을 먼저 배치하세요.
- 복잡한 기능에 대한 문서 링크를 제공하세요.
- 요청자를 포함하세요 ("많은 요청에 따라:").
- 호환되지 않는 변경에 대한 마이그레이션 경로를 표시하세요.
- 모든 항목에 날짜를 기입하세요.
금지 사항
- "다양한 버그 수정"이라고 말하지 마세요. 구체적인 수정 사항을 나열하거나 건너뛰세요.
- 내부 참조 (PR 번호, 티켓 ID, 브랜치 이름)를 포함하지 마세요.
- "[기능] 업데이트됨"이라고 방법을 설명하지 않고 말하지 마세요.
- 아무도 신경 쓰지 않는 변경 사항 (의존성 업그레이드, 내부 리팩토링)을 나열하지 마세요.
- 커밋을 덤프하지 마세요. 하나의 체인지로그 항목이 많은 커밋을 나타낼 수 있습니다.
체인지로그 빈도
| 제품 유형 | 빈도 | 참고 |
|---|---|---|
| SaaS (지속적 배포) | 주별 배치 | 한 주의 변경 사항 그룹화 |
| SaaS (주요 기능) | 기능 출시별 | 블로그 게시물과 함께 |
| 버전 관리 소프트웨어 | 버전 릴리스별 | semver에 연결 |
| API | 버전별 + 지원 중단 공지 | 마이그레이션 가이드 포함 |
| 모바일 앱 | 앱 스토어 릴리스별 | 스토어 목록의 "새로운 기능"과 일치 |
일반적인 실수
| 실수 | 문제 | 해결책 |
|---|---|---|
| 개발자 언어 | 사용자가 이해하지 못함 | 사용자가 할 수 있는 작업 작성 |
| "버그 수정 및 개선" | 정보 없음 | 구체적인 수정 사항 나열 |
| 날짜 없음 | 새로운 내용을 알 수 없음 | 모든 항목에 날짜 기입 |
| 시각 자료 없음 | 사용자가 텍스트 건너뜀 | 주요 기능 스크린샷 |
| 호환되지 않는 변경이 묻힘 | 사용자가 너무 늦게 발견 | 눈에 띄는 경고 + 일정 |
| 커밋 로그를 체인지로그로 사용 | 시끄럽고 도움 안 됨 | 선별 및 다시 작성 |
관련 스킬
npx skills add inference-sh/skills@ai-image-generation
npx skills add inference-sh/skills@prompt-engineering
모든 앱 보기: belt app list