mcpField
P
package-usage

package-usage

github.com/pulumiクラウド・DevOps78835 回インストール3 週間前に更新
リポジトリ

package-usage について

package-usageは、Pulumi APIのコマンドラインを通じてPulumi Cloudのパッケージバージョンとスタック利用状況を調べるスキルです。パッケージを使うスタックを特定し、最新バージョンより古いスタックを見つけられます。

主な機能

  1. 01パッケージバージョンの照会
  2. 02組織から見えるパッケージの一覧
  3. 03パッケージ利用スタックの取得
  4. 04スタックと最新バージョンの比較

活用シーン

  1. 01指定パッケージを使うスタックの特定
  2. 02古いバージョンのスタックの検出
  3. 03組織内のパッケージ利用状況の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/pulumi/agent-skills --skill package-usage

インストール後、Claude Code で/package-usageを入力して読み込まれたか確認します。

同梱ファイルagents/openai.yamluse_cases.yaml

詳細

API リファレンス

pulumi api CLI サブコマンドを使用して、Pulumi Cloud API にクエリします。既存の Pulumi 認証情報で認証し、JSON を返します。

パッケージの最新バージョンを取得する
pulumi api /api/registry/packages -F name={package_name} -F orgLogin={orgName}

ユーザーの組織名を指定して orgLogin を含めます。組織から見えるすべてのパッケージを一覧表示するには、-F name=... を省略します（ユーザーが特定のパッケージ名を指定していない場合に便利です）。レスポンスには packages 配列が含まれます。各エントリには、version フィールド（最新バージョン）に加えて、name、publisher、source、packageStatus があります。

パッケージのスタック使用状況を取得する
pulumi api /api/orgs/{orgName}/packages/usage -F packageName={package_name}

{orgName} をコンテキスト内の組織名、PULUMI_ORG の値、またはユーザーに確認した組織名に置き換えます。packageName は必須です。一度にクエリできるパッケージは 1 つです。

レスポンスフィールド：

  • packageName：クエリ対象のパッケージ
  • stacks：{stackName, projectName, version, lastUpdate} の配列
  • totalStacks：合計数

ワークフロー：古いスタックを見つける

ユーザーが、パッケージの古いバージョンを使用しているスタックを知りたい場合に使用します。

  1. パッケージの最新バージョンを取得する
  2. パッケージのスタック使用状況を取得する
  3. 各スタックの version を最新バージョンと比較し、古いスタックを特定する
  4. 以下の出力形式で結果を提示する

出力形式

Markdown の表に続けて、要約行を提示します。

| Project | Stack | Current Version | Latest Version | Status |
|---------|-------|-----------------|----------------|--------|
| my-app  | dev   | 6.40.0          | 6.52.0         | Outdated |
| my-app  | prod  | 6.52.0          | 6.52.0         | Up-to-date |

2 of 2 stacks checked. 1 outdated.

対象外：特定のスタックのアップグレード

このスキルは古いスタックを特定します。アップグレード自体は実行しません。プロジェクトのパッケージバージョンを実際に上げるために、package.json、requirements.txt、pyproject.toml、go.mod、または Pulumi.yaml を編集し、pulumi preview を実行して差分を調整する作業は、provider-upgrade スキルに引き継いでください。

コメント

Markdown 対応