Saucebox Registry
← Browse

@coooolfan/release-note-creator

B

撰写 Xiaomi Album Syncer 的 Release Notes。适用于：(1) 发版前为指定版本号生成更新日志；(2) 确定版本的变更范围（前序 tag 比较基准）；(3) 校对已有 release notes 是否符合书写规范。

skillclaude

Install

agr install @coooolfan/release-note-creator --target claude

Writes 1 file into .claude/skills/, pinned to git-aab0b7fe.

  • .claude/skills/release-note-creator/SKILL.md

Document

name: release-note-creator description: 撰写 Xiaomi Album Syncer 的 Release Notes。适用于：(1) 发版前为指定版本号生成更新日志；(2) 确定版本的变更范围（前序 tag 比较基准）；(3) 校对已有 release notes 是否符合书写规范。

Release Note Creator

流程

  1. 阅读 references/range-determination.md，了解如何确定变更范围
  2. 从远程获取 tag 列表
  3. 与上一步确定的前序 tag 进行比较，确定变更范围
  4. 阅读 references/release-note-guideline.md，了解如何撰写更新日志
  5. 如版本号、前序 tag 或更新日志范围存在歧义，再与用户确认
  6. 在无歧义时直接撰写更新日志
  7. 将更新日志写入 docs/release_notes/<version>.md

与 CD 工作流的关系

  • CD 工作流（.github/workflows/cd.yml）通过 workflow_dispatch 手动触发，create-draft-release.sh 会在目标 commit 上检查 docs/release_notes/<version>.md，文件缺失会导致发布失败
  • 因此 release notes 必须在触发 CD 之前提交并推送到 main
  • 版本号规则（由 prepare-release.sh 校验）：
    • 形如 0.17.0 或 0.17.0-rc.1，预发布标签仅允许 alpha、beta、rc，推荐使用点（.）分隔序号
    • 兼容旧格式 0.15.2-beta-1（连字符分隔），新版本不再使用
    • 不使用 v 前缀
    • 预发布版本不能发布为 latest

tips

  • 使用 markdown 格式
  • 不允许使用 gh 命令，仅基于本地 git 信息工作
  • scripts/ 下的脚本都支持传递 --help 参数查看使用方法

Trustgrade B

  • passBody integrity

    Whether the stored document is plausibly the kind of file the artifact declares, rather than something fetched by mistake.

  • passType matchnot applicable to this artifact type

    Whether the artifact is really the kind of thing its metadata claims it is.

  • passFreshness

    How long since the source repository was last pushed to.

  • passPrompt injection

    Scans the artifact's own text for instructions aimed at your agent rather than at you.

  • warnLicensecopyleft/unknown — index-and-link only

    Whether the source repository declares an SPDX license permissive enough to redistribute.

How the grade is calculated

Each check contributes 0 points when it passes, 1 when it warns, and 2 when it fails. The total maps to a letter:

  • Aevery check passed
  • Bone warning
  • Ctwo warnings
  • Dprompt injection or body integrity failed, or three warnings
  • Fone of those failed, and something else is wrong

These are automated hygiene checks, not a security audit, and not a dependency or vulnerability scan. A grade of A means nothing was flagged — not that the artifact is safe.

Versions

  • git-aab0b7fe25e12026-07-31