用途:自动化 Octop Python 包的完整发布流程,典型调用为 /publish 0.1.14,目标版本号为唯一必填参数。
主要能力:从最新 develop 切出 release/* 分支;分析上次 tag 以来的提交,按约定前缀分类生成中文 Keep a Changelog 条目;同步升级 pyproject.toml、init.py 的 version、多语言 README 徽标、飞牛 FnOS manifest 与 compose 镜像标签、uv.lock 中 octop 版本;用 gh CLI 创建合入 main 的 PR;合并后由 auto-tag-on-release.yml 在 main tip 推送 tag;最后删除 release 分支并由 Action 将 main 同步回 develop。
配置:CHANGELOG_FILE、VERSION_FILE、VERSION_PATTERN、README_GLOB、INIT_VERSION_FILE、TAG_PREFIX、REMOTE、INTEGRATION_BRANCH、TARGET_BRANCH、RELEASE_BRANCH_PREFIX 等均有默认值,可在 .cursor/skills/publish/SKILL.md 覆盖。
关键约束:必须先合入 main 再由 Action 打 tag,禁止在 release 分支提前推送生产 tag 或直接上传 PyPI;工作树必须干净,跳过用户确认、CHANGELOG 确认或失败后继续均不允许;发布结束需切回原分支。
限制:依赖 git、gh CLI 与 GitHub Actions 配置;文档未提供定价、支持平台或性能数据,均为暂未提供。