mcpField
M
monitoring-terminal-errors

monitoring-terminal-errors

github.com/spencerpauly开发868457 次安装13 周前更新
代码仓库

关于 monitoring-terminal-errors

面向开发者的调试技能,用于监视运行中进程的终端输出并反复处理错误。流程涵盖错误识别、定位源代码行以及检查进程是否恢复。

主要功能

  1. 01识别目标进程的终端
  2. 02搜索常见错误输出
  3. 03提取文件、行号和错误信息
  4. 04修复问题并验证恢复
  5. 05最多重复尝试五次

适用场景

  1. 01排查开发服务器故障
  2. 02调查测试运行器或构建错误
  3. 03确认热重载是否解决错误

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/spencerpauly/awesome-cursor-skills --skill monitoring-terminal-errors

安装后在 Claude Code 中输入/monitoring-terminal-errors确认已加载。

详细介绍

监控终端错误

持续监控正在运行的进程(开发服务器、测试运行器、构建任务),并在错误出现时修复。

工作流

1. 确认终端

列出终端文件,找到运行目标进程的终端:

head -n 10 <terminals_folder>/*.txt

查找正在运行开发服务器的终端(npm run dev、pnpm dev、python manage.py runserver 等)。

2. 读取终端输出

读取终端文件的完整内容。搜索以下错误模式:

  • 堆栈跟踪:at <function> (<file>:<line>:<col>)
  • Node.js:Error:、TypeError:、ReferenceError:、ENOENT、ECONNREFUSED
  • Python:Traceback (most recent call last): 后跟 File "<path>", line <n>
  • React/Next.js:Unhandled Runtime Error、Error: ...、Module not found
  • 构建错误:ERROR in、Failed to compile、SyntaxError
  • Vite:[vite] Internal server error:
  • TypeScript:error TS\d+:
3. 提取源代码位置

从堆栈跟踪中提取:

  • 文件路径
  • 行号
  • 错误消息

Node.js:at functionName (/path/to/file.ts:42:10) Python:File "/path/to/file.py", line 42, in function_name

4. 定位并修复
  1. 阅读已定位文件中错误行附近的内容
  2. 理解错误(缺少导入、类型不匹配、未定义变量等)
  3. 应用修复
  4. 重新读取终端文件,确认服务器已恢复(热重载应能自动应用更改)
5. 循环处理

如果修复后服务器仍显示错误,请从第 2 步开始重复。出现以下情况时停止:

  • 终端显示“编译成功”或类似提示
  • 输出中不再出现新错误
  • 已尝试 5 次仍未解决(向用户报告)

提示

  • 检查终端文件末尾的 exit_code;如果存在,说明进程已完全崩溃,需要重启
  • 有些错误会级联出现;修复第一个/根本错误后,其余错误通常也会消失
  • 对于 HMR 错误,可能只需重新保存文件即可触发重建

评论

支持 Markdown