SuperAPI AI 工具集

circleci-cli

部署与运维

查看项目

更新于 10-16 09:48

技能介绍

用途:当需要快速通过 CircleCI CLI 进行操作或排查(而非先编辑配置文件)时使用本技能。整体原则是先安全只读诊断,确认范围后再执行针对性的变更命令。

需要收集的信息:仓库路径与目标分支;CircleCI 项目 slug(如需要);目标是查看、重跑、触发还是校验;所需的令牌/认证状态与组织权限。

工作流程:

  1. 验证 CLI 与认证状态:确认 circleci 已安装且版本可用;在执行远程命令前确认令牌/认证。
  2. 先做只读诊断:查看可用的流水线/项目/触发器状态并记录具体标识符;在重跑或触发前,从命令输出中提取首个失败范围与步骤细节。
  3. 在相关时本地校验配置:在提交有风险的修改前先运行配置校验/处理命令。
  4. 执行针对性变更:只重跑所需的工作流/任务范围;触发流水线时明确指定参数与分支上下文。
  5. 报告结果与下一步:给出确切的命令结果、剩余阻塞项和最安全的后续操作。

限制与护栏:重跑/触发/取消前优先使用只读命令;变更流水线状态前确认组织/项目范围;切勿输出环境变量或令牌中的原始密钥值;权限失败时报告确切的认证/范围缺口与最安全的补救方式;遵循所安装 CLI 的实际能力,不要臆造命令;除非 circleci help 确认存在,不要使用 circleci api、circleci workflow 等不可用的旧命令。

已安装 CLI 兼容性:对于较新的构建,可能提供域名子命令(如 pipeline、project、trigger)但不再提供 api。应先运行 circleci help 验证可用命令,只使用 help 输出中发现的子命令;流水线操作优先使用 circleci pipeline list|create|run 与 circleci trigger ...。若 CLI 未提供日志命令,云上任务日志可借助平台工具(CircleCI 应用/界面或对接的 CircleCI MCP 工具)。

输出约定:给出已运行的命令及目的;关键输出(流水线/工作流/任务 ID、状态、失败步骤);所采取的操作(重跑/触发/校验)及原因;剩余阻塞项与建议的下一条 CLI 命令。