Roadmap Communicator
Create clear roadmap communication artifacts for internal and external stakeholders.
When To Use
Use this skill for:
- - Building roadmap presentations in different formats
- Writing stakeholder updates (board, engineering, customers)
- Producing release notes (user-facing and internal)
- Generating changelogs from git history
- Structuring feature announcements
Roadmap Formats
- 1. Now / Next / Later
- - Best for uncertainty and strategic flexibility.
- Communicate direction without false precision.
- 2. Timeline roadmap
- - Best for fixed-date commitments and launch coordination.
- Requires active risk and dependency management.
- 3. Theme-based roadmap
- - Best for outcome-led planning and cross-team alignment.
- Groups initiatives by problem space or strategic objective.
See references/roadmap-templates.md for templates.
Stakeholder Update Patterns
Board / Executive
- - Outcome and risk oriented
- Focus on progress against strategic goals
- Highlight trade-offs and required decisions
Engineering
- - Scope, dependencies, and sequencing clarity
- Status, blockers, and resourcing implications
Customers
- - Value narrative and timing window
- What is available now vs upcoming
- Clear expectation setting
See references/communication-templates.md for reusable templates.
Release Notes Guidance
User-Facing Release Notes
- - Lead with user value, not internal implementation details.
- Group by workflows or user jobs.
- Include migration/behavior changes explicitly.
Internal Release Notes
- - Include technical details, operational impact, and known issues.
- Capture rollout plan, rollback criteria, and monitoring notes.
Changelog Generation
Use:
CODEBLOCK0
Features:
- - Reads git log range
- Parses conventional commit prefixes
- Groups entries by type (
feat, fix, chore, etc.) - Outputs markdown or plain text
Feature Announcement Framework
- 1. Problem context
- What changed
- Why it matters
- Who benefits most
- How to get started
- Call to action and feedback channel
Communication Quality Checklist
- - [ ] Audience-specific framing is explicit.
- [ ] Outcomes and trade-offs are clear.
- [ ] Terminology is consistent across artifacts.
- [ ] Risks and dependencies are not hidden.
- [ ] Next actions and owners are specified.
路线图沟通者
为内部和外部利益相关者创建清晰的路线图沟通文档。
使用时机
在以下场景使用此技能:
- - 构建不同格式的路线图演示文稿
- 撰写利益相关者更新(董事会、工程团队、客户)
- 制作发布说明(面向用户和内部)
- 从Git历史生成变更日志
- 组织功能公告
路线图格式
- 1. 现在/下一步/未来
- - 最适合不确定性和战略灵活性。
- 传达方向而不造成虚假精确。
- 2. 时间线路线图
- - 最适合固定日期承诺和发布协调。
- 需要主动的风险和依赖管理。
- 3. 主题式路线图
- - 最适合以成果为导向的规划和跨团队对齐。
- 按问题领域或战略目标对举措进行分组。
模板请参见 references/roadmap-templates.md。
利益相关者更新模式
董事会/高管
- - 以成果和风险为导向
- 聚焦战略目标的进展
- 突出权衡取舍和待定决策
工程团队
客户
- - 价值叙事和时间窗口
- 当前可用与即将推出的内容
- 清晰的期望设定
可复用模板请参见 references/communication-templates.md。
发布说明指南
面向用户的发布说明
- - 以用户价值为先,而非内部实现细节。
- 按工作流程或用户任务分组。
- 明确包含迁移/行为变更。
内部发布说明
- - 包含技术细节、运营影响和已知问题。
- 记录发布计划、回滚标准和监控说明。
变更日志生成
使用:
bash
python3 scripts/changelog_generator.py --from v1.0.0 --to HEAD
功能:
- - 读取Git日志范围
- 解析常规提交前缀
- 按类型分组条目(feat、fix、chore等)
- 输出Markdown或纯文本
功能公告框架
- 1. 问题背景
- 变更内容
- 重要性说明
- 主要受益群体
- 入门指南
- 行动号召与反馈渠道
沟通质量检查清单
- - [ ] 明确针对特定受众的表述。
- [ ] 成果和权衡取舍清晰明了。
- [ ] 各文档间术语保持一致。
- [ ] 风险和依赖关系未被隐藏。
- [ ] 指定后续行动和负责人。