circleci-builds

CircleCI 构建

概述

使用此技能将失败的 CircleCI 流水线转化为有据可依、可执行的修复方案。优先快速隔离根因、实施最小且安全的补丁，并明确验证标准。

判断失败应通过代码／配置修复、重试、通过重新运行来缓解，还是报告为外部／瞬时问题时，请阅读 references/transient-vs-deterministic.md。 如果失败涉及缺少测试元数据、不稳定测试的重新运行、测试拆分或 JUnit XML 设置，请阅读 ../config/references/test-results.md。

需要收集的输入

• 失败的流水线／工作流／作业标识符
• 分支和提交 SHA
• 首个失败的步骤及关键日志行
• 在同一提交上重新运行是否会重现失败

工作流

1. 确定主要失败信号。
   • 记录首个失败的作业和步骤，而非所有后续失败。
2. 对问题类型进行分类。
   • 配置语法／引用问题
   • 环境／工具链不匹配
   • 依赖／缓存问题
   • 测试或构建回归
   • 外部／瞬时故障
3. 应用最小可行修复。
   • 仅修改与已确认根因相关的文件。
   • 严格限制变通方案的适用范围。
4. 验证。
   • 尽可能运行本地信号最强的检查。
   • 明确重新运行时 CircleCI 预期的成功信号。
5. 报告剩余风险。
   • 指出未经验证的假设和可能需要进行的后续检查。

守则

• 不要用一概而论的重试来掩盖确定性失败。
• 避免在故障修复中混入无关重构。
• 将外部服务中断视为需要报告并采取缓解措施的问题，除非用户要求进行更深入的重新设计。
• 日志不完整时，明确说明置信度。
• 在确认失败可能是瞬时问题之前，不要建议自动重新运行或不稳定测试工作流。

输出要求

请提供：

1. 失败摘要（流水线／工作流／作业／步骤）。
2. 根因假设及置信度。
3. 已应用的更改及文件列表。
4. 验证计划和预期的通过信号。
5. 剩余风险。