axiom-shipping

发布与 App Store

准备提交任何 App、处理 App Store 审核拒绝，或执行发布工作流时，必须使用此技能。

**Claude Code 中捆绑的工具：**如果 command -v <tool> 未找到任何内容（钩子已关闭或使用了 --bare），请改用 <plugin-root>/tools/<tool>，而不是裸工具名；<plugin-root> 是此技能的 Base directory for this skill: 路径向上两级的目录。

无法启动 Axiom Agent？ 当此路由器将你指向某个 Agent 时，请直接按照其流程操作。通过 MCP，axiom_get_agent 会返回相应内容；在其他环境中，请读取下方对应文件，只需搜索和读取文件即可。

位于另一个套件中：axiom-integration/skills/iap-auditor.md、axiom-security/skills/security-privacy-scanner.md。

对于其他 Agent，通过 MCP 使用 axiom_get_agent 也会返回相应内容；请使用 axiom_xclog_*、axiom_xcsym_* 和 axiom_xcprof_* 工具执行其 xclog、xcsym 和 xcprof 步骤。在其他环境中，请在 Axiom 的技能中搜索 skills/<agent>.md；如果没有该文件，请使用此套件的技能自行完成相关工作，并使用 PATH 中的任意 Axiom 工具。

适用场景

遇到以下情况时，请使用此技能：

• 准备提交 App Store 应用
• App Store 审核拒绝（任何指南条款）
• 元数据要求（屏幕截图、描述、关键词）
• 隐私清单和营养标签相关问题
• 年龄分级和内容分类
• 出口合规和加密声明
• 欧盟《数字服务法案》（DSA）商家身份
• 账户删除或“通过 Apple 登录”要求
• 构建上传和处理问题
• App 审核申诉
• WWDC25/WWDC26 App Store Connect 变更
• 首次提交工作流

快速参考

症状 / 任务	参考资料
如何提交我的应用？	参见 skills/app-store-submission.md
提交前检查清单	参见 skills/app-store-submission.md
首次提交	参见 skills/app-store-submission.md
加密合规性	参见 skills/app-store-submission.md
辅助功能营养标签	参见 skills/app-store-submission.md
元数据字段要求	参见 skills/app-store-ref.md
产品页面标题、素材库、搜索视觉素材 OS27	参见 skills/app-store-ref.md（第 11 部分）
留存消息（订阅取消流程）OS27	参见 skills/app-store-ref.md（第 11 部分）
群组 / 批量订阅销售（ABM、ASM、批量定价）OS27	参见 skills/app-store-ref.md（第 11 部分）
指南编号查询	参见 skills/app-store-ref.md
隐私清单架构	参见 skills/app-store-ref.md
年龄分级	参见 skills/app-store-ref.md
欧盟 DSA 合规性	参见 skills/app-store-ref.md
WWDC25/WWDC26 ASC 变更	参见 skills/app-store-ref.md
应用被拒	参见 skills/app-store-diag.md
指南 2.1/4.2/4.3 拒绝	参见 skills/app-store-diag.md
撰写申诉	参见 skills/app-store-diag.md
多次被拒	参见 skills/app-store-diag.md
App Review Guidelines 参考	参见 skills/app-review-guidelines.md
专家审核清单	参见 skills/expert-review-checklist.md
App Store Connect 中的崩溃数据	参见 skills/app-store-connect-ref.md
TestFlight 崩溃报告	参见 skills/app-store-connect-ref.md
ASC 指标仪表板	参见 skills/app-store-connect-ref.md
Beta 测试者崩溃报告、本地 Organizer 崩溃存档（.xccrashpoint）	参见 skills/testflight-triage.md
生产环境存档分诊（Sentry、ASC — 多个归组问题）	参见 skills/production-triage.md + triage-analyzer Agent 或 /axiom:triage
崩溃日志符号化（.ips / MetricKit / .crash）	参见 axiom-tools（skills/xcsym-ref.md）或 /axiom:analyze-crash；完整 TF 工作流参见 skills/testflight-triage.md
自动化 App Store Connect	参见 skills/asc-mcp.md
以编程方式提交构建版本	参见 skills/asc-mcp.md
通过 MCP 管理 TestFlight	参见 skills/asc-mcp.md
上传时出现 ITMS 签名错误	参见 axiom-security（skills/code-signing-diag.md）
证书 / 配置文件不匹配	参见 axiom-security（skills/code-signing-diag.md）
代码签名设置	参见 axiom-security（skills/code-signing.md）
App Clips（大小等级、调用方式、AASA、启动体验）	参见 skills/app-clips.md
App Clip 权限 / 大小 / 数据共享参考	参见 skills/app-clips-ref.md
Apple Pay / Wallet / Tap to Pay 支付	参见 axiom-payments 套件
随 Claude 模型 ID 变更（4.6 → 4.7 等）发布更新	参见 claude-api 技能（外部）+ 本技能以提交应用
在应用中切换云 AI 提供商（OpenAI → Claude 等）	参见 claude-api 技能（外部）+ 本技能以提交应用

路由逻辑

1. 提交前准备 → app-store-submission

触发条件：

• “如何提交我的应用？”
• “提交前需要准备什么？”
• 准备首次提交
• 需要提交前检查清单
• 截图要求
• 元数据完整性检查
• 加密合规性问题
• 辅助功能营养标签
• 提交所需的隐私清单要求

为何使用 app-store-submission：这是一项包含 8 个反模式、决策树和压力场景的规范技能。它能避免导致 90% 拒绝的错误。

参考资料：skills/app-store-submission.md

---

2. 元数据、指南和 API 参考 → app-store-ref

触发条件：

• “App Store Connect 中需要哪些字段？”
• “应用描述的最大长度是多少？”
• 查询特定指南编号
• 隐私清单架构详情
• 年龄分级层级和问卷
• IAP 提交元数据
• EU DSA 合规详情
• 构建上传方式
• WWDC25 和 WWDC26 对 App Store Connect 的变更

为什么选择 app-store-ref：涵盖所有元数据字段、指南和合规要求的 11 部分参考资料，包含精确规格。

参考：skills/app-store-ref.md

---

3. 拒绝审核问题排查 → app-store-diag

触发条件：

• “我的应用被拒绝了”
• “指南 2.1 拒绝”
• “二进制文件被拒绝了”
• 指南 4.2 或 4.3 拒绝（应用过于简单、网页封装、垃圾内容、重复应用）
• 指南 1.x 拒绝（不当内容、UGC 审核、儿童类别）
• 如何回复拒绝通知
• 撰写申诉
• 理解拒绝消息
• 第三次或多次被拒
• Resolution Center 沟通

为什么选择 app-store-diag：包含 9 种诊断模式，将拒绝类型对应到根本原因和修复方法，其中包括主观性较强的拒绝（4.2/4.3、1.x）。还提供申诉撰写指导，以及应对多次被拒的危机场景处理方法。

参考：skills/app-store-diag.md

---

4. 隐私与安全合规 → security-privacy-scanner（Agent）

触发条件：

• “提交前扫描我的代码，检查隐私问题”
• 硬编码的 API 密钥或机密
• 缺少隐私清单
• 必需的 Reason API 声明
• ATS 违规

为什么选择 security-privacy-scanner：自主 Agent，可扫描会导致拒绝审核的安全漏洞和隐私合规问题。

调用方式：启动 security-privacy-scanner agent 或 /axiom:audit security

---

5. IAP 审核问题 → iap-auditor（Agent）

触发条件：

• IAP 被拒绝或无法使用
• 缺少 transaction.finish()
• 缺少恢复购买功能
• 订阅跟踪问题

为什么选择 iap-auditor：扫描 IAP 代码，查找会导致 StoreKit 拒绝审核的模式。

调用方式：启动 iap-auditor agent

---

6. 屏幕截图验证 → screenshot-validator（Agent）

触发条件：

• “检查我的 App Store 屏幕截图”
• “我的屏幕截图尺寸是否正确？”
• “提交前验证屏幕截图”
• “审核我的营销屏幕截图”
• 屏幕截图内容或尺寸相关问题

为什么选择 screenshot-validator：多模态 Agent，可直观检查每张屏幕截图，查找占位文本、尺寸错误、调试残留、UI 损坏和竞争对手相关内容。能发现人工审核容易遗漏的问题。

调用方式：启动 screenshot-validator agent 或 /axiom:audit screenshots

---

7. 以编程方式访问 ASC → asc-mcp

触发条件：

• “自动化 App Store Connect”
• “以编程方式提交构建”
• “通过 Claude 管理 TestFlight”
• “通过 API 回复评价”
• “设置 asc-mcp”
• “通过 MCP 分发到 TestFlight 群组”
• “不打开 ASC 就创建新版本”

为什么选择 asc-mcp：专注于工作流的技能，指导 Claude 使用 asc-mcp MCP 工具管理发布流水线、TestFlight 分发、评价管理和反馈分类，所有操作都无需离开 Claude Code。

参考：skills/asc-mcp.md

---

8. 提交后监控 → app-store-connect-ref

触发条件：

• “如何在 App Store Connect 中查看崩溃数据？”
• “TestFlight 崩溃报告在哪里？”
• “如何读取 ASC 指标仪表板？”
• 发布后的崩溃调查
• 从 ASC 下载崩溃日志

为什么选择 app-store-connect-ref：提供 ASC 导航指南，涵盖崩溃仪表板、TestFlight 反馈、性能指标和数据导出工作流。

参考：skills/app-store-connect-ref.md

---

9. Beta 崩溃分流 → testflight-triage

触发条件：

• Beta 测试人员报告崩溃
• 崩溃出现在 Organizer 或 App Store Connect 中
• 需要对崩溃日志进行符号化
• 发布后崩溃调查（单个文件或 Organizer）

为何使用 testflight-triage：从符号化到根因分析，系统地进行崩溃分流。首先使用 xcsym（解析 → 查找 dSYM → 符号化 → 使用 pattern_tag 分类 → 输出结构化 JSON）。

参考：skills/testflight-triage.md。有关 xcsym 子命令和退出代码的参考，请参阅 axiom-tools (skills/xcsym-ref.md)。有关一次调用即可完成的 Agent 工作流，请参阅 /axiom:analyze-crash。

---

10a. 生产环境问题集分流 → production-triage / triage-analyzer

触发条件：

• “对我的 Sentry 崩溃进行分流”
• “生产环境中有哪些主要崩溃类别？”
• “显示我应该优先修复 App Store Connect 中的哪些问题”
• 来自聚合器（Sentry、ASC）的多个分组问题——数十个问题，而不是单个文件
• “这些崩溃中哪些是真正的 Bug，哪些只是噪声？”
• 问题集级别的卡死分流（“我的 ANR 报告是真的发生阻塞了吗？”）

为何使用 production-triage：问题集级别的分流需要从聚合器获取数据、对每个问题分类、将挂起误报标记为噪声，并按根因类别聚类。testflight-triage 负责 Organizer 流程——单个文件和本地磁盘上的 .xccrashpoint 问题集；production-triage 负责聚合器流程（Sentry / ASC 分组问题）。

参考：skills/production-triage.md（获取数据 + NormalizedReport 架构 + 绝不隐藏标记规则）。Agent：triage-analyzer 或 /axiom:triage sentry / /axiom:triage asc。

---

10. 分发签名问题 → code-signing / code-signing-diag

触发条件：

• 上传时出现 ITMS-90035 Invalid Signature
• ITMS-90161 Invalid Provisioning Profile
• 归档时提示“No signing certificate found”
• 证书在提交前过期
• 归档成功，但导出或上传失败
• 描述文件与 bundle ID 不匹配
• 上传时出现 Entitlement 不匹配

为何使用 code-signing：分发签名错误是上传失败的首要原因。使用 CLI 工具诊断只需 5 分钟。code-signing-diag 包含 6 个决策树，可将 ITMS 错误映射到根因。

参考：排查问题请参阅 axiom-security (skills/code-signing-diag.md)，或参阅 axiom-security (skills/code-signing.md) 进行设置。

---

11. App Clips → app-clips

触发条件：

• 添加 App Clip 目标，或选择调用方式
• “App Clip 的大小限制是多少？” / 构建产物超过最大大小
• App Clip 链接的关联域名 / AASA
• App Store Connect 默认和高级启动体验
• 升级时将 App Clip 数据交接给完整应用
• “我的 App Clip 链接没有任何反应”

为何使用 app-clips：App Clips 内嵌在完整应用中，并受到严格的大小（10/15/100 MB）、Entitlement 和功能限制。该指南涵盖大小档位、Entitlement、AASA 和数据交接；参考文档中包含相关表格。

参考：skills/app-clips.md、skills/app-clips-ref.md

---

决策树

digraph shipping {
    "Shipping question?" [shape=diamond];
    "Rejected?" [shape=diamond];
    "Post-submission monitoring?" [shape=diamond];
    "Beta crash triage?" [shape=diamond];
    "Automate via MCP?" [shape=diamond];
    "Screenshot review?" [shape=diamond];
    "Need specific specs?" [shape=diamond];
    "IAP issue?" [shape=diamond];
    "Want code scan?" [shape=diamond];
    "Signing error?" [shape=diamond];

    "skills/app-store-submission.md" [shape=box, label="app-store-submission\n(pre-flight checklist)"];
    "skills/app-store-ref.md" [shape=box, label="app-store-ref\n(metadata/guideline specs)"];
    "skills/app-store-diag.md" [shape=box, label="app-store-diag\n(rejection troubleshooting)"];
    "skills/app-store-connect-ref.md" [shape=box, label="app-store-connect-ref\n(ASC dashboards/metrics)"];
    "skills/testflight-triage.md" [shape=box, label="testflight-triage\n(beta crash triage)"];
    "security-privacy-scanner" [shape=box, label="security-privacy-scanner\n(Agent)"];
    "iap-auditor" [shape=box, label="iap-auditor\n(Agent)"];
    "screenshot-validator" [shape=box, label="screenshot-validator\n(Agent)"];
    "skills/asc-mcp.md" [shape=box, label="asc-mcp\n(MCP tool workflows)"];
    "axiom-security/code-signing" [shape=box, label="axiom-security\n(distribution signing)"];

    "Shipping question?" -> "Rejected?" [label="yes, about to submit or general"];
    "Rejected?" -> "skills/app-store-diag.md" [label="yes, app was rejected"];
    "Rejected?" -> "Post-submission monitoring?" [label="no"];
    "Post-submission monitoring?" -> "skills/app-store-connect-ref.md" [label="yes, crash data/metrics"];
    "Post-submission monitoring?" -> "Beta crash triage?" [label="no"];
    "Beta crash triage?" -> "skills/testflight-triage.md" [label="yes, beta crash/symbolication"];
    "Beta crash triage?" -> "Automate via MCP?" [label="no"];
    "Automate via MCP?" -> "skills/asc-mcp.md" [label="yes, programmatic ASC access"];
    "Automate via MCP?" -> "Screenshot review?" [label="no"];
    "Screenshot review?" -> "screenshot-validator" [label="yes, validate screenshots"];
    "Screenshot review?" -> "Need specific specs?" [label="no"];
    "Need specific specs?" -> "skills/app-store-ref.md" [label="yes, looking up field/guideline"];
    "Need specific specs?" -> "IAP issue?" [label="no"];
    "IAP issue?" -> "iap-auditor" [label="yes"];
    "IAP issue?" -> "Want code scan?" [label="no"];
    "Want code scan?" -> "Signing error?" [label="no"];
    "Want code scan?" -> "security-privacy-scanner" [label="yes, scan for privacy/security"];
    "Signing error?" -> "axiom-security/code-signing" [label="yes, ITMS/cert/profile error"];
    "Signing error?" -> "skills/app-store-submission.md" [label="no, general prep"];
}

简化版：

1. 应用被拒绝了？→ skills/app-store-diag.md
2. 提交后需要查看崩溃数据/指标？→ skills/app-store-connect-ref.md
3. Beta 版崩溃排查/符号化（Organizer 或单个文件）？→ skills/testflight-triage.md
4. 生产环境中的问题集排查（Sentry/ASC，多个归类的问题）？→ skills/production-triage.md + triage-analyzer Agent
5. 需要通过 MCP 工具自动化操作 ASC？→ skills/asc-mcp.md
6. 需要验证截图？→ screenshot-validator（Agent）
7. 需要特定的元数据/指南规范？→ skills/app-store-ref.md
8. IAP 提交问题？→ iap-auditor（Agent）
9. 想在提交前扫描代码？→ security-privacy-scanner（Agent）
10. 上传时出现 ITMS 签名/证书/描述文件错误？→ 参见 axiom-security（skills/code-signing-diag.md）
11. 常规提交准备？→ skills/app-store-submission.md
12. App Clip（大小级别、调用方式、AASA、数据交接）？→ skills/app-clips.md、skills/app-clips-ref.md

特定平台的提交要求

• watchOS 26 SDK 要求、64 位、独立 App 提交 → 参见 axiom-watchos（skills/platform-basics.md）

避免自我合理化

想法	实际情况
“我直接提交看看结果就行”	40% 的拒绝源于指南 2.1（完整性）。app-store-submission 可在 10 分钟内发现这些问题。
“我以前提交过应用，知道流程”	要求每年都会变化。隐私清单、年龄分级、欧盟 DSA、无障碍营养标签都是 2024 年后新增的要求。
“这次拒绝不合理，我直接重新提交”	不做任何修改就重新提交，每轮都会浪费 24-48 小时。app-store-diag 可找到根本原因。
“隐私清单只适用于大型应用”	自 2024 年 5 月起，每个使用必需理由 API 的应用都需要清单。缺少清单会导致自动拒绝。
“我之后再补充元数据”	缺少元数据会完全阻止提交。app-store-ref 列出了所有字段。
“这只是一个错误修复，不需要完整清单”	错误修复更新仍需填写“更新内容”文本、使用正确的截图，并确保构建有效。app-store-submission 涵盖了这些内容。
“我自己看看截图就行”	人工审核容易漏掉尺寸不匹配（即使只差 1px 也会被拒）、不易察觉的占位文本和调试标记。漏掉一个问题就会让重新提交多花 24-48 小时。screenshot-validator 可在 2 分钟内发现这些问题。
“我直接在 ASC 网页控制面板上操作就行”	如果已配置 asc-mcp，使用 MCP 工具进行批量操作更快，例如分发构建版本、回复审核意见、创建版本。asc-mcp 提供相应的工作流。
“上传时出现 ITMS 错误，我重新归档就行”	ITMS 签名错误属于配置问题，例如证书错误、描述文件过期或缺少权利。使用相同配置重新归档会得到相同结果。code-signing-diag 提供了修复方法。
“这只是替换模型 ID（Claude 4.6 → 4.7）”	4.6 → 4.7 从 Messages API 中移除了 temperature、top_p、top_k 和预填充内容。构建会成功，但提交后运行时会返回 HTTP 400。请阅读 claude-api（外部），并在上传前测试线上端点。
“我的 App Clip 可以有 100 MB，所以我还会添加 App Clip Code”	100 MB 级别（iOS 17+）仅适用于数字调用；添加任何 NFC/QR/App Clip Code 都会将上限降至 15 MB。参见 skills/app-clips.md。

外部资源

Cloud Claude 迁移（claude-api 技能，随 Axiom 之外的产品提供）——发布任何 Claude 模型 ID 变更前都必须完成。 Opus 4.7 从 Messages API 中移除了 temperature、top_p、top_k 和预填充内容；在 4.6 上成功构建的代码，运行时会返回 HTTP 400。发布了这一回归问题的 App Store 更新需要加急审核。claude-api 技能可自动完成迁移（替换模型 ID、移除采样参数、替换预填充内容），并从第一天起强制启用提示词缓存。请将其纳入发布前检查清单，而非视为可选参考资料。

不适用场景（冲突解决）

以下情况请勿使用 axiom-shipping — 请改用正确的技能：

问题	正确的技能	为什么不使用 axiom-shipping
归档前构建失败	axiom-build	这是环境／构建问题，而非提交问题
SwiftData 迁移崩溃	axiom-data	这是架构问题，而非 App Store 问题
编写隐私清单（编写文件）	axiom-build	security-privacy-scanner 用于代码扫描
StoreKit 2 实现（编写 IAP 代码）	axiom-integration	in-app-purchases / storekit-ref 涵盖实现
测试期间发现性能问题	axiom-performance	这是性能分析问题，而非提交问题
无障碍功能实现	axiom-accessibility	这是代码层面的无障碍功能，而非 App Store 标签

axiom-shipping 用于提交工作流，而非代码实现：

• 准备元数据和合规材料 → axiom-shipping
• 编写实际代码 → 特定领域的技能（axiom-build、axiom-data 等）
• 应用被拒 → axiom-shipping
• 修改代码以解决拒绝原因 → 使用特定领域的技能，然后返回 axiom-shipping 进行验证

示例调用

用户：“如何将我的应用提交到 App Store？” → 参阅 skills/app-store-submission.md

用户：“我的应用因 Guideline 2.1 被拒了” → 参阅 skills/app-store-diag.md

用户：“我需要准备哪些截图？” → 参阅 skills/app-store-ref.md

用户：“App Store Connect 中哪些字段是必填的？” → 参阅 skills/app-store-ref.md

用户：“如何填写年龄分级问卷？” → 参阅 skills/app-store-ref.md

用户：“我需要提交加密合规声明吗？” → 参阅 skills/app-store-submission.md

用户：“我的应用总是被拒，该怎么办？” → 参阅 skills/app-store-diag.md

用户：“如何申诉 App Store 拒审？” → 参阅 skills/app-store-diag.md

用户：“我的应用因 Guideline 4.2 最低功能要求被拒了” → 参阅 skills/app-store-diag.md

用户：“因网页封装应用／重复应用被拒” → 参阅 skills/app-store-diag.md

用户：“因用户生成内容未经过审核而被拒” → 参阅 skills/app-store-diag.md

用户：“儿童类别合规问题导致被拒” → 参阅 skills/app-store-diag.md

用户：“扫描我的代码，检查 App Store 合规问题” → 启动 security-privacy-scanner agent

用户：“提交前检查我的 IAP 实现” → 启动 iap-auditor agent

用户：“检查我 ~/Screenshots 中的 App Store 截图” → 启动 screenshot-validator agent

用户：“我的截图尺寸正确吗？” → 启动 screenshot-validator agent

用户：“对我的 Sentry 崩溃问题进行分类” → 启动 triage-analyzer agent（或运行 /axiom:triage sentry）

用户：“目前生产环境中最常见的崩溃类型有哪些？” → 启动 triage-analyzer agent（或运行 /axiom:triage sentry）

用户：“告诉我应该先修复哪些 ASC 问题” → 启动 triage-analyzer agent（或运行 /axiom:triage asc）

用户：“如何在 App Store Connect 中查找崩溃数据？” → 参阅 skills/app-store-connect-ref.md

用户：“我的 TestFlight 崩溃报告在 ASC 中的哪里？” → 参阅 skills/app-store-connect-ref.md

用户：“今年 App Store Connect 有什么新变化？” → 参阅 skills/app-store-ref.md

用户：“我需要为欧盟设置 DSA 商家身份” → 参阅 skills/app-store-ref.md

用户：“什么是无障碍营养标签？” → 参阅 skills/app-store-submission.md

用户：“这是我第一次提交应用” → 参阅 skills/app-store-submission.md

用户：“以编程方式将此构建版本提交到 App Store” → 参阅 skills/asc-mcp.md

用户：“为 App Store Connect 设置 asc-mcp” → 参阅 skills/asc-mcp.md

用户：“通过 MCP 将构建版本 42 分发给我的 Beta 测试人员” → 参阅 skills/asc-mcp.md

用户：“通过 Claude 回复负面的 App Store 评论” → 参阅 skills/asc-mcp.md

用户：“上传时出现 ITMS-90035 Invalid Signature” → 参阅 axiom-security（skills/code-signing-diag.md）

用户：“我的 provisioning profile 已过期，无法上传” → 参阅 axiom-security（skills/code-signing-diag.md）

用户：“如何添加 App Clip？”／“App Clip 的大小限制是多少？”／“我的 App Clip 链接不起作用” → 参阅 skills/app-clips.md