用途:根据上次发布标签以来的真实改动,起草或更新 CHANGELOG.md 顶部的 [Unreleased] 段落,形成叙事式发布说明。可在开发中、提 PR 前或发版前随时运行,属非破坏性工作副本。
主要能力:先识别最近标签(git tag --list "v*" --sort=-v:refname | head -n 1),再从三处收集素材:提交日志(git log --oneline "$LAST_TAG"..HEAD)、GitHub 生成的发布说明预览(gh api repos/:owner/:repo/releases/generate-notes,含 PR 标题与新贡献者)、差异统计(git diff --stat "$LAST_TAG"..HEAD)。随后按主题分组撰写叙事,替换 [Unreleased] 与下一个 ## [ 之间的内容,保留头部 HTML 注释及下方已有发布段落。
使用方式:运行后仅修改工作区文件,不提交、不打标签、不升版本。格式要求:开头一段说明本次发布主题与意义并关联具体改动,必要时加一段技术变化,再按功能/主题分组列要点,可引用 PR 链接,最后保留模板中斜体“built with Capy”署名行不变。风格要求:事实具体、可追溯到提交或 PR;叙事优先于列表;按主题而非提交分组;不虚构 PR;跳过琐碎杂项,除非其占多数;语气参照 CHANGELOG.md 中 v0.2.1 与 v0.2.3 条目。
限制:仅触碰 [Unreleased] 段落,绝不修改已定版发布段落;[Unreleased] 必须始终存在且位于头部注释之后的第一段。若 git log "$LAST_TAG"..HEAD 为空,则仅保留标题并告知无可起草内容。release-bump 技能依赖此草稿保持最新。