Ankra Docs

Cursor および Claude Code 用 Ankra プラグイン

Cursor および Claude Code 用の Ankra プラグインです。エージェントをホスト型の Ankra MCP サーバーに接続し、Ankra を通じて Kubernetes を構築、リリース、運用するための Ankra のエージェントスキルとスラッシュコマンドを追加します。

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 を更新してください。2 つの値は同じにしてください。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