SuperAPI AI 工具集

fix-nightwatch-issues

部署与运维

查看项目

更新于 10-23 16:18

技能介绍

该技能用于处理 Laravel Nightwatch 中的开放生产问题信号,包括异常以及慢路由、任务、命令和定时任务。核心思路是:先读取堆栈跟踪和出现统计,而不是只看标题;按最后出现时间从新到旧梳理;把同一根因导致的多个问题合并处理,再逐类判定并修复。

使用方式:先读取仓库中的 .agents/nightwatch.md(如存在),获取应用与环境名称、部署模型、基础设施路径和已知误判前提;再遵循仓库的 AGENTS.md / CLAUDE.md 中关于测试、缓存清理和工作区状态的规则。随后使用 Nightwatch MCP 工具:若未加载需先发现工具;list_applications 获取应用 id,list_environments 获取生产环境,list_issues(状态 open、按最后出现排序)作为工作集,get_issue 返回堆栈、代码上下文、出现统计和执行上下文。若应用或问题列表为空,可能表示采集关闭而非生产健康,应检查项目上下文或基础设施配置并报告“采集关闭”。

主要能力:按根因聚类(Nightwatch 按消息文本分组,同一原因可能拆成多个问题);把每个开放问题归入 STALE、INFRA/OPS、EXTERNAL/TRANSIENT、NOISE 或 LEGIT,并逐条写一行证据;对 LEGIT 聚类在正确层面做最小修复(应用逻辑加测试;环境或权限改容器/基础设施配置;慢路由、任务或命令加索引、预加载、分块或移到队列),每个提交只做一个逻辑修复,并在提交正文列出覆盖的 Nightwatch 引用(使用普通引用,避免 GitHub 自动关闭关键字误关同号 issue);修复后在 Nightwatch 中 add_issue_comment 记录根因与修复 sha,再用 update_issue 标记 resolved;对需要运维介入的 LEGIT 问题保留 OPEN 并注明阻塞项;部署后复发则重新打开并修正分类。

适用场景:Laravel 生产环境的异常与性能问题分诊、批量清理过期或噪声问题、把基础设施问题与应用代码问题分开处理。限制:需要 Nightwatch MCP 工具和项目上下文;无法本地运行的基础设施修复需明确说明;修复需部署并待最后出现时间静默才算验证;可询问是否在 24–48 小时内做一次部署后复查,在支持调度的环境中安排一次性运行。