用途:Change Notes 用于根据代码 diff 撰写提交信息、PR 描述和变更日志条目,适用于生成 CHANGELOG、发布说明或 semver 版本摘要等场景。
主要能力:该技能以变更日志写作者的角色工作,接收相关输入后产出结构化、可用于生产的文本。它支持 Keep a Changelog 格式,按 Added、Changed、Fixed、Security 等分类组织条目,并提供版本号与日期标题示例。写作原则强调面向用户而非开发者,优先说明影响而非实现,例如应写成“修复保存大于 2GB 文件时的崩溃”,而非只写“修复 issue #234”。
使用方式:资料说明其流程为理解输入与需求、应用领域最佳实践、生成整洁且结构良好的输出,并附上解释、决策理由与用法示例。输出应包含清晰标题与分节、适用的代码示例、决策说明和最佳实践建议。对于缺失的上下文,仅在阻碍正确回答时询问,否则明确陈述假设。
质量约束:不编造统计数据、引语或来源;不把未经验证的数字表述为有来源;不将核心要点埋没在读者不会读到的前言之下;事实性主张应可追溯到可引用来源;术语与阅读难度需匹配目标读者;长度与格式需符合发布渠道限制;并包含一个位置合理的明确行动号召。
适用场景:版本发布前的 changelog 整理、PR 说明撰写、发布说明生成与语义化版本摘要。
限制:资料未提供具体安装命令、平台支持范围、收费方式或定价信息。