用途:Release Har 是通用发布自动化技能,适用于任何项目,用于在用户提到 release、版本升级、创建标签、发布等场景时完成一次结构化发布流程。
主要能力:按 Conventional Commits 分类提交(feat 归 Added,fix 归 Fixed,docs/perf/refactor/test/chore 等归 Changed),检测 BREAKING CHANGE;依 SemVer 规则建议版本号(有 breaking 升 major,有 feat 升 minor,否则升 patch;0.x.y 阶段对 breaking 需用户选择 minor 或 major);读取实际代码 diff 生成 Highlights 与 Before/After 表格的 Release Notes 草稿;更新 CHANGELOG.md(如存在 CHANGELOG_ja.md 则同步日文),规范历史条目日期与章节标题并更新 README 中的版本、功能与命令示例;更新 VERSION、package.json、pyproject.toml、Cargo.toml、.claude-plugin/plugin.json 等版本文件;提交并打注释标签;按需创建 GitHub Release(Release Notes 须为英文,含 Before/After 表格与固定页脚,Highlights 最多 3 条,无 Breaking Changes 则省略该节)。
使用方式:命令为 /release-har;可用 /release-har patch、minor、major 直接指定版本,默认自动判定并询问确认;--dry-run 仅预览不执行;--announce 在发布后生成 280 字内的 X 告知文,需手动复制发布。执行前做预检:检查 gh 命令(不存在仅警告并跳过 GitHub Release)、存在未提交改动则停止、VERSION 与 plugin.json 版本不一致则停止并提示运行 ./scripts/sync-version.sh sync。提交时只显式添加实际变更文件,不用 git add -A;禁止 force push。单人项目允许直接 push main,有协作者时应改用 PR。
适用场景与限制:适合采用 Git 的任意项目。其余限制与费用信息暂未提供。