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 为必填项；每次查询一个软件包。

响应字段：

  • 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