用途:面向多包(monorepo)仓库的 release-please 配置策略,覆盖组件标签、按包 extra-files、联动版本,以及从共享标签迁移到组件标签。单仓库工作流、manifest/config 形态、约定式提交版本提升规则与合规审计请改用 configure-plugin:configure-release-please。
主要能力:配置 include-component-in-tag 与 component 以生成 package-a-v1.0.0 式标签;用 separate-pull-requests 生成按包发布 PR;用 linked-versions 插件让多个组件保持同一版本;为 JSON/YAML/TOML/XML 等文件设置版本位置。
必要用法:monorepo 需在根级设置 "include-component-in-tag": true,并为每个包设置唯一 "component"。JSON 类 extra-files 必须用对象格式,如 {"type": "json", "path": ".claude-plugin/plugin.json", "jsonpath": "$.version"};路径相对包目录,release-please 会自动前置包路径,不要自行重复。新增包需同时更新 release-please-config.json 与 .release-please-manifest.json。
常见失败与限制:重复标签多因缺少 include-component-in-tag 或 component;Multiple paths 警告多因 component 为空。分组发布 PR(separate-pull-requests: false)若使用含 ${version}/${component}/${scope} 的自定义标题模式,会渲染出无法回解析的标题,导致合并后 PR 一直未被标记,后续运行报“untagged, merged release PRs outstanding”而中止;应去掉自定义标题模式。已卡住的 PR 可先创建 autorelease: tagged 标签,再用 gh pr edit $PR_NUMBER --add-label "autorelease: tagged" --remove-label "autorelease: pending" 重新标记,并 gh workflow run release-please.yml 触发新运行。
适用场景:多包仓库新增包、修复重复标签/多路径/按包无版本提升、迁移共享标签到组件标签。合并发布 PR、检测受管文件被手动修改、Release-As 覆盖等请使用对应其他技能。资料未提供收费、平台与效果信息。