SuperAPI AI 工具集

publish

部署与运维

查看项目

更新于 10-15 12:55

技能介绍

用途

publish 是 oh-my-openagent 仓库的发布管理技能,负责将 oh-my-opencode 发布到 npm。它通过触发 GitHub Actions 的 publish 工作流,并对发布产物进行验证,完成从触发到验证的完整发布流程。

该技能明确定位为“仅发布”(ship-only):不会运行 /pre-publish-review、/review-work 或任何代码复审,也不会在发布过程中“修复”代码、开 PR 或进入修复与重审循环。如果工作流失败或发现问题,应报告并停止,而不是在发布环节修复代码树。

主要能力

  • 触发 GitHub Actions publish 工作流,支持从 dev 分支派发。
  • 支持两种发布选择器:bump 类型(patch、minor、major)或明确的语义化版本号(含预发布版本,如 5.0.0-beta.9)。
  • 覆盖三个发布面:
    • omo 纯组件:已发布包负载中的 Core/MCP/shared-skill 变更,发布说明需标注层级版本影响。
    • omo opencode:oh-my-opencode 与 oh-my-openagent npm 包及平台包,需存在对应 npm 版本与 GitHub release。
    • omo codex:lazycodex-ai、Codex 插件元数据及 code-yeongyu/lazycodex 市场发布,需完成版本戳记、lazycodex-ai 发布及 LazyCodex 仓库 release。
  • 强制向 Discord 频道发布发布公告。
  • 验证 npm 包(oh-my-opencode、oh-my-openagent、lazycodex-ai)版本号。
  • 抽查平台二进制包。

使用方式

用户必须提供一个发布选择器:patch、minor、major,或明确的语义化版本号。若未提供,技能会立即停止并询问。

流程步骤包括:

  1. 注册 TODO 列表(强制第一步)。
  2. 确认并分类发布选择器。
  3. 检查未提交变更。
  4. 与远程同步(pull --rebase && push)。
  5. 触发 GitHub Actions 工作流:bump 类型通过 bump 参数传递;明确版本通过 version 参数传递(bump 仍传 patch 但被忽略)。
  6. 轮询工作流完成状态(每 30 秒),预期总时长约 30 分钟。
  7. 验证 release 存在并预览自动生成的 changelog 与贡献者致谢。
  8. 起草增强版发布摘要(patch/minor/major 均为强制)。
  9. 将增强摘要应用到 release(前置到自动生成内容之上)。
  10. 向 Discord 频道发布公告(强制)。
  11. 验证 npm 包、lazycodex-ai、Codex 插件元数据版本戳记及 code-yeongyu/lazycodex release。
  12. 抽查平台二进制包。
  13. 向用户做最终确认并提供链接。

适用场景

适用于 oh-my-openagent 仓库的正式发布流程,包括补丁、次要、主要版本及预发布版本的发布。发布请求附带 bump 类型时,从步骤 0 到触发仅需数分钟,唯一需要人工规模的工作是发布说明的起草。

限制

  • 必须提供有效的发布选择器,否则立即停止。
  • 仅发布,不执行任何代码审查或修复。
  • 工作流失败时报告并停止,不在发布中修复代码树。
  • 发布完成需满足五项条件:工作流结论为 success、release 存在、增强摘要已应用、Discord 公告已尝试、npm 版本已验证。
  • 若 Discord 发布在认证/重试后失败,需清晰报告并继续其余验证步骤;跳过 Discord 步骤视为工作流失败。
  • 发布说明需在派发 /publish 之前撰写于 ## [Unreleased] 下;若该节为空,发布无法继续。
  • 若用户明确要求先审阅 changelog,则暂停等待;否则不等待额外确认。
  • 当用户指明这是 OmO Native CLI 公开发布前的最后一次发布时,GitHub 摘要与 Discord 公告需以指定标题开头。