用途:这是一项面向开发者营销场景的技能,用于撰写更新日志(changelog)与产品发布说明,让开发者愿意阅读并理解变更。资料指出,发布说明属于开发者沟通而非普通文档,写得好可建立信任、体现迭代节奏,并成为营销时机。
主要能力:覆盖 changelog 的标准结构(基于 Keep a Changelog 与语义化版本 Semantic Versioning),按 Added、Changed、Deprecated、Removed、Fixed、Security 分类记录变更;区分好条目与坏条目,强调具体、含上下文、附链接、说明影响;明确应包含内容(API 变更、SDK 变更、破坏性变更、安全修复)与可省略内容(内部重构、次要依赖升级、拼写修正)。
版本与变更沟通:向用户解释主版本、次版本、补丁版本含义,给出依赖版本约束建议;提供 API 版本生命周期表(Current、Legacy、Deprecated、Sunset);给出破坏性变更公告模板与沟通时间线(提前 6 个月公告、3 个月发布迁移路径、1 个月邮件通知等);提供代码内弃用警告、API 弃用响应头与弃用条目写法。
分发与工具:按渠道区分内容层级(GitHub Releases、文档 changelog、博客、邮件、Twitter/X、Discord/Slack),提供常规发布与破坏性变更的邮件模板;提及 Conventional Commits、semantic-release、changesets、Keep a Changelog 等工具,以及 GitHub Stars、npm 下载量、邮件打开率等监测指标。
适用场景与限制:适合维护 SDK、API 或开发者产品的团队统一发布沟通口径。资料未提供具体收费、价格、平台支持范围或实际效果数据,暂未提供。