cl

SkillDev tools

Audit commits since the last release, add any missed user-visible changes to the [Unreleased] section of CHANGELOG.md; optionally finalize [Unreleased] into a formal release section.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the cl skill

What this skill tells your AI

The instructions your AI receives, as published by maotoumao/cebian in .agents/skills/cl/SKILL.md and read by ahel’s review.

帮我审计并维护 CHANGELOG.md,确保自上次发版以来的所有「用户可见变更」都被记录。规则以 AGENTS.mdChangelog 章节为准。

参数约定:

  • 留空 → 只做「审计 + 补漏」:把遗漏的条目补进顶部的 ## [Unreleased]收口、改版本号。
  • 传版本号(如 1.3.3)→ 在补漏之后再做「发版收口」:把 ## [Unreleased] 落成 ## <版本> - <今天日期>,并在顶部补一个新的空 ## [Unreleased]

工作流

1. 划定审计区间

  • 读取 CHANGELOG.md,找到最近一个已发布版本节(如 ## 1.3.2 - 2026-06-14)和它的日期。
  • 在终端用 git log 取出自该版本以来的提交(项目历史是线性的、无 git tag,按日期或上一条 release commit 划界即可)。例: git log --no-pager --pretty=format:'%h %ad %s' --date=short --since=<上次发版日期>
  • 同时读完整个现有 ## [Unreleased],记下已经记过的条目,避免重复。

2. 逐条判定「记 / 不记」

对区间内每个提交,按 Changelog 章节的「记什么」判断:

  • :新功能、行为变化、Bug 修复、面向用户的破坏性变更。
  • 不记:纯重构、测试、构建、CI、文档、内部依赖升级(除非影响用户的可感知行为)。
  • 拿不准时,问自己「终端用户能不能感知到这条变更」——能则记,不能则跳过。
  • 一个提交可能对应一条或多条用户可见变更;反之多个琐碎提交可合并成一条。

3. 写入 [Unreleased]

  • 归入正确小节:### 新增 / Added### 变更 / Changed### 修复 / Fixed### 移除 / Removed### 破坏性变更 / Breaking Changes(按需创建,不重复建小节)。
  • 双语排版:每个小节正文先列全部中文条目,空一行,再列全部对应英文条目(顺序一一对应)。不要逐行中英并排,不用 / 在条目内分隔中英。
  • 来自 issue 的变更在中、英两条末尾都附 (#编号)
  • 措辞从用户视角写,描述「带来什么变化」,不要照抄 commit message 的实现术语。
  • 只动 ## [Unreleased],绝不修改任何已发布版本节。

4.(仅当传了版本号)发版收口

  • ## [Unreleased] 标题改成 ## <版本号> - <今天的日期 YYYY-MM-DD>
  • 在文件顶部、紧跟头部约定说明之后,补一个新的空 ## [Unreleased]
  • 不要在这里改 package.json 的版本号——版本号 bump 由发版提交单独处理,本指令只管 Changelog。

输出

  • 先报告:审计了哪个区间(从哪个版本到 HEAD)、扫了多少提交。
  • 列出本次新增/合并了哪些条目、有意跳过了哪些提交(一句话说明为什么跳过,便于我复核取舍)。
  • 如果做了发版收口,说明落成了哪个版本节、日期是多少。
  • 遇到拿不准要不要记、或某条变更措辞没把握的,直接告诉我,不要擅自下判断。

Signals

GitHub stars
146
Forks
27
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
cl
Source
github.com/maotoumao/cebian