关于 openlogs-server-logs
用于通过 Openlogs 检查已捕获服务器输出的技能,指导 Agent 获取、筛选和解读近期或实时日志,以便排查问题。
主要功能
- 01读取项目近期日志
- 02按命令或服务筛选日志
- 03切换清理后或原始输出
- 04实时跟踪日志
- 05CLI 不可用时读取日志文件
适用场景
- 01检查服务器最近一次运行的错误
- 02查找指定命令或服务的日志
- 03检查 ANSI 或终端控制输出
- 04无法访问本地文件时请求日志内容
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ charlietlamb/ openlogs --skill openlogs-server-logs安装后在 Claude Code 中输入/openlogs-server-logs确认已加载。
附带文件agents/openai.yaml
详细介绍
Openlogs 服务日志
在让用户粘贴任何内容之前,先使用 openlogs tail 获取近期服务日志。除非需要查看 ANSI 或原始终端字节,否则优先使用清理后的文本日志。
快速开始
- 运行
openlogs tail -n 200,检查项目中最近一次运行。 - 如果用户提到特定命令或服务,运行
openlogs tail <query> -n 200,获取最近一次匹配的运行记录。 - 如果更偏好使用简短别名,请运行
ol tail -n 200。 - 只有在直接读取文件比运行命令更简单,并且你确实需要查看最近一次整体运行记录时,才直接读取
.openlogs/latest.txt。 - 只有在颜色代码、光标控制或精确的终端输出至关重要时,才使用
openlogs tail --raw -n 200。 - 使用
openlogs tail -f实时跟踪日志。
工作流
- 尝试运行
openlogs tail -n 200。 - 如果用户提到了命令或服务,尝试运行
openlogs tail <query> -n 200。 - 如果失败,尝试运行
ol tail -n 200。 - 如果 CLI 不可用,但可以访问工作区,请读取
.openlogs/latest.txt或.openlogs/中对应命令的文件。 - 如果日志目录不存在,检查服务是否通过
openlogs <command>或ol <command>启动。 - 如果不是这样,请告诉用户通过 openlogs 重新启动服务,然后检查生成的日志。
常用命令
openlogs tail -n 100
openlogs tail dev -n 100
openlogs tail server -f
openlogs tail -f
openlogs tail --raw -n 100
openlogs tail --out-dir logs -n 200
openlogs bun dev
ol npm run dev
解读规则
- 分析时优先使用文本日志,因为它会去除 ANSI 干扰。
- 不带查询条件的
openlogs tail表示当前项目中最近一次整体运行。 openlogs tail <query>表示最近一次命令或显式名称中包含该查询的运行。- 只有在清理后的日志隐藏了重要信息时,才切换到
--raw。 - 在有帮助时,在回答中引用确切的失败行或错误块。
- 说明你查看的是最近一次捕获的运行记录,还是实时跟踪的日志流。
- 如果 Agent 无法访问本地被 gitignore 忽略的文件,请让用户运行
openlogs tail -n 200并粘贴输出。
回复格式
- 以你使用的命令或文件开头。
- 用 1 至 3 句话概述可能的问题。
- 包含最相关的错误行。
- 如果缺少日志,请准确说明用户应在 openlogs 下重新运行的命令。
评论
支持 Markdown