故障排查

找不到 create-oneapps-app

先确认 Agent 打开的是交付仓库根目录，并且已经读取仓库规则和 Skills 目录。不要只复制一段提示词到其他空仓库中运行。

让 Agent 列出当前可用 Skills、主工作流文件和缺失引用。如果目录不完整，重新检查仓库分支、子模块或交付版本。

Xcode MCP 无法连接

依次检查：

1. Xcode 和目标工程是否已经打开。
2. Xcode Settings → Intelligence 中是否允许外部 Agent 使用 Xcode 工具。
3. 当前 Xcode 是否提供 xcrun mcpbridge。
4. Codex 中的 MCP 注册命令是否指向当前命令行环境。
5. 是否完成了实际工具握手，而不是只看到配置文件。

MCP 仍不可用时，可以先用 rg、补丁、xcodebuild 和 xcrun simctl 继续本地开发，再单独处理 Xcode 上下文能力。

工程无法构建

先保留第一条真实编译错误，检查 Scheme、目标设备、依赖解析、最低系统版本和生成文件。不要在没有证据时反复清理全部缓存或批量修改工程设置。

签名或 Archive 失败

检查 Bundle ID、Team、证书、Provisioning Profile、Capabilities 和 App Groups 是否一致。确认当前配置属于这个 App，而不是模板或另一个案例 App。

Apple 登录、证书私钥、2FA 和系统钥匙串授权需要你在安全界面中完成，不能发送给 Agent。

StoreKit 购买异常

分别检查商品是否存在、协议是否生效、Bundle ID 和商品 ID 是否匹配、沙盒账号是否正确，以及取消、失败、恢复购买和权益刷新路径。客户端显示成功不能替代服务端或 StoreKit 当前权益状态。

TestFlight 上传失败

先读取上传工具返回的具体错误。常见检查项包括版本号与构建号、签名、图标、隐私清单、受限 API、出口合规和 App Store Connect 中的 App 记录。

上传成功后仍要等待 Apple 处理构建。处理中的构建不等于上传失败。

App Store 审核被拒

先获取完整的审核消息和对应版本，不要根据印象修改。让 Agent 对照当前代码、商店资料、截图和审核说明定位原因，完成修复和验证后再上传新构建或回复审核。

审核时长和结果由 Apple 决定，工作流不能保证通过。

后端或 Cloudflare 异常

先区分本地 App、网络、鉴权、环境变量、服务端接口和云端部署问题。检查当前 App 使用的环境和域名，避免把测试配置带到生产环境。

仍然无法解决

添加微信 makerjackie，提供：

• 使用的交付版本和目标 App。
• 出错阶段。
• 第一条真实错误信息。
• 已经运行的检查及结果。
• 不包含密码、验证码、私钥和会话的必要截图。