SuperAPI AI 工具集

release-clawpatch

部署与运维

查看项目

更新于 10-28 04:49

技能介绍

用途

Clawpatch Release 用于把 openclaw/clawpatch 项目作为公共 npm 包 clawpatch 发布出去。它定义了一套从准备、验证、npm 发布到 GitHub Release 和发布后收尾的完整操作流程,强调先证明再发布、先验证 npm 再创建 GitHub Release。

主要能力

  • 发布前检查:确认主分支干净、拉取最新代码、检查目标版本是否已有 git tag 或 GitHub Release、查看 npm 现有版本与 dist-tags。
  • 发布文件准备:设置 package.json 版本号,把更新日志顶部区段从 Unreleased 改为目标版本与日期,整理发布说明,必要时仅在锁文件实际变化时提交锁文件。
  • 本地验证:运行 pnpm typecheck、lint、format:check、test、build 与 pack:smoke,失败需先修复。
  • 提交与 CI 监控:以 chore(release) 提交发布准备,推送主分支,并监控该提交的 CI 与 CodeQL 运行,全部通过后才发布。
  • npm 发布:使用临时 npmrc,避免使用默认用户 npmrc;通过 tmux 会话完成网页登录与一次性密码获取,发布时使用 npm publish --access public --otp。
  • npm 验证:检查目标版本、latest 指向、tarball URL、完整性字符串与发布时间。
  • GitHub Release:基于更新日志与 npm 验证信息生成发布说明,创建附注标签并推送,使用 notes-file 创建 Release。
  • 发布核验:检查 npm 元数据、Release 内容、标签指向的提交。
  • 发布后收尾:在更新日志顶部新增下一补丁版本的 Unreleased 区段,提交并推送,监控收尾 CI。

使用方式

按技能给出的命令顺序操作:进入项目目录,检查状态并拉取;确认版本未被标记或发布;准备版本号与更新日志;运行本地校验;提交并推送;监控 CI/CodeQL;在单一 tmux 会话中使用临时 npmrc 完成 npm 登录与发布;验证 npm 元数据;创建并推送标签与 GitHub Release;最后核验并开启下一版本的 Unreleased 区段。凭据和一次性密码只在同一持久 tmux 会话与临时 npmrc 中处理,不得打印令牌、密码或 OTP;公共 GitHub 内容应使用临时文件配合 --body-file 或 --notes-file。

适用场景

适用于维护 openclaw/clawpatch 仓库、需要按固定流程发布新版本 npm 包并同步创建 GitHub Release 的维护者。

限制

技能明确要求不得在 npm 发布验证前创建 GitHub Release;若 npm 发布提示版本已存在,仅在元数据与发布提交/包内容一致时才继续;若 npm 认证脚本失败,应继续使用同一 tmux 会话。资料未提供该技能在其他项目上的通用性、安装方式、价格或平台支持信息。