release-comms 是一个用于产品发布沟通的完整流水线技能,旨在将部署运行表和 GitHub 里程碑转化为面向客户的发布说明、文档更新、内部公告和营销材料。它属于“全流程”车道,会修改外部状态(如 Slack 帖子、文档 PR、wiki 页面),因此所有发布物均先生成草稿,并需用户显式批准后方可发布。
使用方式:需一次性配置参数(通过 kit.toml、.env 或参数传入),包括 PRODUCT_REPO(存放发布里程碑的仓库)、MILESTONE_PATTERN(里程碑命名模式)、TEAM_LABEL(过滤团队标签)、RUNSHEET_SOURCE(部署运行表位置)、RELEASE_DIR(每次发布的工作目录)、DOCS_REPO(文档仓库本地路径)、RELEASE_NOTES_FILE(文档仓库中的发布说明文件路径)、ANNOUNCE_CHANNEL(内部公告 Slack 频道)、MARKETING_CHANNEL(营销包 Slack 频道)、FLAG_SYSTEM(运行表中提及的功能开关系统)。
主要能力与流程:
- 收集阶段:使用并行工作器提取用户可见变更,下载媒体素材(截图和视频),并写入暂存文件。
- 发布说明撰写:生成单一文件,包含 frontmatter、叙事摘要、亮点、逐功能章节(新功能、意义、当前可用性)、增强、修复和附录表格。强调以用户收益为导向,嵌入下载的媒体,披露已知问题,并避免使用“v1”等命名。
- 文档更新:基于 origin/main 创建分支,使用 git worktree 避免干扰主检出;新增或更新功能文档,并扫描过时内容;将发布条目添加到发布说明文件。
- Slack 公告草稿:在 ANNOUNCE_CHANNEL 生成简洁的公告草稿,包括公告行、问候语、功能要点和已知问题提醒,需用户批准后发布。
- 营销包:在 MARKETING_CHANNEL 生成轻量级更新日志线程格式,包括主帖和每个功能的详情帖,附带媒体清单和针对 newsletter 编辑的建议消息。
- 可选步骤:将演示视频链接写回相关 GitHub issue 的“Demo”字段(如通过 gh api graphql),并检查现有值。
- 验证闭环:使用独立验证器重新检查发布说明中的声明,标记为已验证、减弱或伪造,并进行媒体检查;发布后重新获取工件确认符合意图。
适用场景:适用于需要协调产品发布沟通的团队,特别是希望从部署运行表和 GitHub 里程碑自动生成一致、准确的发布说明、文档更新、内部公告和营销材料的场景。
限制:所有外部发布动作需用户显式批准;部分配置参数为必需;媒体素材需从 issue 评论中提取,私有仓库需认证;文档更新使用 git worktree 分支,可能需处理未合并的草稿;验证闭环依赖独立验证器。