DevOps & cloud
oc-deploy
验证、诊断和发布 OpenCreator Desktop,包括本地实际 App 打包与 E2E、master 候选构建、GitHub Actions 故障定位及明确授权后的 tag Release。用于“打包 Desktop”“验证候选包”“排查发布失败”“发布 OpenCreator”等请求;普通开发构建不使用。
krillinai · Static checks on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add krillinai/OpenCreator --skill oc-deployAbout this skill
name: oc-deploy description: 验证、诊断和发布 OpenCreator Desktop,包括本地实际 App 打包与 E2E、master 候选构建、GitHub Actions 故障定位及明确授权后的 tag Release。用于“打包 Desktop”“验证候选包”“排查发布失败”“发布 OpenCreator”等请求;普通开发构建不使用。
OpenCreator Deploy
以“同一提交先在本机证明,再消耗远端构建资源”为发布原则。遵守仓库根目录 AGENTS.md,尤其是 Desktop 打包和 Web/Desktop 一致性门禁。
先选择模式
- diagnose:用户问为什么失败时,只读取现有本地输出和已存在的 GitHub 日志。先给出失败阶段、原始错误和根因;未经要求不得触发新构建。
- preflight:在当前提交上执行本地候选包验证,不产生 GitHub 外部变更。
- candidate:用户明确要求远端验证时,从
master对精确提交手动触发一次desktop-release.yml。不得创建、移动或复用 tag,不得发布 Release。 - release:仅当用户明确要求正式发布或创建 tag 时使用。preflight 和精确提交的 master CI 未通过前不得创建或推送 tag。
执行任何模式前先读取 references/runbook.md 中对应章节。涉及失败时同时读取“故障分类”。
强制门禁
- 先记录分支、HEAD、dirty 状态、远端同步状态和目标平台。不得把用户已有改动带入提交或发布。
- 类型检查、单元测试和源码构建不能替代实际 App 验证。远端 candidate 或 release 前,当前精确提交必须完成本机原生
desktop:package,并让e2e:package全部通过。 - Desktop 打包必须重建当前
apps/web,并通过包校验器确认 App 内 Web 资源与本次构建一致。不得手工替换 App 内资源或复用来源不明的dist。 - 任何 GitHub 构建前,确认精确提交已有成功的
masterpush CI;确认 workflow 的publish仍只允许 tag ref。 - GitHub 下载和
gh命令设置HTTP_PROXY与HTTPS_PROXY为http://127.0.0.1:7897,并先用gh auth status确认认证身份。GitHub 保存的签名 secrets 会跨 workflow 运行持续存在,不要要求重复上传。 - 不用付费 Release 构建逐次发现问题。一次远端运行首次出现 package、E2E、签名、公证或上传失败时,立即取消仍在运行的付费 sibling jobs,读取该 run 的已生成日志和 artifacts;不得为了拿日志直接 rerun。
- candidate 只能通过
workflow_dispatch从master运行。正式发布候选必须选择target=all;结束后确认候选身份凭据和全部 artifacts 已生成、publishskipped,并确认 tag 和 Release 均未变化。单平台 candidate 只用于诊断,不能提升为 Release。 - release 通常只对已经通过上述门禁和完整 candidate 的精确 commit 创建 tag。候选之后若只有 workflow、Release 附件整理、对应测试或发布文档变化,可由 tag workflow 通过祖先关系和应用构建输入 SHA-256 复用不可变 artifacts;任何 App、Runtime、依赖或打包输入变化都必须重新通过完整 candidate。tag workflow 不得重新执行付费打包。
完成标准
报告精确 commit、本地打包平台、本地 App 路径、包校验与 E2E 结果、master CI、candidate run URL、各 job 结果、候选身份凭据及 artifacts。candidate 明确说明未创建 tag/Release;release 同时列出被提升的 candidate run、tag 和发布附件。任何未执行门禁都必须说明原因和残余风险,不得声称可发布。