如何在Capacitor应用开发中使用AI代理

要在Capacitor应用开发中使用AI代理，给代理提供两样它缺乏的东西：通过可安装的Capacitor技能来获得Capacitor的本地侧的程序知识，通过__CAPGO_KEEP_2__ 技能,并通过__CAPGO_KEEP_3__ MCP服务器 和CLI它可以运行。通过Capgo的开源Capacitor技能和CapgoMCP服务器，代理如克劳德Code、Codex或Cursor可以添加插件，使用正确的本地配置调试iOS和Android构建，请求云构建，并上传实时更新。

本指南解释了为什么一般代理会Capacitor错误，如何在几条命令中设置技能和MCP，应用生命周期各个阶段的提示，以及保持安全的防护栏。

为什么一般用途代理会Capacitor

在 web 上，code非常强大。一个 Capacitor 项目添加了一个每年都会改变的第二部分：

• __CAPGO_KEEP_1__ Capacitor 8 changed Android SDK levels, defaults to Swift Package Manager for new iOS projects, and requires Xcode 26 for App Store uploads. Training data mixes Capacitor 3 to 8 advice.
• __CAPGO_KEEP_1__ __CAPGO_KEEP_2__ Info.plist __CAPGO_KEEP_2__ AndroidManifest.xml __CAPGO_KEEP_1__ cap sync__CAPGO_KEEP_0__ 8
• __CAPGO_KEEP_0__ 许多社区插件处于未维护状态。 一个代理会选择它经常看到的内容，而不是在Capacitor 8上工作的内容。
• __CAPGO_KEEP_0__ __CAPGO_KEEP_1__

通过提供上下文，使代理可以按需加载，并且可以调用工具，而不是猜测。

工具箱：技能、MCP和CLI

安装技能

bunx skills add Cap-go/capgo-skills

安装器检测支持的代理并将技能放置在每个代理寻找的地方。该集合涵盖插件选择、最佳实践、Capacitor 应用程序和插件主要升级（包括 v7 到 v8）、CocoaPods 到 SPM 迁移、调试、iOS 和 Android 日志、推送通知、深度链接、安全区域、安全扫描、测试、CI/CD、App Store 预检查、Cordova 和 web 应用程序迁移、Capgo 实时更新和Capgo 本机构建。 技能页面 列出每个技能。

在 Claude Code 中，您还可以使用插件市场:

claude plugin marketplace add Cap-go/capgo-skills
claude plugin install capgo-cloud@capgo-skills

连接 MCP 服务器

公共服务器不需要帐户。将其添加到 Claude Code:

claude mcp add --transport http capgo-docs https://capgo.app/mcp

CLI 服务器在本地通过 stdio 运行，并使用您的 Capgo 登录，因此首先登录：

bunx @capgo/cli@latest login
claude mcp add capgo -- bunx @capgo/cli@latest mcp

对于使用 JSON 配置 (Cursor, Windsurf, Claude Desktop) 的编辑器，等效的是：

{
  "mcpServers": {
    "capgo": {
      "command": "bunx",
      "args": ["@capgo/cli@latest", "mcp"]
    }
  }
}

CLI MCP expose 的工具包括： capgo_upload_bundle, capgo_list_channels, capgo_update_channel, capgo_check_compatibility, capgo_request_build, capgo_doctor, 和 capgo_get_stats,。完整列表在 CLI MCP 参考，和 MCP 页面 解释了何时使用哪个服务器。

在 Capacitor 生命周期中使用代理

在提示中命名技能。它使代理加载正确的程序，而不是即兴发挥。

1. 将 Web 应用转换为 Capacitor 应用

Use the webapp-to-capacitor skill to add Capacitor 8 with iOS and Android
to this Vite + React app. Keep the existing build output folder.

代理安装 @capacitor/core 并且,CLI,设置 webDir,添加平台，并运行第一次同步。对于现有的Cordova项目，使用 cordova-to-capacitor.对于Next.js，Nuxt或类似的项目，使用 framework-to-capacitor,它处理静态导出设置。

2.使用合适的插件添加本机功能

Use the capacitor-plugins skill to add biometric login.
Pick a plugin that supports Capacitor 8, configure iOS and Android,
and show me the usage code.

技能知道官方 @capacitor/* 包和 Capgo插件目录,所以代理选择一个维护的插件并添加 Info.plist 使用字符串，Android权限和同步步骤。查看diff，如任何pull请求。

3.使用真实日志调试

Use the ios-android-logs skill to capture Logcat while I reproduce the crash
on the connected Android device, then use debugging-capacitor to find the cause.

日志技能给代理提供了精确的 adb 并且支持 Xcode 命令，用于流式传输和过滤设备日志，使其读取真实的堆栈跟踪，而不是猜测源码。

4. 升级 Capacitor 并迁移到 SPM

Use the capacitor-app-upgrade-v7-to-v8 skill to upgrade this app.
Stop and show me the plan before changing native files.

然后，如果您的 iOS 项目仍然使用 CocoaPods：

Use the cocoapods-to-spm skill to move the iOS project to Swift Package Manager.

任何涉及的变化都应该先询问一个计划，这是一个好的习惯。 ios/ 或 android/在 Capawesome 比较页面上，了解我们的 Capawesome 服务。 Capacitor 8 升级指南 和 在我们的咨询服务页面上，了解我们的咨询服务。.

在 Appflow 比较/迁移营销复制中，了解我们的 Appflow 服务。

Use the capacitor-security skill to scan this project and fix high severity issues.
Then run the capacitor-apple-review-preflight skill before I submit.

. 对于手动版本的相同工作，请参阅我们的

__CAPGO_KEEP_0__ 8 升级指南。

只需自己保存一次签名凭证，不需要通过代理:

bunx @capgo/cli@latest build credentials save --platform ios \
  --certificate ./cert.p12 --p12-password "..." \
  --ios-provisioning-profile ./profile.mobileprovision \
  --apple-key ./AuthKey.p8 --apple-key-id "KEY_ID" \
  --apple-issuer-id "ISSUER_ID" --apple-team-id "TEAM_ID"

凭证存储在本地 ~/.capgo-credentials/credentials.json (或 .capgo-credentials.json 与 --local,您应该忽略它)，用于构建，并在构建完成后从 Capgo 删除。然后代理可以独立工作:

Use the capgo-native-builds skill to request an iOS release build from the
current working directory, then read the logs and fix any build error.

这对应于:

bunx @capgo/cli@latest build request com.example.app --platform ios --path .

因为 --path . 上传工作树，代理可以在Windows或Linux上从Windows或Linux上迭代iOS构建错误，而不需要提交猜测性的修复。更多关于 Capgo 构建。如果您需要证书，请使用 iOS证书生成器 。

7. 以 live update 的形式发布热修复

Use the capgo-live-updates skill to build the web app and upload it to the
beta channel. Check native compatibility first.

代理程序运行构建，然后：

bunx @capgo/cli@latest bundle upload --channel=beta

代理程序的兼容性检查将原生依赖项与设备上安装的依赖项进行比较，因此代理程序不会推送需要原生插件的构建，而该构建缺乏的商店构建 如何Capgo实时更新工作.

如何使用 __CAPGO_KEEP_0__ 的实时更新

• 保持代理程序工作的安全边界 在原生更改之前进行计划 ios/ and android/.
• 在 保存构建凭证和API密钥本身，git-ignore凭证文件，并且不要将密钥粘贴到提示中。
• 保存构建凭据和 __CAPGO_KEEP_0__ 密钥本身，git-ignore 凭据文件，并且不要将密钥粘贴到提示中 使用通道作为安全网
• 依赖回滚。 Capgo 如果新版本启动失败，会将设备回滚到最后一个工作版本的包，限制了坏上传的损害。
• 优先使用可审查的命令。 上述CLI命令在agent日志中很容易阅读。如果您不确定MCP工具执行了什么，ask agent显示等价的CLI命令。
• 保持人类在商店提交中。 agent可以准备构建和元数据。提交审查和回答审查员应该留给人类。

故障排除

上下文：支持/高级支持页面或底部支持部分。角色：部分或页面标题。见：页面support-policy.astro。消息键`support_policy_troubleshooting_title` (支持政策故障排除标题)。 agent忽略了技能。 bunx skills add Cap-go/capgo-skills).

在提示中明确命名它，并检查它是否在该agent中安装（重新运行 For the CLI 服务器，确认 bunx @capgo/cli@latest login 对于__CAPGO_KEEP_0__服务器，确认在agent运行的相同环境中成功。重新启动agent后添加服务器。

代理建议使用过时的Capacitor API。 告诉它你的Capacitor版本，并指向公共MCP以检查当前文档。

云构建因签名失败而失败。 凭证丢失或配置文件不匹配包ID。重新保存凭证并重新运行构建请求。

上传被拒绝为不兼容。 包需要本机更改。首先发送商店构建，然后live update。

总结

AI agents become useful for Capacitor once they stop guessing. Install the Capacitor skills so they follow correct procedures, connect the public Capgo MCP for docs and the CLI MCP for account actions, and keep a few guardrails around native changes, secrets, and production channels. For more on building AI features into the app itself, read 为什么Capacitor适合用于AI移动应用.