SuperAPI AI 工具集

release-changelog-harness

通用与其它

查看项目

更新于 10-15 17:17

技能介绍

用途:在引入发布 CI、版本策略或 monorepo 发布流程时,先统一发布可读性契约,再按仓库生态选择原生工具,避免把单一生态的做法强加给其他语言项目。

主要能力:按仓库信号路由默认工具,例如 pnpm/npm workspaces 用 @changesets/cli,单 Node 包或用 release-please 或用 Changesets,Dart monorepo 用 Melos version + changelog,Rust workspace 用 release-plz 或 cargo-release + git-cliff,带二进制产物的项目用 release-please + tag CI + install.sh。提出发布可读性契约:笔记进 Git、贡献者按固定形状提交意图、发布会话机械可复现、发布后 CHANGELOG 反映实际内容、工具选型有 ADR 记录、安装可信度与发布事实一致。

使用方式:先分类仓库原型;再据“多 JS 包 / 提交消息驱动 / 维护者写明意图 / 是否为 pub 或 Cargo”选择生成器,多选项时记录 ADR;随后在 DX_FAQ、CI、AGENTS.md、CONTRIBUTING 中接入门禁与文档;最后验证可读性。Changesets 贡献者条目形如 .changeset/*.md,维护者流程可用 pnpm changeset、pnpm changeset version、pnpm install、git commit -am "chore: version packages"。私有包需在 .changeset/config.json 配置 privatePackages 的 version 与 tag。安装命令:npx skills add arenukvern/skill_steward --skill release-changelog-harness。

适用场景:发布流程不清、版本漂移、智能体无法判断已发布内容,或新增发布 CI、版本策略、monorepo 发布工作流,以及审计变更日志工具是否匹配仓库原型。

限制:该技能是元框架文化(选哪个工具、哪些门禁、文档放哪),不是各包管理器的完整教程;避免在纯 Rust 仓库硬套 Changesets、只把变更日志放 GitHub Releases、在 AGENTS.md 写千行发布文档、跳过 changeset 交由 AI 发布时写 CHANGELOG、无面向使用者说明的版本升级、二进制发布无 Git 内变更日志、用 GITHUB_TOKEN 推标签后再依赖 push 标签工作流、静态写死旧版本安装示例、对服务端产品用 git clone 作为终端安装。具体项目命令需在项目 DX_FAQ 记录。