SuperAPI AI 工具集

release-please-standards

办公与效率

查看项目

更新于 10-15 23:49

技能介绍

用途:本技能提供 release-please 的标准配置参考,用于自动化语义化版本与变更日志生成。适用于需要规范发布工作流、审计现有 release-please 配置是否符合约定,或需要引用标准配置的场景。若需端到端交互式搭建或运行时检测仓库类型,应改用 configure-release-please;若涉及 monorepo 组件标签、每包 extra-files 或共享到组件标签迁移,应改用 git-plugin:release-please-configuration。

主要能力:给出三类必需文件的规范形态。工作流文件 .github/workflows/release-please.yml 使用 googleapis/release-please-action@v5,触发 push 到 main,权限需 contents: write 与 pull-requests: write。令牌优先使用 GitHub App token(actions/create-github-app-token,app-id 取 vars.RELEASE_PLEASE_APP_ID,private-key 取 secrets.RELEASE_PLEASE_PRIVATE_KEY),PAT 作为旧版回退(secrets.MY_RELEASE_PLEASE_TOKEN)。配置文件 release-please-config.json 需指定有效 release-type(如 node、python、helm、simple)并定义 changelog-sections,至少包含 feat 与 fix。清单文件 .release-please-manifest.json 列出各包当前版本,0.0.0 为占位值。

项目类型差异:Node 用 release-type: node 与 node-workspace 插件,更新 package.json;Python 更新 pyproject.toml 与代码中 version;Helm 更新 Chart.yaml。多包仓库需为每个包设置 component,并在根级启用 include-component-in-tag: true。

合规检查:三文件齐全且配置有效为 PASS;使用低于 v5 的旧版 action 为 WARN;缺失必需文件或配置无效为 FAIL。令牌必须来自 secret,不得硬编码。

限制与注意:release-please 自动管理 CHANGELOG.md、各版本字段与 manifest,不应手动编辑。提交信息须遵循 Conventional Commits(feat 为 minor,fix 为 patch,feat! 或 BREAKING CHANGE 为 major)。安装步骤为创建工作流、配置、清单文件并提供发布令牌,同时确保 pre-commit 含 conventional-pre-commit 钩子。其他细节暂未提供。