发布交接

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install metarun-release-handoff
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 metarun-release-handoff。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

发布交接负责处理 iOS 构建版本上传后的工作：查找可编辑的 App Store 版本、附加已处理的构建版本、解决出口合规与商品页面阻碍项、选择发布选项，并通过 MetaRun 提交。它还支持处理被拒的发布版本：获取审核状态、协助将用户提供的反馈对应到修复措施，并重新提交现有版本。
它专为 Openclaw Skills 工作流设计，在可用时使用 MetaRun MCP 工具，或以 MetaRun CLI 作为替代方案。其安全措施强调使用实时工具架构、经过验证的 ID、预览并应用更改，以及在执行对外操作前明确征得用户确认。App Privacy 和 App Review 消息仍需在浏览器中通过 App Store Connect 处理。

应用场景

构建版本已通过 Xcode、fastlane、Xcode Cloud、CI 或其他工具上传，现已准备好发布。
iOS 版本需要附加已处理的构建版本，并解决 App Store Connect 提交阻碍项。
缺少出口合规信息，必须先申报才能发布构建版本。
首次发布或更新需要就绪情况检查、修复本地化商品页面，或配置供应情况。
Apple 拒绝了某个版本，团队需要检查审核结果、实施适当修复并重新提交。
团队希望在将版本送审前选择自动发布、手动发布或分阶段发布。

工作原理

通过 MCP 或 CLI 连接 MetaRun，并在使用不熟悉的工具前检查实时架构。
定位 App 及其唯一可编辑版本。仅在不存在版本时创建新版本；如果现有可编辑版本被拒，则继续处理该版本。
对于被拒的版本，检查审核提交记录并获取审核结果详情。请用户提供 App Store Connect 中的 App Review 消息，因为该消息及其附件无法通过 API 获取。
查找已处理且有效的构建版本。如果加密合规状态尚未设置，先预览并确认申报内容，并说明此更改不可撤销。
预览将构建版本附加到该版本的操作，向用户展示拟议差异，并使用返回的 confirm token 应用更改。
执行提交就绪情况检查。使用商品页面覆盖情况跟踪各语言的缺项，然后处理缺失元数据、屏幕截图、供应情况或相互冲突的审核提交等阻碍项。
与用户一起处理仅限浏览器完成的要求，包括 App Privacy，以及适用时的 EU trader status 或 Apple-silicon availability details。
如果用户尚未指定，询问发布应采用自动、手动还是分阶段方式。重复运行提交预览，直到没有阻碍项。
准确展示即将提交的内容；只有在用户明确批准后，才使用 confirm token 和所需确认声明应用提交操作。
检查审核提交状态，并报告结果及相关更改历史详情。

配置指南

前提条件：安装 Node.js/npm 并可使用 npx，拥有 MetaRun 访问权限，以及包含已上传构建版本的 App Store Connect App。如果代理可用 MetaRun MCP 服务器，请连接该服务器；否则使用 CLI。
npx metarun login
登录需要从 metarun.dev 的 Settings → MCP 获取 MetaRun 个人访问令牌。也可以设置 METARUN_TOKEN；运行 npx metarun login 后，令牌会存储在 ~/.metarun/config.json 中。
发现工具；在调用参数包含当前会话中尚未使用过的内容之前，先检查输入架构：
npx metarun tools --json
npx metarun tools
npx metarun run ''
无论通过 MCP 工具还是 CLI 调用，都使用相同的预览/应用工作流。未经向用户展示预览并获得所需确认，绝不应用写入操作；提交还必须获得用户明确批准。

数据架构

此技能通过 MetaRun 工具操作 App Store Connect 实体；它不定义本地项目数据格式，也不会生成持久化的发布清单。
实体或输出 用途
App 按 bundle ID 或 App 名称定位；唯一可假定的 ID 是用户提供的 bundle ID。
Version 使用 apple_list_versions 获取；应使用唯一的可编辑版本，而不是创建重复版本。
Build 使用 apple_list_builds 获取；仅当处理状态为 PROCESSED 或 VALID 时才附加。
Review submission 使用 apple_list_review_submissions 和 apple_get_review_submission 获取；尚未解决的拒绝仍与可编辑版本关联。
Preview result 包含拟议差异，以及对应 apply 操作所需的 confirmToken。如果商店状态发生变化导致令牌失效，应重新预览。
Listing coverage 报告各语言的完成情况、submissionBlockers 和可选字段的 gaps，用于跟踪就绪状态。
Screenshot upload studio_create_upload 提供已签名的上传 URL 和 curl 命令；上传后，studio_finalize_upload 会返回用于提交屏幕截图的 HTTPS imageUrl。
Privacy answers apple_build_privacy_answers 会分析 App 的 PrivacyInfo.xcprivacy 和 SDK 清单，并返回需要在 App Store Connect 中手动填写的答案。
更改会记录在 MetaRun 的更改历史中，通常可以撤销；加密申报等有文档说明的例外情况除外。审核状态更改会显示在 Releases 面板中。

高级特性

强制要求发现实时架构，而不是依赖猜测工具参数。
使用预览/应用配对和确认令牌来检测商店期间发生的更改，并保护写入操作。
同时支持 MetaRun MCP 工具及对应的 CLI 调用。
支持重新提交被拒版本而不创建重复版本，并区分元数据被拒与需要新构建版本的情况。
使用各语言的商品页面覆盖情况，确认元数据修复已生效后再重试提交。
支持已签名的屏幕截图上传，无需将图像数据放入工具参数。
根据 App 和 SDK 隐私清单生成 App Privacy 答案，同时明确指出提交步骤仅能在浏览器中完成。
提供自动发布、手动发布和分阶段发布的发布选项工作流。
鼓励实时发现 MetaRun 的更多功能，包括定价、ASO、本地化、屏幕截图、评论和 TestFlight。

name: release-handoff description: >- Finish an iOS release after the build is uploaded. When a build has been
uploaded to App Store Connect by any tool (fastlane, asc, Xcode, Xcode
Cloud, CI) and the user wants it shipped: attach the build to the version,
clear export compliance, run the readiness sweep, fix what blocks, and
submit for review through MetaRun. Also the way back after App Review
rejects a version: read the verdict, fix, resubmit. Trigger phrases: "ship
it", "submit the build", "finish the release", "send 2.4 to review", "the
build is up", "Apple rejected it", "resubmit".