前言¶

在运维和安全场景中，osquery 是非常常用的系统信息查询工具，但通过命令行调用、参数拼接、结果解析等步骤，对大模型来说并不友好。开发者需要一种方式，让大模型直接用自然语言或结构化描述触发 osquery，并拿到可用的结果。

Osquery Wrap 是一个面向大模型的 Skill，将 osquery 的查询能力封装成自然语言接口，让开发者通过文本指令执行系统查询，并获取结构化或表格化的结果。

是什么¶

Osquery Wrap 是一个基于 SKILL.md 格式的 Skill，由社区开发者 user_922b1001 发布。它将 osquery 的 SQL 查询能力封装为自然语言接口，支持在 Cursor、Claude Code 或 Codex CLI 等大模型编辑器中直接调用。

该 Skill 解决的问题是：让大模型无需手动拼接 osquery 语句、理解表结构和返回格式，就能通过自然语言或结构化描述执行系统查询，并拿到可用的结果。

核心功能¶

Osquery Wrap 提供以下能力：

• 自然语言转 osquery 查询：通过自然语言描述查询意图，Skill 自动生成对应的 osquery SQL 语句。
• 结构化结果输出：将 osquery 的查询结果转换为适合大模型处理的格式（如 JSON、表格等）。
• 常用查询模板：内置常见的系统查询模板（如进程列表、端口监听、文件清单等），方便快速调用。

安装与启用¶

安装¶

在支持的编辑器中，通过以下方式安装：

• 在 SkillHub 中找到 Osquery Wrap，点击安装。
• 确认安装后，Skill 会出现在可用的技能列表中。

启用¶

安装完成后，在编辑器的技能面板中启用 Osquery Wrap，即可在对话中使用。

配置（如需要）¶

根据官方说明，该 Skill 不需要额外配置字段，可直接使用。

典型用法¶

在对话中直接描述查询需求，例如：

• “查询当前所有正在运行的进程及其 PID 和命令行参数。”
• “列出所有监听 80 端口的进程。”
• “获取 /etc 目录下最近 7 天修改过的文件列表。”

Skill 会自动生成 osquery 语句并返回结果。

适用场景与注意¶

适合需要从系统层面查询信息（进程、端口、文件、服务状态等）的场景，如：
- 自动化运维排查
- 安全巡检
- 系统状态监控

注意：
- 需要大模型编辑器支持该 Skill 格式。
- 查询结果取决于 osquery 的权限和系统环境。
- 复杂查询可能需要更精确的自然语言描述。

结尾¶

Osquery Wrap 将 osquery 的系统查询能力与大模型结合，降低了运维查询的门槛，适合需要通过大模型自动化处理系统信息的场景。

官方地址：https://api.skillhub.cn/user_922b1001/osquery-wrap