product-changelog

belt CLI スキルをインストールする： npx skills add belt-sh/cli

プロダクトの変更履歴

ユーザーが読み、関心を持つ変更履歴やリリースノートを、inference.sh CLI 経由で作成します。

クイックスタート

inference.sh CLI（belt）が必要です。インストール手順

belt login

# Generate a feature announcement visual
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
}'

エントリーの形式

優れたエントリーの構成

### New: Bulk Export for Reports 📊

You can now export up to 10,000 rows at once from any report view.
Select your rows, click Export, and choose CSV or Excel format.

Previously limited to 500 rows per export.

![Bulk export button in the reports toolbar](screenshot.png)

構成： カテゴリーラベル -> ユーザー向けのタイトル -> 新たにできること -> 方法 -> 変更内容 -> ビジュアル

ユーザー向けの表現

❌ Internal language:
"Implemented batch processing queue for the export service"
"Refactored the ReportExporter class to support pagination"
"Fixed bug in CSV serialization (PR #4521)"

✅ User-facing language:
"You can now export up to 10,000 rows at once from any report"
"Reports now load 3x faster when filtering large datasets"
"Fixed an issue where exported CSV files had missing columns"

ルール：

• 開発したものではなく、ユーザーができるようになったことを書く
• 「これで〜できるようになりました」／「レポートで〜できるようになりました」／「〜という問題を修正しました」から始める
• 仕組みだけでなく、メリットを含める
• 現在形を使う

カテゴリー

標準カテゴリー

カテゴリー	色	アイコン	用途
新機能	緑	✨ または 🆕	まったく新しい機能や能力
改善	青	⚡ または 🔧	既存機能の強化
修正	黄／オレンジ	🐛 または 🔨	バグ修正
削除	赤	🗑️ または ⚠️	非推奨または削除された機能
セキュリティ	紫	🔒	セキュリティパッチ

カテゴリー分けのルール

• 新機能 = ユーザーが以前はまったくできなかったこと
• 改善 = 以前からできたことが、より良く／速く／簡単になったこと
• 修正 = 壊れていた機能が正しく動作するようになったこと
• 「更新」は使わないでください。意味が曖昧です。改善なのか修正なのかを明確にしてください。

バージョン番号

セマンティックバージョニング（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  or  2026.02.08  or  February 8, 2026

継続的デプロイを行う SaaS プロダクトに最適です。

変更履歴ページの構成

# Changelog

## February 8, 2026

### New
- **Bulk Export for Reports** — Export up to 10,000 rows at once. [Learn more →](link)
- **Dark Mode** — Toggle dark mode from Settings > Appearance.

### Improved
- **Dashboard Loading** — Dashboards now load 3x faster on large datasets.
- **Search** — Search results now include archived items.

### Fixed
- Fixed an issue where exported CSV files had missing column headers.
- Fixed a bug where the date picker showed incorrect timezone.

---

## February 1, 2026

### New
- **API Webhooks** — Get notified when events happen in your account.

### Fixed
- Fixed an issue where email notifications were delayed by up to 2 hours.

ビジュアル付きの変更履歴

ビジュアルを追加する場合

変更の種類	ビジュアル
新しい UI 機能	新機能のスクリーンショット
UI の再設計	変更前／変更後の比較
新しいワークフロー	手順ごとのスクリーンショットまたは短い動画
パフォーマンスの改善	改善を示すグラフ
複雑な機能	アニメーション GIF または動画デモ

ビジュアルの作成

# Feature screenshot (if you have the app running, use agent browser)
belt app run infsh/agent-browser --input '{
  "url": "https://your-app.com/new-feature",
  "action": "screenshot"
}'

# Before/after comparison
belt app run infsh/stitch-images --input '{
  "images": ["before-screenshot.png", "after-screenshot.png"],
  "direction": "horizontal"
}'

# Annotated screenshot with callout
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"
}'

# Feature announcement banner
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
}'

破壊的変更

破壊的変更には特別な対応が必要です。

### ⚠️ Breaking: API v2 Endpoints Deprecated

**What changed:** API v1 endpoints will stop working on March 15, 2026.

**What you need to do:**
1. Update your API calls to use v2 endpoints ([migration guide →](link))
2. Update authentication to use Bearer tokens instead of API keys
3. Test your integration before March 15

**Timeline:**
- Now: v2 endpoints available, v1 still works
- March 1: v1 returns deprecation warnings
- March 15: v1 stops working

If you need help migrating, contact [email protected].

配信チャネル

チャネル	形式	タイミング
変更履歴ページ	詳細な内容、すべてのエントリー	リリースごと
アプリ内通知	1～2 行の要約	新機能、破壊的変更
メール	厳選した注目点、ビジュアル	メジャーリリース（月次／四半期ごと）
ブログ記事	背景を含む詳細な解説	大規模なローンチ
ソーシャルメディア	1 つの機能を取り上げる	注目すべき機能
Slack／Discord	簡潔なお知らせ	コミュニティがある場合

ソーシャルメディア投稿の形式

🆕 New in [Product]: [Feature Name]

[1-2 sentence description of what you can now do]

[Screenshot or demo video]

Try it now → [link]

執筆のヒント

すること

• 関連する変更をまとめる
• 最も重要な変更や要望の多い変更から始める
• 複雑な機能についてはドキュメントへのリンクを掲載する
• 要望した人を記載する（「多くのご要望にお応えして：」）
• 破壊的変更の移行方法を示す
• すべてのエントリーに日付を付ける

しないこと

• 「さまざまなバグを修正しました」と書かないでください。修正内容を具体的に挙げるか、省略してください
• 内部参照（PR 番号、チケット ID、ブランチ名）を含めないでください
• どのように更新されたか説明せずに「[機能]を更新しました」と書かないでください
• 誰も気にしない変更（依存関係の更新、内部リファクタリング）を列挙しないでください
• コミットをそのまま羅列しないでください。1 つの変更履歴エントリーが多数のコミットを表すこともあります

変更履歴の更新頻度

製品タイプ	頻度	備考
SaaS（継続的デプロイ）	週次でまとめて更新	1週間分の変更をまとめます
SaaS（主要機能）	機能のリリースごと	ブログ記事を添えます
バージョン管理されたソフトウェア	バージョンのリリースごと	セマンティックバージョニングに合わせます
API	バージョンごと＋廃止告知	移行ガイドを含めます
モバイルアプリ	アプリストアでのリリースごと	ストア掲載情報の「新機能」に合わせます

よくある間違い

間違い	問題	対処法
開発者向けの言葉を使う	ユーザーに理解されません	ユーザーに何ができるかを書きます
「バグ修正と改善」	情報がまったくありません	具体的な修正内容を列挙します
日付がない	何が新しいのか判断できません	各項目に日付を付けます
ビジュアルがない	ユーザーが文章を読み飛ばします	主要機能のスクリーンショットを掲載します
破壊的変更が目立たない	ユーザーが気づくのが遅れます	目立つ警告とタイムラインを示します
コミットログを変更履歴として使う	情報が雑然として役に立ちません	内容を選別して書き直します

関連スキル

npx skills add inference-sh/skills@ai-image-generation
npx skills add inference-sh/skills@prompt-engineering

すべてのアプリを見る：belt app list