SuperAPI AI 工具集

pulumi-neo

部署与运维

查看项目

更新于 10-15 21:10

技能介绍

用途:通过自然语言与 Pulumi Neo 交互,完成云基础设施的分析、维护操作、配置变更及多步工作流。

前置条件:需要具备 Neo 访问权限的 Pulumi Cloud 账户;设置 PULUMI_ACCESS_TOKEN 环境变量(Personal Access Token);所有 Neo API 调用都需指定组织。可用 pulumi org get-default 获取当前组织,若无默认组织或使用自管理后端,则需向用户询问 Pulumi Cloud 组织名。

使用方式:在 Claude Code 中务必加 --no-poll 以避免阻塞。首选 Python 脚本调用:python <skill-base-directory>/scripts/neo_task.py --org <org> --message "Your message" --no-poll。也可直接调用 API:向 https://api.pulumi.com/api/preview/agents/<org>/tasks 发送 POST 请求,请求头包含 Authorization: token $PULUMI_ACCESS_TOKEN、Accept: application/vnd.pulumi+8、Content-Type: application/json;查询事件用 GET .../tasks/<task-id>/events。若已安装 Pulumi MCP 服务器,可用 mcp__pulumi__neo-bridge、mcp__pulumi__neo-get-tasks、mcp__pulumi__neo-continue-task 工具。

主要能力:创建任务(分析、维护、配置变更、多步工作流);附加实体上下文(stack 的 name+project、repository 的 name+org+forge、pull_request、policy_issue);列出任务(--list)、获取事件(--task-id 加 --get-events)、轮询已有任务;审批或取消待确认操作。任务状态有 running(处理中)与 idle(等待输入或已完成),任务完成与审批请求需检查事件而非状态:在 agentResponse 事件的 tool_calls 中查找 approval_request,其参数中取 approval_request_id,再以 --approve 或 --cancel 响应。Neo 不会在未确认前执行破坏性变更。

适用场景:安全分析、修复策略违规、生成 Pulumi 代码、审查 Pull Request 等。

限制:需要有效令牌与正确组织;401 表示令牌无效/缺失(可用 curl -s -H "Authorization: token $PULUMI_ACCESS_TOKEN" https://api.pulumi.com/api/user 验证);404 表示组织或端点错误;409 表示任务繁忙。脚本挂起通常因缺少 --no-poll。其他收费、价格、平台细节暂未提供。