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": "clean product UI screenshot mockup, modern dashboard interface showing a new analytics chart feature, light mode, minimal design, professional SaaS product",
"width": 1248,
"height": 832
}'
エントリ形式
良いエントリの構成
### 新機能: レポートの一括エクスポート 📊
どのレポートビューからでも、一度に最大10,000行をエクスポートできるようになりました。
行を選択し、「エクスポート」をクリックして、CSVまたはExcel形式を選択してください。
以前は1回のエクスポートにつき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 Webhook** — アカウントでイベントが発生したときに通知を受け取れます。
### 修正
- メール通知が最大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": "add a red circle highlight around the export button in the top right area",
"image": "screenshot.png"
}'
# 機能アナウンスバナー
belt app run falai/flux-dev-lora --input '{
"prompt": "clean modern product announcement banner, gradient blue to purple background, abstract geometric shapes, professional SaaS aesthetic, wide format",
"width": 1248,
"height": 832
}'
破壊的変更
破壊的変更は特別な扱いが必要です：
### ⚠️ 破壊的変更: API v2エンドポイントの非推奨化
**何が変わったか:** API v1エンドポイントは2026年3月15日に動作を停止します。
**あなたが行うべきこと:**
1. API呼び出しをv2エンドポイントに更新（[移行ガイド →](link)）
2. APIキーの代わりにBearerトークンを使用するよう認証を更新
3. 2026年3月15日までに統合をテスト
**スケジュール:**
- 現在: v2エンドポイントが利用可能、v1は引き続き動作
- 3月1日: v1が非推奨警告を返す
- 3月15日: v1が動作停止
移行についてサポートが必要な場合は、[email protected] までご連絡ください。
配信チャネル
| チャネル | 形式 | タイミング |
|---|---|---|
| チェンジログページ | 全詳細、全エントリ | リリースごと |
| アプリ内通知 | 1～2行の要約 | 新機能、破壊的変更 |
| メール | 厳選されたハイライト、ビジュアル | メジャーリリース（月次/四半期） |
| ブログ記事 | 深掘りとコンテキスト | 大きなローンチ |
| SNS | 単一機能のハイライト | 注目すべき機能 |
| Slack/Discord | 簡潔なアナウンス | コミュニティがある場合 |
SNSスニペットの形式
🆕 [プロダクト名]の新機能: [機能名]
[何ができるようになったかの1～2文]
[スクリーンショットまたはデモ動画]
今すぐ試す → [link]
ライティングのヒント
やるべきこと
- 関連する変更をグループ化する
- 最も大きく、最もリクエストの多かった変更から始める
- 複雑な機能にはドキュメントへのリンクを貼る
- リクエスト元を含める（「ご要望により:」）
- 破壊的変更には移行パスを示す
- すべてのエントリに日付を付ける
やってはいけないこと
- 「さまざまなバグ修正」と言わない — 具体的な修正を列挙するか、スキップする
- 内部参照（PR番号、チケットID、ブランチ名）を含めない
- 「[機能]を更新しました」を改善や修正の説明なしに使わない
- 誰も気にしない変更（依存関係の更新、内部リファクタリング）をリストしない
- コミットをそのまま載せない — 1つのチェンジログエントリで多くのコミットを代表することがある
チェンジログの頻度
| プロダクトタイプ | 頻度 | 備考 |
|---|---|---|
| SaaS（継続的デプロイ） | 毎週まとめて | 1週間分の変更をグループ化 |
| SaaS（メジャー機能） | 機能ローンチごと | ブログ記事と共に |
| バージョン管理ソフトウェア | バージョンリリースごと | semverに紐づけ |
| API | バージョンごと + 非推奨通知 | 移行ガイドを含める |
| モバイルアプリ | アプリストアリリースごと | ストアの「新機能」と合わせる |
よくある間違い
| 間違い | 問題 | 修正 |
|---|---|---|
| 開発者向けの言葉 | ユーザーが理解できない | ユーザーができることを書く |
| 「バグ修正と改善」 | 情報ゼロ | 具体的な修正をリストする |
| 日付なし | 何が新しいかわからない | すべてのエントリに日付を付ける |
| ビジュアルなし | ユーザーがテキストをスキップする | 主要機能のスクリーンショット |
| 破壊的変更が埋もれている | ユーザーが気づくのが遅すぎる | 目立つ警告とスケジュール |
| コミットログをそのまま | ノイズが多く役に立たない | 厳選して書き直す |
関連スキル
npx skills add inference-sh/skills@ai-image-generation
npx skills add inference-sh/skills@prompt-engineering
すべてのアプリを参照: belt app list