指南摘要
從 CHANGELOG.md 條目產生社交媒體內容。預設輸出 8 篇（4 種格式 × 2 種語言）。
何時使用
- 執行
/release後，建立社交公告 - 每週總結多個版本的更新
- 準備在 LinkedIn、Twitter/X、Newsletter 或 Slack 上發文前
使用方法
/guide-recap latest # 最新發布的版本
/guide-recap v3.20.5 # 指定版本
/guide-recap week # 本週（週一至今）
/guide-recap week 2026-01-27 # 指定週（週一至週日）
參數旗標
| 旗標 | 效果 | 預設值 |
|---|---|---|
--interactive | 引導模式：選擇切入角度、受眾、亮點 | 關閉（自動草稿） |
--format=X | 單一格式：linkedin、twitter、newsletter、slack | 全部 4 種格式 |
--lang=X | 單一語言：fr、en | 法語 + 英語 |
--save | 儲存輸出至 claudedocs/social-posts/ | 僅顯示 |
--force | 即使只有維護條目也強制產生 | 跳過低分項目 |
工作流程（7 步驟）
步驟 1：解析輸入
解析 $ARGUMENTS 以判斷模式：
| 輸入 | 模式 | 目標 |
|---|---|---|
latest | 單一版本 | [Unreleased] 後的第一個 ## [X.Y.Z] |
vX.Y.Z 或 X.Y.Z | 單一版本 | 精確匹配版本 |
week | 週範圍 | 本週週一至今 |
week YYYY-MM-DD | 週範圍 | 該週週一至週日 |
若無參數或參數無效，則顯示用法說明並結束。
步驟 2：提取 CHANGELOG 條目
從專案根目錄讀取 CHANGELOG.md。
單一版本：
- 找到符合
## [{version}]的行 - 提取直到下一個
## [行的所有內容 - 解析
### Added、### Changed、### Fixed區段
週範圍：
- 收集所有
## [X.Y.Z] - YYYY-MM-DD且日期在範圍內的條目 - 解析所有符合版本的所有區段
錯誤：找不到版本 -> 列出最近 5 個版本，建議使用 latest。
錯誤：該週無條目 -> 顯示最後一次發布的日期，建議使用該版本。
步驟 3：分類條目
為每個頂層條目（### 下的第一級項目符號）指派分類：
| 分類 | 權重 | 偵測方式 |
|---|---|---|
NEW_CONTENT | 3 | 新檔案、新區段、新圖表、新測驗題目 |
GROWTH_METRIC | 2 | 行數成長、項目數量變更 |
RESEARCH | 1 | 資源評估、外部來源整合 |
FIX | 1 | 在 ### Fixed 下的修正 |
MAINTENANCE | 0 | README 更新、徽章同步、登陸頁同步、計數更新 |
詳細分類規則請參閱 references/changelog-parsing-rules.md。
步驟 4：轉換為使用者價值
套用 references/content-transformation.md 中的對應規則：
- 技術用語 -> 使用者效益
- 提取具體數字
- 標註來源
- 將相關條目分組
根據 references/tone-guidelines.md 的 DO/DON'T 檢查清單進行驗證。
步驟 4b：互動模式（僅限 --interactive）
若設定 --interactive 旗標，則在步驟 4 和 5 之間插入：
-
顯示候選亮點及其分數：
亮點（依分數排序）： [14] 4 個新的 ASCII 圖表（16 -> 20） [NEW_CONTENT] [ 9] 30 個新的測驗題目（227 -> 257） [NEW_CONTENT] [ 6] Docker 沙箱隔離指南 [NEW_CONTENT] [ 1] README 已更新 [MAINTENANCE] -
詢問切入角度：
- 自動（最高分者作為鉤子）
- 使用者自行選擇特定條目作為鉤子
- 自訂角度（使用者提供主題）
-
詢問目標受眾：
devs（技術深度）tech-leads（影響力焦點）general（通俗語言）all（預設，平衡）
-
詢問主要亮點：
- 自動（最高分）
- 使用者從列表中選取
-
確認選擇後繼續至步驟 5。
步驟 5：評分與選取
計算每個條目的分數：
分數 = (分類權重 * 3)
+ (含有數字 * 2)
+ (提及來源 * 1)
+ (新檔案 * 1)
+ (min(影響檔案數, 3))
+ (破壞性變更 * 2)
選取分數最高的 3-4 個條目。最高分者作為鉤子行。
若所有分數 < 3：輸出「此版本不建議產生社交內容。請使用 --force 強制產生。」並結束（除非使用 --force）。
步驟 6：產生內容
針對每種要求的格式（預設：全部 4 種）和語言（預設：兩種）：
- 讀取
assets/中對應的範本 - 使用已評分和轉換後的條目填入範本欄位
- 套用 tone-guidelines.md 品質檢查清單
連結：
| 格式 | 連結目標 |
|---|---|
| 登陸頁網址 | |
| GitHub 倉庫網址 | |
| Newsletter | 兩者（登陸頁 + GitHub） |
| Slack | GitHub 倉庫網址 |
網址：
- 登陸頁：
https://florianbruniaux.github.io/Codex-ultimate-guide-landing/ - GitHub：
https://github.com/FlorianBruniaux/Codex-ultimate-guide
步驟 7：輸出
以帶標籤的程式碼區塊顯示每篇產生的貼文，並標記格式和語言：
## LinkedIn (FR)
```text
[內容]
LinkedIn (EN)
[內容]
Twitter/X (FR)
[內容]
...
若使用 `--save` 旗標：將所有輸出寫入 `claudedocs/social-posts/YYYY-MM-DD-vX.Y.Z.md`（版本）或 `claudedocs/social-posts/YYYY-MM-DD-week.md`（週）。若目錄 `claudedocs/social-posts/` 不存在則建立之。
## 錯誤處理
| 錯誤 | 回應 |
|------|------|
| 無參數 | 顯示用法說明區塊 |
| 無效參數 | 顯示用法說明區塊及範例 |
| 找不到版本 | 列出最近 5 個版本，建議使用 `latest` |
| 該週無條目 | 顯示最後一次發布的日期，建議使用該版本 |
| 所有條目皆為 MAINTENANCE（分數 0） | 「不建議產生社交內容。請使用 `--force` 覆寫。」 |
| 找不到 CHANGELOG.md | 「在專案根目錄找不到 CHANGELOG.md。」 |
## 參考檔案
- `references/tone-guidelines.md` - DO/DON'T 規則、表情符號預算、語言風格
- `references/changelog-parsing-rules.md` - CHANGELOG 格式、提取、評分演算法
- `references/content-transformation.md` - 技術用語 -> 使用者價值對應（30+ 條）
- `assets/linkedin-template.md` - 約 1300 字元，鉤子 + 項目符號 + CTA + 標籤
- `assets/twitter-template.md` - 280 字元單篇或 2-3 篇推文串
- `assets/newsletter-template.md` - 約 500 字，結構化章節
- `assets/slack-template.md` - 精簡、豐富表情符號、Slack 格式
- `examples/version-output.md` - v3.20.5 的完整輸出範例
- `examples/week-output.md` - 2026 年 1 月 27 日該週的完整輸出範例
## 提示
- 執行 `/release` 後立即執行 `/guide-recap latest` 以準備社交貼文
- 前幾次使用 `--interactive` 以了解評分邏輯
- 只需要特定輸出時，使用 `--format=linkedin --lang=fr`
- `--save` 的輸出會透過 `claudedocs/` 慣例被 gitignore 忽略
- 發佈前請務必檢視並個人化（這些是草稿，非最終文案）