mcpField
O
openlogs-server-logs

openlogs-server-logs

github.com/charlietlamb开发337272 次安装22 周前更新
代码仓库

关于 openlogs-server-logs

用于通过 Openlogs 检查已捕获服务器输出的技能,指导 Agent 获取、筛选和解读近期或实时日志,以便排查问题。

主要功能

  1. 01读取项目近期日志
  2. 02按命令或服务筛选日志
  3. 03切换清理后或原始输出
  4. 04实时跟踪日志
  5. 05CLI 不可用时读取日志文件

适用场景

  1. 01检查服务器最近一次运行的错误
  2. 02查找指定命令或服务的日志
  3. 03检查 ANSI 或终端控制输出
  4. 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 实时跟踪日志。

工作流

  1. 尝试运行 openlogs tail -n 200。
  2. 如果用户提到了命令或服务,尝试运行 openlogs tail <query> -n 200。
  3. 如果失败,尝试运行 ol tail -n 200。
  4. 如果 CLI 不可用,但可以访问工作区,请读取 .openlogs/latest.txt 或 .openlogs/ 中对应命令的文件。
  5. 如果日志目录不存在,检查服务是否通过 openlogs <command> 或 ol <command> 启动。
  6. 如果不是这样,请告诉用户通过 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