用途:当 PR 的 CI 检查失败、用户提供 CircleCI 链接(如 https://circleci.com/gh/org/repo/169955)或要求排查 CI 失败时,用该技能获取作业的分步日志,聚焦失败步骤。
主要能力:从 URL 提取 org、repo、job_number;若只给 job number,则通过 git remote get-url origin 推断仓库;读取 ~/.circleci/cli.yml 中的 token;调用 CircleCI v1.1 API 获取作业数据,逐步骤打印名称、状态、退出码,并对失败步骤通过 output_url 拉取输出,每条消息截断至 2000 字符;最后汇总哪些步骤失败、相关错误信息及可能的修复建议。
使用方式:先确认 token 存在,命令为 grep 'token' ~/.circleci/cli.yml | awk '{print $2}';若文件不存在或无 token,需运行 circleci setup 或手动设置。随后以单条命令替换 {org}、{repo}、{job_number} 调用 API v1.1 并解析输出。
限制与注意:必须使用 API v1.1,v2 不返回带日志 URL 的分步输出;output_url 是预签名 S3 地址,无需额外认证;若返回 404,可能是 job number 错误或 token 无权访问该项目。完成检查清单(token、org/repo/job number、v1.1、已汇总失败原因)前不要给出修复建议。