Ankra Docs

Cursor 和 Claude Code 的 Ankra 插件

适用于 Cursor 和 Claude Code 的 Ankra 插件。它将 Agent 连接到托管的 Ankra MCP 服务，并添加 Ankra 的 Agent 技能和斜杠命令，用于通过 Ankra 构建、发布和运维 Kubernetes。

对于 Claude Code，请在终端中运行：

claude plugin install ankra --marketplace ankraio/cursor-plugin

使用插件：请参阅 plugins/ankra/README.md。

目录结构

.cursor-plugin/marketplace.json   Cursor marketplace manifest
.claude-plugin/marketplace.json   Claude Code marketplace manifest
plugins/ankra/
  .cursor-plugin/plugin.json      Cursor plugin manifest
  .claude-plugin/plugin.json      Claude Code plugin manifest
  mcp.json                        the hosted Ankra MCP server for Cursor (browser sign-in)
  .mcp.json                       the same server for Claude Code
  rules/ankra.mdc                 when and how to work through Ankra (Cursor only)
  skills/                         generated from ankra-cli, do not edit here
  commands/                       generated from ankra-cli, do not edit here
  assets/logo.svg
  SOURCE                          the ankra-cli release the skills and commands came from
scripts/
  sync-from-cli.sh                regenerate skills and commands
  sync-latest-release.sh          download, verify and sync a release (used by the scheduled workflow)
  validate-template.mjs           Cursor's plugin validator, from cursor/plugin-template

更新技能和命令

技能和命令在 ankraio/ankra-cli（internal/skills）中维护，也通过 ankra skills install 分发。在那里进行修改，发布 CLI 版本，然后从该版本重新生成此插件：

brew upgrade ankra            # the installed CLI must match the release
scripts/sync-from-cli.sh      # defaults to the installed CLI's version
node scripts/validate-template.mjs

当插件内容发生变化时，请更新 plugins/ankra/.cursor-plugin/plugin.json 和 plugins/ankra/.claude-plugin/plugin.json 中的 version。两者必须保持一致；CI 会进行检查。Claude Code 用户会继续使用同一版本，直到版本号变更，因此如果内容变更却未更新版本号，这些变更就无法送达他们。

此流程也会自动运行：Sync from ankra-cli release 工作流（.github/workflows/sync-from-cli.yml）每天早上检查 ankra-cli 的最新稳定版本。如果该版本比 plugins/ankra/SOURCE 中记录的版本更新，scripts/sync-latest-release.sh 会下载该版本的二进制文件、验证其校验和、重新生成技能和命令、递增次版本号并进行验证，然后工作流会从 sync/ankra-cli-release 创建或更新拉取请求。它只使用此代码库的 GITHUB_TOKEN。可在 Actions 选项卡中手动运行，也可以选择指定 tag 或设置为 dry_run。同一脚本也可在本地运行，无需安装 ankra：

scripts/sync-latest-release.sh            # latest stable release
scripts/sync-latest-release.sh v0.30.0    # a specific release

本地测试

Claude Code：

claude plugin validate --strict plugins/ankra
claude plugin validate .
claude --plugin-dir plugins/ankra

Cursor：

mkdir -p ~/.cursor/plugins/local
cp -R plugins/ankra ~/.cursor/plugins/local/ankra-marketplace

重新加载 Cursor（Developer: Reload Window），并检查规则、技能、命令和 ankra MCP 服务是否出现。如果 ankra skills install 已写入本地 ankra 插件，请在测试时将其移开，以免两个插件互相重叠。

许可证

Apache-2.0