SuperAPI AI 工具集

w-release

部署与运维

查看项目

更新于 10-15 14:51

技能介绍

用途

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 合并或凭据使用。
  • 依赖仓库自身的发布文档和发布变更日志作为权威来源。
  • 若缺少人工审核关卡则停止。
  • 其他具体限制暂未提供。