用途:帮助管理由 Release Please 负责的版本号、变更日志、标签与发布工作,覆盖配置接入、发布准备或审查、PR 合并,以及 SemVer 与破坏性变更分类。
主要能力:先校验发布所有权,识别 release-please-config.json、.release-please-manifest.json 等清单配置、googleapis/release-please-action 工作流、项目文档声明或 release-please 依赖与 CLI 用法;若均不存在,不推断自定义发布流程,而是询问用户是否添加 Release Please 或改用其他流程。保护生成产物,不手改版本、变更日志、清单、标签或发布说明。依据公开面向用户的契约而非代码量来分类发布影响,将可能的破坏性变更作为决策点明确提出。
必要用法:配置仅在用户明确要求时进行,需阅读并遵循 workflows/setup.md。发布准备或审查时,先读取本地代理指令、发布文档、配置与清单、包元数据、变更日志和发布工作流,确定组件路径、发布类型、标签格式等;找到上次受管的发布标签或清单版本,逐组件比较提交与 diff,并按 checklists/release-impact.md 判定。校验使用文档化的 typecheck/test/build 命令,发布专用检查仅用只读命令或 dry-run。授权自动化、合并 PR 或其他副作用前须完成前述准备工作,并遵循 workflows/authorized-automation.md,且每个具体操作仍需逐项授权。
限制:未经明确授权不得 push、打标签、发布、创建 GitHub 发布、运行带写入效果的自动化、合并 Release Please PR 或批准不可逆步骤;执行任何已授权的副作用操作前,须说明将发布的确切版本号并获得确认。不臆造发布命令,只使用仓库文档和本地代理指令中记载的命令;不假设 docs:、refactor:、chore: 或依赖提交会产生发布,需检查配置与文档。历史浅或不可用时需明确说明。适用于 Release Please 仓库的发布审查与准备,不适用于其他发布体系(相关资料暂未提供)。