指南回顾
从 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 | 同时 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 步之间插入：
-
显示候选亮点及评分：
Highlights (by score): [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 质量清单
链接：
| 格式 | 链接目标 |
|---|---|
| 落地页 URL | |
| GitHub 仓库 URL | |
| Newsletter | 两者（落地页 + GitHub） |
| Slack | GitHub 仓库 URL |
URL：
- 落地页：
https://florianbruniaux.github.io/Codex-ultimate-guide-landing/ - GitHub：
https://github.com/FlorianBruniaux/Codex-ultimate-guide
第 7 步：输出
以代码块形式显示每个生成的帖子，标明格式和语言：
## LinkedIn (FR)
```text
[content]
`` `
## LinkedIn (EN)
```text
[content]
`` `
## Twitter/X (FR)
```text
[content]
`` `
...
如果使用 --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） |