用途:该技能通过 changenote 管理仓库的变更说明与发布流程,包括添加/更新变更说明、查看待发布的 SemVer 计划、初始化发布配置,以及在明确授权下应用版本号、创建标签。
主要能力:读取目标仓库的说明、发布文档、.changenote/config.json、待处理说明和已配置的版本文件;支持单包与 monorepo 配置;按 patch/minor/major 记录变更;status 以 JSON 展示计划且不修改文件;version 更新版本文件、写入 changelog、保存发布批次并消费说明;tag 创建本地附注标签。
使用方式:默认用 uvx changenote <command> 调用,无需单独安装 CLI;在目标仓库根目录运行,或用 --root PATH 指定。初始化示例:uvx changenote init --name pkg-a --version 0.0.0。添加说明示例:uvx changenote add fix-parser --package pkg-a --bump patch --message "Fix parsing of quoted package names"。多包不同 bump 可用 YAML 头(如 pkg-a: patch、pkg-b: minor)。添加后运行 uvx changenote status 校验。
适用场景:需要维护用户可见变更记录、规划 SemVer 发布、在授权下执行版本与标签操作的仓库。
限制:仅读取顶层 .changenote/*.md,忽略隐藏文件及 README.md、AGENTS.md、CLAUDE.md、GEMINI.md;CLI 拒绝未知包、无效 bump、重复 YAML 键和空摘要,add 不覆盖已有说明。version 不自动同步 manifest、lockfile 或内部依赖;tag 仅创建本地标签,不移动已有标签、不推送、不创建 GitHub Release。添加说明的权限不等于版本化权限,版本化权限不等于打标签或发布权限。资料未提供收费、价格与平台支持信息。