用途:为 kairos-mcp 仓库执行确定性的语义化版本发布,从提交证据推导版本级别,经确认后走脚本化分支与 PR 流程,标签由 CI 在合并后自动生成。
主要能力:检查上次稳定 v* 标签以来的提交(无标签时检查全部提交),输出已验证事实、推断理由与不确定性;按 BREAKING CHANGE/feat!/fix! 判 major,feat: 判 minor,fix:/docs:/chore:/refactor:/ci:/test: 判 patch,并区分 pre、beta、rc 三种预发布后缀;提供 release:major/minor/patch/bug/rc/pre/beta 脚本;version:sync-skills 同步 src/embed-docs/mem/*.md 与 skills/<顶层>/SKILL.md 的版本元数据,version:check-skills 校验。
使用方式:先取稳定标签并查看提交,例如 STABLE_TAG=$(git tag --sort=-v:refname | rg '^v[0-9]+.[0-9]+.[0-9]+$' | head -n 1),再 git log "${STABLE_TAG}..HEAD" --oneline。确认后同步 main,创建 release/next 分支并运行 npm run release:<type>,用 node -p "require('./package.json').version" 取版本并重命名分支,提交 package.json、package-lock.json、src/embed-docs/mem/、skills/,推送并用 gh pr create 开 PR。非 main 分支的 beta 发布由 release/beta PR 合并自动触发标签工作流,失败时可用 gh workflow run release-tag-on-version-bump.yml --ref <branch> -f ref=<branch> 兜底,并用 gh run list、gh release view 验证。
限制:不要在本地创建或推送 refs/tags/v*,pre-push 钩子会阻止手动打标签;非 main 分支只允许含 -beta. 的版本;工作区需干净;skills/.system/... 不在自动同步范围;预发布与 beta 不可互换。资料未提供具体收费、平台与效果信息。