关于 monitoring-terminal-errors
面向开发者的调试技能,用于监视运行中进程的终端输出并反复处理错误。流程涵盖错误识别、定位源代码行以及检查进程是否恢复。
主要功能
- 01识别目标进程的终端
- 02搜索常见错误输出
- 03提取文件、行号和错误信息
- 04修复问题并验证恢复
- 05最多重复尝试五次
适用场景
- 01排查开发服务器故障
- 02调查测试运行器或构建错误
- 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. 定位并修复
- 阅读已定位文件中错误行附近的内容
- 理解错误(缺少导入、类型不匹配、未定义变量等)
- 应用修复
- 重新读取终端文件,确认服务器已恢复(热重载应能自动应用更改)
5. 循环处理
如果修复后服务器仍显示错误,请从第 2 步开始重复。出现以下情况时停止:
- 终端显示“编译成功”或类似提示
- 输出中不再出现新错误
- 已尝试 5 次仍未解决(向用户报告)
提示
- 检查终端文件末尾的
exit_code;如果存在,说明进程已完全崩溃,需要重启 - 有些错误会级联出现;修复第一个/根本错误后,其余错误通常也会消失
- 对于 HMR 错误,可能只需重新保存文件即可触发重建
评论
支持 Markdown