release-prep
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseRelease Prep Skill
Release Prep 技能
This skill automates release preparation for MassGen, generating CHANGELOG entries, announcement text, and validating documentation.
本技能可自动完成MassGen的发布准备工作，生成CHANGELOG条目、公告文本并验证文档。
When to Use
使用时机
Run this skill when preparing a new release:
- After merging the release PR to main
- Before creating the git tag
在准备新版本时运行本技能：
- 将发布PR合并到main分支后
- 创建git标签前
Usage
使用方法
/release-prep v0.1.34/release-prep v0.1.34What This Skill Does
本技能的功能
1. Gather Changes
1. 收集变更信息
Read commits and PRs since the last tag:
bash
undefined读取上一标签后的提交记录与PR：
bash
undefinedGet last tag
获取最新标签
git describe --tags --abbrev=0
git describe --tags --abbrev=0
Get commits since last tag
获取最新标签后的提交记录
git log v0.1.33..HEAD --oneline
git log v0.1.33..HEAD --oneline
Get merged PRs (if using GitHub)
获取已合并的PR（若使用GitHub）
gh pr list --base main --state merged --search "merged:>2024-01-01"
undefinedgh pr list --base main --state merged --search "merged:>2024-01-01"
undefined2. Archive Previous Announcement
2. 归档上一版本公告
If exists:
docs/announcements/current-release.mdbash
undefined若存在：
docs/announcements/current-release.mdbash
undefinedExtract version from current-release.md
从current-release.md中提取版本号
VERSION=$(grep -m1 "^# MassGen v" docs/announcements/current-release.md | sed 's/# MassGen v([^ ])./\1/')
VERSION=$(grep -m1 "^# MassGen v" docs/announcements/current-release.md | sed 's/# MassGen v([^ ])./\1/')
Archive it
归档文件
mv docs/announcements/current-release.md docs/announcements/archive/v${VERSION}.md
undefinedmv docs/announcements/current-release.md docs/announcements/archive/v${VERSION}.md
undefined3. Generate CHANGELOG Entry
3. 生成CHANGELOG条目
Update the Recent Releases section at the top of :
CHANGELOG.md- Add the new release summary at the top
- Keep only the 3 newest releases in this section
- Remove older entries (they remain in the detailed changelog below)
Create a structured entry following Keep a Changelog format:
markdown
undefined更新CHANGELOG.md顶部的「近期发布」板块：
- 在顶部添加新版本摘要
- 该板块仅保留最新3个版本的内容
- 旧版本条目移至下方详细变更记录中
按照Keep a Changelog格式创建结构化条目：
markdown
undefined[0.1.34] - YYYY-MM-DD
[0.1.34] - YYYY-MM-DD
Added
新增
- Feature Name: Description
- Implementation details
- 功能名称：功能描述
- 实现细节
Changed
变更
- Modified Feature: What changed
- 修改功能：变更内容
Fixed
修复
- Bug #123: Description of fix
- Bug #123：修复描述
Documentations, Configurations and Resources
文档、配置与资源
- Feature Guide: New for feature usage
docs/source/user_guide/feature.rst - Design Document: New for implementation details
docs/dev_notes/feature_design.md - Updated Docs: Updated with new commands
docs/source/reference/cli.rst - Skills: New for automation
massgen/skills/skill-name/SKILL.md
**Documentation section rules:**
- Reference specific file paths (`.rst`, `.md`, `.yaml` files)
- Use "New" for newly added files, "Updated" for modified files
- Run `git diff <last-tag>..HEAD --name-only -- "*.md" "*.rst" "*.yaml"` to find changed docs
**Categorization rules:**
- `feat:` commits → Added
- `fix:` commits → Fixed
- `docs:` commits → Documentation
- `refactor:`, `perf:` commits → Changed
- Breaking changes → highlight with ⚠️
**Contributors:**
- Run `git shortlog -sn <last-tag>..HEAD` to find all contributors
- List contributors by commit count in the Technical Details section- 功能指南：新增，介绍功能使用方法
docs/source/user_guide/feature.rst - 设计文档：新增，说明实现细节
docs/dev_notes/feature_design.md - 文档更新：更新，添加新命令
docs/source/reference/cli.rst - 技能：新增，用于自动化流程
massgen/skills/skill-name/SKILL.md
**文档板块规则**：
- 引用具体文件路径（`.rst`、`.md`、`.yaml`文件）
- 新增文件标注「新增」，修改文件标注「更新」
- 执行`git diff <last-tag>..HEAD --name-only -- "*.md" "*.rst" "*.yaml"`查找变更的文档
**分类规则**：
- `feat:`开头的提交 → 新增
- `fix:`开头的提交 → 修复
- `docs:`开头的提交 → 文档
- `refactor:`、`perf:`开头的提交 → 变更
- 破坏性变更 → 用⚠️高亮显示
**贡献者**：
- 执行`git shortlog -sn <last-tag>..HEAD`查找所有贡献者
- 在技术细节板块按提交次数列出贡献者4. Update Sphinx Documentation
4. 更新Sphinx文档
Update Recent Releases section:
docs/source/index.rstbash
undefined更新的「近期发布」板块：
docs/source/index.rstbash
undefinedUpdate Recent Releases section (keep latest 3 releases)
更新近期发布板块（保留最新3个版本）
Add new release at top, remove oldest (v0.1.X-3)
在顶部添加新版本，移除最旧的版本（v0.1.X-3）
**Format:**
```rst
Recent Releases
---------------
**v0.1.44 (January 28, 2026)** - Execute Mode for Independent Plan Selection
New Execute mode for cycling through Normal → Planning → Execute modes via ``Shift+Tab``. Users can independently browse and select from existing plans with a plan selector popover. Context paths preserved between planning and execution phases. Enhanced case studies page with setup guides and quick start instructions.
**v0.1.43 (January 26, 2026)** - Tool Call Batching & Interactive Case Studies
...
**v0.1.42 (January 23, 2026)** - TUI Visual Redesign
...Keep only the 3 most recent releases in this section. Older releases remain in the full changelog.
**格式示例**：
```rst
Recent Releases
---------------
**v0.1.44 (2026年1月28日)** - 独立计划选择的执行模式
新增执行模式，可通过``Shift+Tab``在普通→规划→执行模式间切换。用户可通过计划选择器弹窗独立浏览并选择现有计划，规划与执行阶段的上下文路径将被保留。案例研究页面新增设置指南与快速入门说明。
**v0.1.43 (2026年1月26日)** - 工具调用批量处理与交互式案例研究
...
**v0.1.42 (2026年1月23日)** - TUI视觉重设计
...该板块仅保留最新3个版本，旧版本内容仍保留在完整变更记录中。
5. Update Configs Documentation
5. 更新配置文档
Update Release History section:
massgen/configs/README.mdmarkdown
undefined更新的「发布历史」板块：
massgen/configs/README.mdmarkdown
undefinedRelease History & Examples
发布历史与示例
v0.1.44 - Latest
v0.1.44 - 最新版本
New Features: Execute Mode for Independent Plan Selection, Case Studies UX Enhancements
Key Features:
- Execute Mode Cycling: Navigate through Normal → Planning → Execute modes via
Shift+Tab - Plan Selector Popover: Browse and select from up to 10 recent plans with timestamps
- Context Path Preservation: Context paths automatically preserved between planning and execution
- Enhanced Case Studies: Setup guides and quick start instructions on case studies page
Example Usage:
bash
undefined新增功能：独立计划选择的执行模式、案例研究用户体验优化
核心功能：
- 执行模式切换：通过在普通→规划→执行模式间切换
Shift+Tab - 计划选择器弹窗：浏览最多10个带时间戳的近期计划
- 上下文路径保留：规划与执行阶段的上下文路径自动保留
- 增强型案例研究：案例研究页面新增设置指南与快速入门说明
使用示例：
bash
undefinedUse the TUI with plan mode cycling
使用支持计划模式切换的TUI
massgen --config @examples/basic/multi/three_agents_default
massgen --config @examples/basic/multi/three_agents_default
In the TUI:
在TUI中：
1. Press Shift+Tab to enter Planning mode
1. 按Shift+Tab进入规划模式
2. Create a plan: "Create a Python web scraper for news articles"
2. 创建计划："创建一个用于新闻文章的Python网络爬虫"
3. Press Shift+Tab twice to enter Execute mode
3. 按两次Shift+Tab进入执行模式
4. Select your plan from the popover and press Enter to execute
4. 在弹窗中选择计划并按Enter执行
undefinedundefined6. Update README.md
6. 更新README.md
6.1 Latest Features Section
6.1 最新功能板块
Update the "🆕 Latest Features" section:
markdown
undefined更新「🆕 最新功能」板块：
markdown
undefined🆕 Latest Features (v0.1.44)
🆕 最新功能 (v0.1.44)
🎉 Released: January 28, 2026
What's New in v0.1.44:
- 🔄 Execute Mode - Cycle through Normal → Planning → Execute modes via to independently browse and execute existing plans
Shift+Tab - 📋 Plan Selector - Browse up to 10 recent plans with timestamps, view full task breakdowns, and execute with preserved context paths
- 📚 Enhanced Case Studies - Interactive setup guides and quick start instructions on case studies page
- ⚡ TUI Performance - Optimized timeline rendering with viewport-based scrolling for faster UI responsiveness
- 🔧 Plan Mode Fixes - Fixed planning instruction injection bug in execute mode, improved tool tracking
Try v0.1.44 Features:
bash
undefined🎉 发布时间：2026年1月28日
v0.1.44更新内容：
- 🔄 执行模式 - 通过在普通→规划→执行模式间切换，独立浏览并执行现有计划
Shift+Tab - 📋 计划选择器 - 浏览最多10个带时间戳的近期计划，查看完整任务分解，保留上下文路径执行
- 📚 增强型案例研究 - 案例研究页面新增交互式设置指南与快速入门说明
- ⚡ TUI性能优化 - 基于视口的滚动优化时间线渲染，提升UI响应速度
- 🔧 计划模式修复 - 修复执行模式下的规划指令注入Bug，改进工具跟踪
体验v0.1.44新功能：
bash
undefinedInstall or upgrade
安装或升级
pip install --upgrade massgen
pip install --upgrade massgen
Experience Execute mode with plan cycling
体验带计划切换的执行模式
uv run massgen --display textual
uv run massgen --display textual
In the TUI:
在TUI中：
1. Press Shift+Tab to enter Planning mode
1. 按Shift+Tab进入规划模式
2. Create a plan: "Build a Python web scraper"
2. 创建计划："构建一个Python网络爬虫"
3. Press Shift+Tab twice to enter Execute mode
3. 按两次Shift+Tab进入执行模式
4. Select your plan and press Enter to execute
4. 选择计划并按Enter执行
undefinedAlso update the table of contents link from v0.1.43 → v0.1.44.
undefined同时更新目录链接，将v0.1.43替换为v0.1.44。
6.2 Recent Achievements Section
6.2 近期成果板块
Move the current "Recent Achievements" to "Previous Achievements" and add new release:
markdown
undefined将当前「近期成果」移至「过往成果」，并添加新版本内容：
markdown
undefinedRecent Achievements (v0.1.44)
近期成果 (v0.1.44)
🎉 Released: January 28, 2026
🎉 发布时间：2026年1月28日
Execute Mode for Independent Plan Selection
独立计划选择的执行模式
- Mode Cycling: Navigate through Normal → Planning → Execute modes via or mode bar click
Shift+Tab - Plan Selector Popover: Browse up to 10 recent plans with timestamps and original prompts
- View Full Plan: Modal displays complete task breakdown from selected plan
- Empty Submission: Press Enter to execute selected plan without additional input
- Context Path Preservation: Context paths () automatically restored from planning to execution phase
@/path/to/file
...
- 模式切换：通过或点击模式栏在普通→规划→执行模式间切换
Shift+Tab - 计划选择器弹窗：浏览最多10个带时间戳与原始提示的近期计划
- 查看完整计划：弹窗显示所选计划的完整任务分解
- 空提交执行：按Enter直接执行所选计划，无需额外输入
- 上下文路径保留：规划阶段的上下文路径（）在执行阶段自动恢复
@/path/to/file
...
Previous Achievements (v0.0.3 - v0.1.43)
过往成果 (v0.0.3 - v0.1.43)
✅ Tool Call Batching & Interactive Case Studies (v0.1.43): Consecutive MCP tool calls grouped into collapsible tree views...
Also update roadmap TOC links:
- `[Recent Achievements (v0.1.43)]` → `[Recent Achievements (v0.1.44)]`
- `[Previous Achievements (v0.0.3 - v0.1.42)]` → `[Previous Achievements (v0.0.3 - v0.1.43)]`
- `[v0.1.44 Roadmap]` → `[v0.1.45 Roadmap]`
Update the roadmap section at bottom to reference next version (v0.1.45).✅ 工具调用批量处理与交互式案例研究 (v0.1.43)：连续MCP工具调用分组为可折叠树形视图...
同时更新路线图目录链接：
- `[近期成果 (v0.1.43)]` → `[近期成果 (v0.1.44)]`
- `[过往成果 (v0.0.3 - v0.1.42)]` → `[过往成果 (v0.0.3 - v0.1.43)]`
- `[v0.1.44 路线图]` → `[v0.1.45 路线图]`
更新底部路线图板块，引用下一版本（v0.1.45）。7. Update ROADMAP.md
7. 更新ROADMAP.md
Update the main roadmap file:
更新主路线图文件：
7.1 Version and Date
7.1 版本与日期
markdown
**Current Version:** v0.1.44
**Last Updated:** January 28, 2026markdown
**当前版本：** v0.1.44
**最后更新：** 2026年1月28日7.2 Release Table
7.2 发布表格
Shift all releases down and add new next release:
markdown
| Release | Target | Feature | Owner | Use Case |
|---------|--------|---------|-------|----------|
| **v0.1.45** | 01/30/26 | Improve Subagent Display in TUI | @ncrispino | Stream and view subagents with full timeline in TUI ([#821](...)) |
| **v0.1.46** | 02/02/26 | Next feature | @owner | Use case |将所有发布条目下移，添加新的下一版本：
markdown
| 版本 | 目标日期 | 功能 | 负责人 | 使用场景 |
|---------|--------|---------|-------|----------|
| **v0.1.45** | 2026/01/30 | 优化TUI中的子Agent显示 | @ncrispino | 在TUI中流式查看子Agent与完整时间线 ([#821](...)) |
| **v0.1.46** | 2026/02/02 | 下一功能 | @owner | 使用场景 |7.3 Add Completed Section
7.3 添加已完成板块
Add the just-released version as COMPLETED:
markdown
undefined将刚发布的版本标记为已完成：
markdown
undefined✅ v0.1.44 - Execute Mode & Case Studies Enhancement (COMPLETED)
✅ v0.1.44 - 执行模式与案例研究增强（已完成）
Released: January 28, 2026
发布时间：2026年1月28日
Features
功能
- Execute Mode: Independent mode for browsing and executing existing plans (#819)
- Cycle through Normal → Planning → Execute modes via
Shift+Tab - Plan selector popover shows up to 10 recent plans with timestamps
- "View Full Plan" button opens modal with all tasks
- Empty submission executes selected plan
- Context paths preserved from planning to execution phase
- Cycle through Normal → Planning → Execute modes via
...
- 执行模式：独立浏览与执行现有计划的模式 (#819)
- 通过在普通→规划→执行模式间切换
Shift+Tab - 计划选择器弹窗显示最多10个带时间戳的近期计划
- 「查看完整计划」按钮打开显示所有任务的弹窗
- 空提交可直接执行所选计划
- 规划与执行阶段的上下文路径自动保留
- 通过
...
Bug Fixes
Bug修复
- Fixed planning instruction injection during execute mode
- Improved tool call spacing in TUI
- Enhanced timeline performance with viewport optimization
undefined- 修复执行模式下的规划指令注入问题
- 优化TUI中的工具调用间距
- 基于视口优化时间线性能
undefined7.4 Update Next Release Section
7.4 更新下一版本板块
Change the header for the upcoming release:
markdown
undefined更新即将发布版本的标题：
markdown
undefined📋 v0.1.45 - Improve Subagent Display in TUI
📋 v0.1.45 - 优化TUI中的子Agent显示
Features
功能
1. Subagent TUI Streaming (@ncrispino)
- Issue: #821
- Stream and display subagents almost identically to main process in TUI ...
undefined1. 子Agent TUI流式显示 (@ncrispino)
- 问题：#821
- 在TUI中以与主进程几乎相同的方式流式显示子Agent...
undefined8. Create Next Release Roadmap
8. 创建下一版本路线图
Create with detailed milestones:
ROADMAP_v0.1.X+1.mdmarkdown
undefined创建，包含详细里程碑：
ROADMAP_v0.1.X+1.mdmarkdown
undefinedMassGen v0.1.45 Roadmap
MassGen v0.1.45 路线图
Overview
概述
Version 0.1.45 focuses on [MAIN THEME].
- Feature 1 (Required): Description
- Feature 2 (Required): Description
v0.1.45版本聚焦于[核心主题]。
- 功能1（必填）：功能描述
- 功能2（必填）：功能描述
Key Technical Priorities
核心技术优先级
-
Feature 1: Details Use Case: Why this matters
-
Feature 2: Details Use Case: Why this matters
-
功能1：细节说明 使用场景：该功能的价值
-
功能2：细节说明 使用场景：该功能的价值
Key Milestones
核心里程碑
Milestone 1: [Feature Name] (REQUIRED)
里程碑1：[功能名称]（必填）
Goal: What we're building
Owner: @username (discord)
Issue: #XXX
目标：要实现的内容
负责人：@username (discord)
问题链接：#XXX
1.1 Research & Design
1.1 调研与设计
- Task 1
- Task 2
- 任务1
- 任务2
1.2 Implementation
1.2 实现
- Task 1
- Task 2
...
Success Criteria:
- Criteria 1
- Criteria 2
Look at the GitHub issues, especially those tagged with the next milestone, to populate the roadmap.- 任务1
- 任务2
...
成功标准:
- 标准1
- 标准2
可参考GitHub issues，尤其是标记了下一里程碑的问题来填充路线图。9. Build Sphinx Documentation
9. 构建Sphinx文档
Build and verify the Sphinx docs:
bash
cd docs
make clean
make htmlCheck for:
- ❌ No build errors
- ❌ No broken links
- ⚠️ Minimal warnings (document unavoidable ones)
- ✅ New content renders correctly
Optional: Run link checker:
bash
cd docs
make linkcheck构建并验证Sphinx文档：
bash
cd docs
make clean
make html检查内容：
- ❌ 无构建错误
- ❌ 无失效链接
- ⚠️ 警告最少（记录无法避免的警告）
- ✅ 新内容渲染正常
可选：运行链接检查器：
bash
cd docs
make linkcheck10. Write Release Notes
10. 撰写发布说明
Create following the established format from previous releases.
RELEASE_NOTES_v0.1.X.mdFormat reference: Check the previous release on GitHub:
bash
gh release view v0.1.43Template structure:
markdown
undefined按照过往版本的格式创建。
RELEASE_NOTES_v0.1.X.md格式参考：查看GitHub上的上一版本：
bash
gh release view v0.1.43模板结构：
markdown
undefined🚀 Release Highlights — v0.1.X (YYYY-MM-DD)
🚀 发布亮点 — v0.1.X (YYYY-MM-DD)
🎯 功能名称
- Bullet Point: Description
- Bullet Point: Description
- 要点：功能描述
- 要点：功能描述
- Bullet Point: Description
- 要点：功能描述
🔧 Bug Fixes
🔧 Bug修复
- Fix Description: What was fixed
- 修复内容：修复的问题
📖 Getting Started
📖 快速开始
- Quick Start Guide: Try the new features today
- Try Feature Name:
bash
undefined- 快速入门指南：立即体验新功能
- 体验功能名称:
bash
undefinedExample command showing the new feature
示例命令展示新功能
uv run massgen [example command]
undefineduv run massgen [示例命令]
undefinedWhat's Changed
变更内容
- PR title by @author in PR_URL
- PR title by @author in PR_URL
Full Changelog: https://github.com/massgen/MassGen/compare/v0.1.X-1...v0.1.X
**Get PRs for What's Changed:**
```bash
gh pr list --base dev/v0.1.X --state merged --json number,title,url,author \
| jq -r '.[] | "* \(.title) by @\(.author.login) in \(.url)"'Important:
- Use emoji section headers (🚀 🔄 📚 ⚡ 🔧 📖)
- Link feature names to relevant docs (verify links are accurate!)
- Include practical example commands
- List all merged PRs in "What's Changed"
- Add "Full Changelog" comparison link
- PR标题 by @author in PR_URL
- PR标题 by @author in PR_URL
**获取「变更内容」的PR列表**：
```bash
gh pr list --base dev/v0.1.X --state merged --json number,title,url,author \
| jq -r '.[] | "* \(.title) by @\(.author.login) in \(.url)"'注意事项：
- 使用表情符号作为板块标题（🚀 🔄 📚 ⚡ 🔧 📖）
- 功能名称链接到对应文档（验证链接准确性！）
- 包含实用的示例命令
- 在「变更内容」中列出所有已合并的PR
- 添加「完整变更记录」的对比链接
11. Generate Announcement
11. 生成公告
Create :
docs/announcements/current-release.mdmarkdown
undefined创建：
docs/announcements/current-release.mdmarkdown
undefinedMassGen vX.X.X Release Announcement
MassGen vX.X.X 发布公告
Release Summary
发布摘要
We're excited to release MassGen vX.X.X, adding [MAIN FEATURE]! 🚀
[2-3 sentences describing the key changes]
我们很高兴发布MassGen vX.X.X，新增[核心功能]！ 🚀
[2-3句话描述关键变更]
Install
安装
```bash
pip install massgen==X.X.X
```
bash
pip install massgen==X.X.XLinks
链接
- Release notes: https://github.com/massgen/MassGen/releases/tag/vX.X.X
- X post: [TO BE ADDED AFTER POSTING]
- LinkedIn post: [TO BE ADDED AFTER POSTING]
undefined- 发布说明：https://github.com/massgen/MassGen/releases/tag/vX.X.X
- X平台帖子：[发布后更新链接]
- LinkedIn帖子：[发布后更新链接]
undefined12. Validate Documentation
12. 验证文档
Check that required documentation exists:
bash
undefined检查所需文档是否存在：
bash
undefinedCheck for user guide updates (if new features)
检查用户指南是否更新（若有新功能）
ls docs/source/user_guide/
ls docs/source/user_guide/
Check capabilities.py updated (if new models)
检查capabilities.py是否更新（若有新模型）
git diff v0.1.33..HEAD -- massgen/backend/capabilities.py
git diff v0.1.33..HEAD -- massgen/backend/capabilities.py
Check token_manager.py (if pricing changes)
检查token_manager.py是否更新（若有定价变更）
git diff v0.1.33..HEAD -- massgen/token_manager/token_manager.py
git diff v0.1.33..HEAD -- massgen/token_manager/token_manager.py
Check for case study
检查是否有案例研究
ls docs/source/examples/case_studies/
undefinedls docs/source/examples/case_studies/
undefined13. Character Count Check
13. 字符数检查
Verify announcement fits LinkedIn's ~3000 char limit:
bash
undefined验证公告是否符合LinkedIn的约3000字符限制：
bash
undefinedCount characters
统计字符数
cat docs/announcements/current-release.md docs/announcements/feature-highlights.md | wc -m
cat docs/announcements/current-release.md docs/announcements/feature-highlights.md | wc -m
Should be < 3000
字符数应 < 3000
undefinedundefined14. Suggest Screenshot/Media
14. 截图/媒体建议
Based on the changes in this release, suggest what screenshot or GIF to capture:
Feature-to-Screenshot Mapping:
| Change Type | Screenshot Suggestion |
|---|---|
| New backend/model support | Terminal showing agent using new model with successful response |
| Multi-agent coordination | Multiple agents working in parallel with colored output |
| Voting/consensus | Voting phase with agent decisions and final selection |
| MCP tools | Tool execution with visible results (file ops, search, etc.) |
| Context compression | Log output showing compression stats and message counts |
| Memory/persistence | Agent recalling context from previous session |
| Web UI changes | Dashboard with agent activity or new UI feature |
| Cost tracking | Summary showing token usage and costs per agent |
| Error handling | Agent gracefully recovering from failure |
| Performance improvements | Before/after timing or throughput comparison |
| New config options | YAML config snippet with new options highlighted |
Analysis approach:
- Look at the main features from commits
- Identify the most visually compelling change
- Suggest specific command to run that demonstrates the feature
- Note if a GIF (via VHS) would be better than a static screenshot
Example output:
undefined基于本次版本的变更，建议捕获的截图或GIF：
功能与截图对应表：
| 变更类型 | 截图建议 |
|---|---|
| 新增后端/模型支持 | 终端显示Agent使用新模型并返回成功响应 |
| 多Agent协作 | 多个Agent并行工作的彩色输出 |
| 投票/共识 | 投票阶段的Agent决策与最终选择 |
| MCP工具 | 工具执行结果（文件操作、搜索等） |
| 上下文压缩 | 显示压缩统计与消息数量的日志输出 |
| 记忆/持久化 | Agent回忆上一会话的上下文 |
| Web UI变更 | 显示Agent活动或新UI功能的仪表盘 |
| 成本跟踪 | 显示每个Agent的令牌使用量与成本的摘要 |
| 错误处理 | Agent从故障中优雅恢复 |
| 性能优化 | 前后对比的时间或吞吐量数据 |
| 新增配置选项 | 高亮新选项的YAML配置片段 |
分析方法：
- 查看提交记录中的核心功能
- 识别最具视觉吸引力的变更
- 建议可演示该功能的具体命令
- 说明是否需要GIF（通过VHS录制）而非静态截图
示例输出：
undefined📸 Suggested Screenshot for v0.1.34
📸 v0.1.34版本截图建议
Based on this release's changes, recommend capturing:
Primary: GPT-5 model support
- Run:
massgen --config massgen/configs/providers/openai/gpt5_demo.yaml "Explain quantum computing" - Capture: Terminal showing GPT-5 model name in agent output with response
Alternative: Context compression improvements
- Run:
massgen --automation --config [long-context-config] "question" | grep compression - Capture: Log output showing reduced token counts
Media type: Static screenshot is fine (no complex animation needed)
undefined基于本次版本变更，建议捕获：
首选：GPT-5模型支持
- 运行命令：
massgen --config massgen/configs/providers/openai/gpt5_demo.yaml "解释量子计算" - 捕获内容：终端显示GPT-5模型名称与响应结果
备选：上下文压缩优化
- 运行命令：
massgen --automation --config [长上下文配置] "问题" | grep compression - 捕获内容：显示令牌数量减少的日志输出
媒体类型：静态截图即可（无需复杂动画）
undefined15. Output Summary
15. 输出摘要
Print a checklist:
undefined打印检查清单：
undefinedRelease Prep Summary for v0.1.34
v0.1.34版本发布准备摘要
✅ Archived previous announcement → archive/v0.1.33.md
✅ Updated CHANGELOG.md with v0.1.34 entry
✅ Updated docs/source/index.rst Recent Releases
✅ Updated massgen/configs/README.md Release History
✅ Updated README.md Latest Features section
✅ Updated README.md Recent Achievements section
✅ Updated ROADMAP.md (current version, release table, completed section)
✅ Created ROADMAP_v0.1.35.md for next release
✅ Built Sphinx documentation successfully
✅ Created current-release.md
✅ Character count: 2847/3000
✅ 已归档上一版本公告 → archive/v0.1.33.md
✅ 已更新CHANGELOG.md的v0.1.34条目
✅ 已更新docs/source/index.rst的近期发布板块
✅ 已更新massgen/configs/README.md的发布历史
✅ 已更新README.md的最新功能板块
✅ 已更新README.md的近期成果板块
✅ 已更新ROADMAP.md（当前版本、发布表格、已完成板块）
✅ 已创建下一版本路线图ROADMAP_v0.1.35.md
✅ 已成功构建Sphinx文档
✅ 已创建current-release.md
✅ 字符数：2847/3000
Manual Steps Remaining:
剩余手动步骤：
- Review all updated files for accuracy
- Capture suggested screenshot (see below)
- Stage and commit changes
- Push and create PR to main
- After merge: Create tag (git tag v0.1.34 && git push origin v0.1.34)
- Publish GitHub Release (triggers PyPI publish)
- Post to LinkedIn/X with screenshot, update links in current-release.md
- 审核所有更新文件的准确性
- 捕获建议的截图（见下方）
- 暂存并提交变更
- 推送并创建合并到main分支的PR
- 合并后：创建标签（git tag v0.1.34 && git push origin v0.1.34）
- 发布GitHub Release（触发PyPI发布）
- 发布LinkedIn/X帖子并更新current-release.md中的链接
📸 Screenshot Suggestion:
📸 截图建议：
[Feature-specific suggestion based on changes]
[基于变更内容的功能特定建议]
Validation Warnings:
验证警告：
⚠️ No case study found for this release
⚠️ capabilities.py was modified - verify docs updated
⚠️ README_PYPI.md will auto-sync via pre-commit hook
undefined⚠️ 未找到本次版本的案例研究
⚠️ capabilities.py已修改 - 请验证文档是否更新
⚠️ README_PYPI.md将通过pre-commit钩子自动同步
undefinedReference Files
参考文件
Documentation Files
文档文件
- CHANGELOG: - Complete release history
CHANGELOG.md - Sphinx docs homepage: - Recent Releases section
docs/source/index.rst - Configs README: - Release History & Examples
massgen/configs/README.md - Main README: - Latest Features and Recent Achievements
README.md - Main Roadmap: - Current version, release table, completed releases
ROADMAP.md - Next Release Roadmap: - Detailed milestones for next version
ROADMAP_v0.1.X+1.md
- CHANGELOG：- 完整发布历史
CHANGELOG.md - Sphinx文档首页：- 近期发布板块
docs/source/index.rst - 配置README：- 发布历史与示例
massgen/configs/README.md - 主README：- 最新功能与近期成果
README.md - 主路线图：- 当前版本、发布表格、已完成版本
ROADMAP.md - 下一版本路线图：- 下一版本的详细里程碑
ROADMAP_v0.1.X+1.md
Announcement Files
公告文件
- Announcement directory:
docs/announcements/ - Current release:
docs/announcements/current-release.md - Feature highlights:
docs/announcements/feature-highlights.md - Archive: - Past releases
docs/announcements/archive/
- 公告目录：
docs/announcements/ - 当前版本公告：
docs/announcements/current-release.md - 功能亮点：
docs/announcements/feature-highlights.md - 归档：- 过往版本公告
docs/announcements/archive/
Process Documentation
流程文档
- Release checklist: - Complete step-by-step guide
docs/dev_notes/release_checklist.md - README sync: - Auto-synced via pre-commit hook
README_PYPI.md
- 发布检查清单：- 完整分步指南
docs/dev_notes/release_checklist.md - README同步：- 通过pre-commit钩子自动同步
README_PYPI.md
Tips
提示
- Run this skill on the release branch (e.g., ) before creating the PR
dev/v0.1.44 - Always review all generated content for accuracy before committing
- Update if this release adds major new capabilities
feature-highlights.md - After posting to social media, update the links in
current-release.md - README_PYPI.md syncs automatically via pre-commit hook - just commit README.md changes
- Keep Recent Releases sections to 3 entries max (Sphinx docs, CHANGELOG top section)
- Use GitHub issue numbers in roadmap updates for traceability
- Build Sphinx docs () to catch formatting issues early
cd docs && make html
- 在创建PR前，在发布分支（如）运行本技能
dev/v0.1.44 - 提交前务必审核所有生成内容的准确性
- 若本次版本新增核心功能，更新
feature-highlights.md - 发布社交媒体帖子后，更新current-release.md中的链接
- README_PYPI.md通过pre-commit钩子自动同步 - 只需提交README.md的变更
- 近期发布板块最多保留3个条目（Sphinx文档、CHANGELOG顶部板块）
- 在路线图更新中使用GitHub issue编号以实现可追溯性
- 提前构建Sphinx文档（）以捕获格式问题
cd docs && make html