mcpField
R
roadmap-communicator

roadmap-communicator

github.com/alirezarezvani生产力28.9k591 次安装2 天前更新
代码仓库

关于 roadmap-communicator

roadmap-communicator 是面向产品和项目团队的沟通技能，用于制作路线图、利益相关者更新、发布说明与变更日志，并提供按受众和目标组织内容的框架。

主要功能

  1. 01制作多种格式的路线图
  2. 02撰写利益相关者更新
  3. 03编写内外部发布说明
  4. 04从 Git 历史生成变更日志
  5. 05组织功能公告内容

适用场景

  1. 01向董事会说明进展、风险与决策
  2. 02向工程团队传达依赖和阻碍
  3. 03整理面向客户的发布信息

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/alirezarezvani/claude-skills --skill roadmap-communicator

安装后在 Claude Code 中输入/roadmap-communicator确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
communication-templates.md
roadmap-templates.md
scripts/
changelog_generator.py

详细介绍

Roadmap Communicator

为内部和外部利益相关方创建清晰的路线图沟通材料。

适用场景

在以下场景使用此技能：

  • 制作不同格式的路线图演示
  • 撰写利益相关方更新（董事会、工程团队、客户）
  • 编写发布说明（面向用户和内部）
  • 根据 git 历史生成变更日志
  • 构建功能公告结构

路线图格式

  1. Now / Next / Later
  • 最适合不确定性较高且需要战略灵活性的情况。
  • 在不给出虚假精确度的前提下传达方向。
  1. 时间线路线图
  • 最适合有固定日期承诺和发布协调的情况。
  • 需要积极管理风险和依赖关系。
  1. 主题式路线图
  • 最适合以成果为导向的规划和跨团队对齐。
  • 按问题领域或战略目标对计划进行分组。

模板参见 references/roadmap-templates.md。

利益相关方更新模式

董事会 / 高管
  • 以成果和风险为导向
  • 关注相对于战略目标的进展
  • 突出权衡取舍和需要做出的决策
工程团队
  • 范围、依赖关系和排期要清晰
  • 状态、阻塞项及资源影响
客户
  • 价值叙述和时间窗口
  • 当前可用内容与即将推出的内容对比
  • 明确的预期设定

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

发布说明指南

面向用户的发布说明
  • 以用户价值为开头，而非内部实现细节。
  • 按工作流或用户任务分组。
  • 明确说明迁移或行为变更。
内部发布说明
  • 包含技术细节、运营影响和已知问题。
  • 记录发布计划、回滚标准和监控说明。

变更日志生成

使用：

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

功能：

  • 读取 git log 范围
  • 解析 conventional commit 前缀
  • 按类型（feat、fix、chore 等）对条目分组
  • 输出 Markdown 或纯文本

功能公告框架

  1. 问题背景
  2. 有哪些变化
  3. 为何重要
  4. 最受益的人群
  5. 如何开始使用
  6. 行动号召与反馈渠道

沟通质量检查清单

  • 明确说明针对特定受众的表述角度。
  • 成果和权衡取舍清晰可见。
  • 各类材料中的术语保持一致。
  • 风险和依赖关系没有被隐藏。
  • 明确列出后续行动及负责人。

评论

支持 Markdown