SuperAPI AI 工具集

circleci

部署与运维

查看项目

更新于 10-15 20:12

技能介绍

用途:为智能体提供从命令行调用 CircleCI CLI(circleci)的模式参考,覆盖认证、结构化输出、项目与组织定位,以及各命令对应的 v3 API 端点。

主要能力:查询项目近期运行(circleci run list)、自己的运行(circleci my runs)、单个运行及其工作流(circleci run get、circleci workflow list/get)、作业(circleci job get)、作业步骤输出(circleci job output list/get)、作业产物(circleci artifact)、测试结果(circleci testresult list)、身份(circleci auth me)、流水线定义(circleci pipeline list)、触发器(circleci project trigger list)、项目环境变量(circleci envvar list)、上下文及其密钥(circleci context list、circleci context secret list)。

使用方式:非 TTY 下 CLI 会自动跳过分页器、去除 ANSI 颜色并快速报错而非提示,无需设置 CIRCLECI_PAGER 或 --no-pager。认证用 circleci auth login,走 OAuth 流程,不要让用户提供 API token;无 TTY 时会在浏览器打开授权页并把 URL 打印到 stderr,需告知用户在浏览器批准,该命令会阻塞至多 5 分钟,应后台运行或设置较长超时;--no-browser 只打印 URL,CI 与 CIRCLE_NO_INTERACTIVE 也会抑制浏览器,此时应提供 CIRCLE_TOKEN。结构化输出加 --json,过滤用 --jq '<expr>'。项目默认从当前目录 git remote 推断,可用 --org <VCS>/<ORG> 覆盖,VCS 为 gh/bb/circleci。

限制:仅当上述命令未覆盖时才回退到 circleci api,其路径相对 /api/v3;usage/exports、analysis/、metric/、notification/、provider/、audit/* 暂无对应命令。运行 id 可用 UUID 或运行号,工作流与作业 id 为 UUID。PAGER 与 NO_COLOR 会被遵循。