安裝 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 格式。
先前每次匯出僅限 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. 更新驗證方式，使用 Bearer token 取代 API 金鑰
3. 在 3 月 15 日前測試您的整合
**時間表：**
- 現在：v2 端點可用，v1 仍可運作
- 3 月 1 日：v1 開始回傳棄用警告
- 3 月 15 日：v1 停止運作
如果您在遷移時需要協助，請聯絡 [email protected]。
發布管道
| 管道 | 格式 | 時機 |
|---|---|---|
| 變更記錄頁面 | 完整細節，所有條目 | 每次發布 |
| 應用程式內通知 | 1-2 行摘要 | 新功能、重大變更 |
| 電子郵件 | 精選重點、視覺輔助 | 主要版本（每月/每季） |
| 部落格文章 | 深度解析與背景說明 | 重大發布 |
| 社群媒體 | 單一功能亮點 | 值得注意的功能 |
| Slack/Discord | 簡短公告 | 如果您有社群 |
社群媒體片段格式
🆕 [產品] 新功能：[功能名稱]
[1-2 句說明您現在可以做什麼]
[螢幕截圖或示範影片]
立即試用 → [連結]
寫作技巧
應做的事
- 將相關變更分組
- 以最大/最受要求的功能開頭
- 針對複雜功能連結至說明文件
- 提及是誰要求該功能（「應廣大要求：」）
- 針對重大變更顯示遷移路徑
- 每條條目標註日期
不應做的事
- 不要寫「各種錯誤修正」——列出特定修正，否則跳過
- 不要包含內部參考（PR 編號、工單 ID、分支名稱）
- 不要在未說明如何改變的情況下使用「已更新 [功能]」
- 不要列出沒人在意的變更（相依套件升級、內部重構）
- 不要將提交紀錄直接貼上——一條變更記錄條目可能代表多次提交
變更記錄頻率
| 產品類型 | 頻率 | 備註 |
|---|---|---|
| SaaS（持續部署） | 每週批次 | 將一週的變更分組 |
| SaaS（主要功能） | 每次功能發布 | 搭配部落格文章 |
| 版本化軟體 | 每個版本發布 | 與 semver 綁定 |
| API | 每個版本 + 棄用通知 | 包含遷移指南 |
| 行動應用 | 每次 App Store 發布 | 與商店列表中的「最新內容」對應 |
常見錯誤
| 錯誤 | 問題 | 修正 |
|---|---|---|
| 開發者語言 | 使用者看不懂 | 寫使用者能做什麼 |
| 「錯誤修正與改善」 | 零資訊 | 列出特定修正 |
| 沒有日期 | 無法知道哪些是新內容 | 每條條目標註日期 |
| 沒有視覺輔助 | 使用者跳過文字 | 為主要功能提供螢幕截圖 |
| 重大變更被埋沒 | 使用者太晚發現 | 顯眼警告 + 時間表 |
| 將提交紀錄當作變更記錄 | 雜亂、無幫助 | 整理並重寫 |
相關技能
npx skills add inference-sh/skills@ai-image-generation
npx skills add inference-sh/skills@prompt-engineering
瀏覽所有應用程式：belt app list