用途:CI Questor 用于排查 CI/CD 流水线失败,像审查官一样收集运行证据、定位第一个有意义的失败、区分真实回归与 CI 不稳定,并给出简短报告。适用 GitHub Actions、GitLab CI、CircleCI、Jenkins 等流水线。
主要能力:确定失败的系统、仓库、分支、提交 SHA、工作流、作业与步骤;获取或读取作业日志、注解、检查摘要、工件、测试报告和配置;优先关注首个可操作错误而非末尾噪声;在首个失败理解后检查相邻测试与断言;对比前一次通过运行;检查依赖、镜像、runner、缓存、密钥、变量或外部服务是否变化;按代码回归、测试问题、依赖/工具链漂移、CI 配置、runner/基础设施、密钥/环境、外部服务、未知等分类归因;判断是否为瞬时抖动并给出证据要求。
使用方式:先加载 references/safety.md、investigation-playbook.md、report-template.md;按步骤建立运行上下文、收集证据、分类原因、决定最小有效动作、生成简洁报告。可用 gh、glab、circleci、Jenkins CLI/API;GitHub Actions 优先用 gh。用户仅说“CI 失败”时,先检查 .github/workflows/、.gitlab-ci.yml、.circleci/config.yml、Jenkinsfiles、package scripts、lockfiles 和近期 diff。
适用场景:排查失败流水线、判断是否阻塞合并/发布/部署、决定重跑或修复、编写可粘贴到 PR、Jira 或团队聊天的报告。
限制:除非用户明确要求,不修改 CI 配置、不重跑作业、不推送提交、不批准绕过、不改变远程 CI 状态。不得暴露令牌、凭据、掩码值或完整环境变量。不因重跑容易就称失败为 flaky。诊断性运行可窄范围,但 PR 就绪修复需与受影响 CI 作业对齐,否则需明确说明未验证。建议禁用失败检查前需有后续跟进和用户批准。