github-actions-troubleshooting

核心用法

本 Skill 提供了一套标准化的 GitHub Actions 故障排查流程，主要依托 gh CLI 工具实现。使用者可通过 gh run list 快速查看近期工作流运行状态，利用 gh run view 深入分析特定失败的执行详情，并通过 --log-failed 参数精准提取错误日志。针对 Go 项目的特性，技能特别提供了环境诊断与代码问题分离策略：通过检查编译、测试、 Lint 的一致性表现判断是否为代码缺陷，或借助 go mod tidy 解决依赖解析异常，使用最小化配置的 golangci-lint 规避类型检查导致的 CI 环境差异问题。

显著优点

作为纯文档型知识资产，该 Skill 具有极高的安全性与透明度，无可执行代码注入风险。内容高度聚焦于 Go 生态，提供了从工作流分析、问题分类到具体修复命令的完整闭环，尤其擅长处理 linter 配置冲突和依赖解析等典型 Go CI 痛点。所有命令示例均为即查即用的标准 CLI 操作，无需复杂配置即可直接应用于实际排查场景，显著降低了 DevOps 学习成本。

潜在缺点与局限性

该 Skill 的适用范围存在明显边界：首先，专为 GitHub Actions 设计，对 GitLab CI、Jenkins 等其他 CI/CD 平台无直接指导意义；其次，问题诊断逻辑和修复方案深度绑定 Go 语言特性，对 Node.js、Python 等项目的参考价值有限；此外，功能实现严格依赖外部工具 gh 和 git 的预装，在封闭网络环境或无法安装 GitHub CLI 的场景下将无法使用。

适合的目标群体

主要面向正在使用 GitHub Actions 作为 CI/CD 基础设施的 Go 语言开发团队，包括需要频繁处理构建失败的 Go 后端工程师、负责维护流水线稳定性的 DevOps 工程师，以及希望提升 CI 问题诊断效率的技术负责人。对于刚接触 GitHub Actions 且希望建立系统排查思维的开发者尤为适用。

使用风险与注意事项

虽然 Skill 本身无代码执行风险，但使用时需注意：执行 gh run download 下载构建产物时，应确保操作对象为可信代码仓库，避免潜在恶意文件落地；依赖的 gh CLI 需要通过系统包管理器（brew/apt）安装并保持更新，以防工具本身的漏洞风险；所有修复操作（如 go mod tidy）建议在本地验证后再提交至 CI，避免盲目修复导致代码库状态混乱。