SuperAPI AI 工具集

release-automation

部署与运维

查看项目

更新于 10-16 18:29

技能介绍

用途

release-automation 是移动应用发布流程的决策层技能。它不执行具体发布操作,而是判断每一步发布任务应当由智能体自动完成,还是必须交由人工处理。该技能应在任何发布任务的第一个动作之前阅读,而不是在出错之后。

主要能力

技能将每个发布步骤归为三类:

  • AUTO:仅依赖仓库和本地工具即可运行,不涉及商店密钥。智能体直接执行并报告变更。
  • AUTO+CRED:可自动化,但需要预先存在且有效的指定密钥。智能体先验证密钥,若缺失则明确指出缺少哪个密钥并停止,不得即兴发挥。
  • HUMAN:需要浏览器会话、法律身份、支付、接受的协议,或没有 API 支持的控制台表单。智能体不得尝试,而应准备好人工所需的一切(确切答案、确切点击路径)并移交。

两个修饰符覆盖上述分类,且都优先于“我能做所以我就做”:

  • GATE:技术上属于 AUTO 或 AUTO+CRED,但不可逆或对外可见。每次都需要人工确认,即使流程进行中也是如此。
  • ONCE:消耗不可复用资源(构建号、版本代码、单次下载的 .p8)。重试不是免费的。

技能覆盖的发布阶段包括:账户与法律、应用记录、签名材料、版本号、构建、素材、元数据、合规表单、上传、发布、审计。其中构建与签名环节几乎全部为 AUTO,合规表单环节几乎全部为 HUMAN,上传环节是唯一由密钥决定结果的地方。

使用方式

技能的核心指令包括:

  1. 行动前先分类。若某步骤不在自动化矩阵中,则视为 HUMAN,直到能说出执行它的 API。
  2. 先完成全部 AUTO 工作,然后一次性列出人工必须完成的事项。逐步打断是本技能要防止的失败模式。
  3. 明确指出缺失的密钥名称,而不是笼统地说“我需要凭据”。
  4. 绝不将 .p8、.p12、服务账户 JSON、MATCH_PASSWORD 或密钥库密码打印到记录或 CI 日志中。
  5. 每次都要说明哪些未做及原因:HUMAN、缺少密钥,或 GATE 等待批准。这三种原因不可互换。

输出格式要求以分类开头,而非叙述。提供一张已完成事项表、一份人工待办清单、一行等待批准的事项。

适用场景

适用于移动应用(iOS 和 Android)发布流程的规划与执行决策,尤其是需要明确划分自动化与人工职责、管理密钥依赖、处理不可逆操作确认的场景。也适用于首次会话无任何密钥时的降级模式:可运行审计、生成截图和预览视频、编写 fastlane 配置和 CI 工作流、本地创建上传密钥库、起草元数据文件和审核备注、生成合规表单答案表,并运行 mobile-release-doctor 生成所需密钥清单。

限制

技能中所有 HUMAN 分类若基于“没有 API”的推断,均标记为 [unverified],属于证据缺失。若发现相应 API,则该行分类有误。技能内容未针对真实商店账户执行过,仅 mobile-release-doctor 在 Linux 上执行过。研究日期为 2026-08-06。技能为派生内容,非独立研究,引用时需追溯来源页面的验证标记。Android 密钥库密钥命名采用 UPLOAD_* 拼写,是该插件的约定而非平台要求;在现有仓库中应从工作流读取密钥名称,而非从任何页面读取。