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，避免盲目修复导致代码库状态混乱。

GitHub Actions 故障排查指南

核心用法

本 Skill 是一份针对 Go 项目的 GitHub Actions 故障排查文档，主要功能包括：

• 工作流状态检查：使用 gh run list 查看最近工作流运行状态
• 详细日志分析：通过 gh run view 和 gh run view --log-failed 获取失败作业日志
• 问题类型诊断：区分代码问题（编译、测试、lint 失败）与环境问题（依赖解析、工具安装）
• 针对性修复：提供 linter 配置调整、依赖整理（go mod tidy）等常见解决方案
• 工件下载分析：支持下载 workflow artifacts 进行离线检查

显著优点

1. 纯文档安全设计：零可执行代码，从根本上杜绝命令注入、代码执行等攻击向量
2. 官方工具链：所有命令均基于 GitHub 官方 CLI (gh)，无第三方依赖或隐藏网络调用
3. Go 生态专精：针对 Go 项目的常见 CI 痛点（golangci-lint 配置、go.mod 一致性）提供精准指导
4. 结构化流程：五步排查法（识别失败作业→分析错误→本地复现→针对性修复→验证解决）清晰可操作

局限性与注意事项

• 非交互式：当前为静态文档，无参数化引导或动态决策树
• 版本兼容性：未注明测试过的 gh CLI 版本范围，不同版本可能存在命令差异
• 许可证缺失：未明确声明开源许可证（建议补充 MIT/Apache-2.0）
• 适用范围：虽以 Go 为例，但部分诊断逻辑可迁移至其他语言 CI 场景

适合人群

• Go 开发者遇到 GitHub Actions 工作流失败需要快速定位根因
• DevOps 工程师排查 CI 环境配置与代码逻辑边界问题
• 开源项目维护者处理贡献者提交的 PR 构建失败

风险与合规

经 CLS-Certify v2.1.0 全量扫描认证：

• 安全等级 S+（满分 100），零攻击面
• 来源可信度 T2（clawdbot/skills 可信组织）
• 通过 GDPR/CCPA 隐私合规检测，不收集敏感数据
• 无硬编码凭证、无数据外泄通道、无供应链风险

注：认证结果仅反映检测时间点安全状况，不构成未来版本的安全担保。