SuperAPI AI 工具集

tinymist-release

部署与运维

查看项目

更新于 10-16 01:33

技能介绍

用途:为 tinymist 准备发布,面向维护者,采用保守的检查优先(inspect-first)工作流,复用仓库既有发布脚本。

主要能力与流程:分为检查规划、本地准备、外部操作三个阶段,外部操作前必须获得明确批准。用户需提供目标版本(如 v0.14.12-rc1、0.14.12、0.14.11);若缺失版本,先询问精确版本。

判断发布类型:去掉前导 v,以 -rcN 结尾为 release-candidate;patch 号为奇数为 nightly;patch 号为偶数且无 -rcN 为 stable。文档指出 stable 通常应跟随一次成功的 release candidate。

先运行仓库自带助手:node scripts/release-preflight.mjs <target-version> --json,将其 JSON 输出作为机器可读来源,用于分支就绪状态、受跟踪的 Cargo.toml 与 package.json、版本行、发布敏感非清单文件、生成文档后续命令、changelog 状态与覆盖率、以及 update/review/prepare/re-check/handoff 等可执行命令。

还需阅读 docs/tinymist/release-instruction.typ、scripts/release.mjs、scripts/draft-release.mjs;nightly 另读 .github/workflows/release-nightly.yml、scripts/nightly-utils.mjs;常规或候选发布走 scripts/release.mjs、release-asset-crate.yml、auto-tag.yml、announce.yml。

编辑前先报告检查结果:发布类型、就绪状态与阻塞项、期望分支 bump-version-<version> 及是否匹配并推送、清单扫描命令、生成的各类命令、changelog 摘要、后续外部命令。

本地准备无需额外批准:可运行生成的补丁命令、编辑 editors/vscode/CHANGELOG.md、用 node scripts/link-docs.mjs 刷新生成文档、编写发布 PR 标题与正文、运行生成的 review 命令、暂存改动并创建 build: bump version to <version>;之后重跑 preflight,若就绪则说明 yarn release <version> 是下一个外部命令。

外部操作须在执行前获得明确批准:yarn release、yarn draft-release、cargo publish、gh workflow run、gh pr create、gh release、git tag、git push --tag 及其他会变更 GitHub、发布产物或推送引用的命令;届时展示待执行命令、解释不可逆原因、等待批准、仅执行已批准操作并报告结果。

限制与守卫:一切从 preflight 命令开始;保持在 Codex 控制台内完成;优先用仓库脚本而非在提示文本中重写发布逻辑;release.mjs 与 draft-release.mjs 视为外部操作入口而非检查模式助手;未获批准不得发布、打标签、创建 PR 或变更 GitHub 资源;本地编辑后重跑助手;常规与候选发布的批准边界是本地检查点提交后的 yarn release <version>;若助手报告被省略的 changelog 条目,须在提交前及外部操作前提示。凭据、工具或权限缺失时,报告阻塞、说明原因并给出下一步具体 shell 命令。缺失事实:未提供该技能的收费、价格或平台信息。