路线图沟通者

路线图沟通专家 (Roadmap Communicator)

为内部和外部利益相关者创建清晰的路线图沟通文档。

使用场景

适用于：

• 构建不同格式的路线图演示文稿

• 编写利益相关者更新（董事会、工程团队、客户）

• 制作发布说明（面向用户和内部）

• 根据 git 历史记录生成变更日志

• 构建功能发布公告的结构

路线图格式

1. Now / Next / Later (现在/接下来/以后)

• 最适合不确定性较高且需要战略灵活性的场景。

• 在传达方向的同时，避免给出虚假的精确时间。

2. 时间线路线图 (Timeline roadmap)

• 最适合固定日期承诺和发布协调。

• 需要积极的风险和依赖项管理。

3. 基于主题的路线图 (Theme-based roadmap)

• 最适合以结果为导向的规划和跨团队协作。

• 按问题领域或战略目标对计划进行分组。

模板请参阅 references/roadmap-templates.md。

利益相关者更新模式

董事会 / 高管

• 以结果和风险为导向

• 侧重于战略目标的进展情况

• 突出权衡取舍 (trade-offs) 和需要决策的事项

工程团队

• 明确范围、依赖关系和执行顺序

• 状态、阻塞点及资源影响

客户

• 价值叙述和时间窗口

• 当前可用功能 vs 即将推出功能

• 明确的预期管理

可复用模板请参阅 references/communication-templates.md。

发布说明指南

面向用户的发布说明

• 以用户价值为先，而非内部实现细节。

• 按工作流或用户任务分组。

• 明确列出迁移指南/行为变更。

内部发布说明

• 包含技术细节、运维影响和已知问题。

• 记录发布计划、回滚标准和监控注意事项。

变更日志生成

使用命令：

python3 scripts/changelog_generator.py --from v1.0.0 --to HEAD

功能：

• 读取 git log 范围

• 解析 Conventional Commits 前缀

• 按类型（feat, fix, chore 等）对条目分组

• 输出 Markdown 或纯文本

功能发布公告框架

1. 问题背景
2. 变更内容
3. 核心价值（为什么重要）
4. 目标受益群体
5. 如何开始使用
6. 行动号召 (CTA) 和反馈渠道

沟通质量检查清单

• [ ] 明确针对特定受众进行了话术调整。

• [ ] 结果和权衡取舍清晰可见。

• [ ] 各文档间的术语保持一致。

• [ ] 风险和依赖项未被隐瞒。

• [ ] 明确了后续行动及负责人。