用途：该技能用于排查和修复 Hex 平台（API 与项目运行）的常见错误与异常，适合遇到 Hex 报错、调试失败请求或排查集成问题时使用。
主要覆盖的错误：401 未授权（令牌无效、过期或缺失，需在 Hex 工作区设置中重新生成令牌）；403 禁止—只读令牌（令牌只有 Read projects 权限，而 RunProject 需要 Run projects，需新建带 Run projects 范围的令牌）；404 项目未找到（项目 ID 错误或项目未发布，只有已发布项目才能通过 API 运行）；429 请求过多（RunProject 限制为每分钟 20 次、每小时 60 次，需排队并延迟）；运行状态 ERRORED（项目内 SQL 查询、Python 代码或连接错误，需在 Hex UI 打开项目查看运行历史中的错误）；运行状态 KILLED（运行超时或被手动取消，需优化慢查询或在 API 触发中提高超时时间）。
使用方式：先用安全探测命令检查令牌，再列出项目近期运行记录。示例：curl -s -o /dev/null -w "%{http_code}" -H "Authorization: Bearer $HEX_API_TOKEN" https://app.hex.tech/api/v1/projects；curl -s -H "Authorization: Bearer $HEX_API_TOKEN" https://app.hex.tech/api/v1/project/PROJECT_ID/runs | python3 -m json.tool。排查顺序为先分类鉴权、授权、项目查找、校验、配额、超时与终止运行错误，再用安全探针复现一次并仅记录状态、延迟、配额与不透明运行 ID，随后依次检查范围、参数模式、项目状态、配额与下游连接健康，每次只做一处可回滚的修改。
输出要求：返回错误类别、关联 ID、项目范围、探针结果、已尝试的修复与下一责任人，不包含 SQL、输出、凭据或身份信息。
限制：该参考不授权将 SQL、单元格输出、数据预览或令牌复制进工单。遇到未知目标、脱敏失败、权限扩大或重复非幂等运行时，应作为停止条件，取消或恢复先前版本而非用更大范围重试。未提供官方文档与更多细节。