用途
w-release 是一个发布影响审查技能,定位为“仅提供建议”(Advisory only)。它的目标是在发布流程中帮助审查发布影响、变更日志和模板契约,但不执行任何实际的发布操作。
主要能力
- 对比代码差异:针对功能 PR 与 main 分支对比,针对发布 PR 与上一个 v* 标签对比。
- 列出 payload 路径:从仓库发布文档中读取 payload 路径清单(Basilic 示例包括 apps/api|web|mobile、packages/、tools/、scripts/、.cursor/、.agents/、generator)。
- 建议标题:给出符合约定式提交(conventional)规范的标题建议。
- 标记变更类型:当 payload 路径发生变化时,标记 docs/chore/test/ci/style 类型,除非提交正文中包含 skip-release: true。
- 提示影响面:说明生成器 CLI、模板 include/exclude 以及文档快照的影响。
- 约束生成树:生成的目录树不得包含文档应用或生成器。
- 起草变更日志:撰写面向用户的变更日志条目以及采用者需要执行的操作。
- 保持权威性:仓库自身的发布变更日志保持权威(Basilic 使用 Release Please)。
- 链接相关项:链接测试、分类,以及在发布 PR 上链接脚手架验收结果。
- 人工关卡:如果缺少人工审核关卡,则停止。
使用方式
该技能以建议形式运行。使用前应先阅读仓库的发布文档。它不会升级版本、合并发布 PR 或使用发布凭据。具体调用方式与集成方式暂未提供。
适用场景
适用于需要在发布前审查发布影响、变更日志和模板契约的仓库维护流程,尤其是采用约定式提交和 Release Please 类工具的仓库。
限制
- 仅提供建议,不执行版本升级、发布 PR 合并或凭据使用。
- 依赖仓库自身的发布文档和发布变更日志作为权威来源。
- 若缺少人工审核关卡则停止。
- 其他具体限制暂未提供。