antithesis-query-logs – 测试日志查询与分析 Skill

Skill 详细介绍

antithesishq/antithesis-skills#antithesis-query-logs 是 Antithesis 官方 Skills 集合中的一个查询类 Skill，Skill 名称为 antithesis-query-logs。Antithesis 是一个面向确定性模拟测试（deterministic simulation testing）的平台，主要用于在隔离的模拟环境中对分布式系统和后端服务进行可复现的测试与调试。

这个 Skill 的核心用途，是让 AI Agent 能够针对 Antithesis 平台中产生的运行日志进行查询和检索，从而辅助定位测试过程中出现的问题。

它不是什么：它不是 Antithesis 平台本身，也不负责创建测试环境、发起测试运行或修复代码。它本身不是独立运行的软件，而是一组供 Agent 加载和调用的指令 / 工作流，依赖 Antithesis 平台已有的日志数据来发挥作用。

安装后，Agent 增加的能力大致是：

– 围绕 Antithesis 运行日志进行查询式检索，帮助用户找到与特定测试、时间窗口或异常相关的日志内容
– 在排查 Antithesis 测试结果时，把“翻找日志”这件事交给 Agent 完成，而不是用户手动浏览

典型任务

– 在 Antithesis 的一次测试运行结果中，查找特定错误、异常或事件的日志
– 按时间、服务或关键词缩小日志范围，辅助分析测试中出现的失败
– 把分散在多处的日志条目整理出来，供进一步排查

适合哪些用户

– 使用 Antithesis 平台做确定性模拟测试、分布式系统测试的工程团队
– 需要在 Antithesis 测试结果里快速定位问题的开发者或 SRE

不适合哪些需求

– 没有使用 Antithesis 平台，只想要一个通用的日志查询 Skill
– 希望 Skill 直接给出修复方案或自动改代码
– 希望它替代 Antithesis 平台本身的测试与模拟能力

由于该 Skill 依赖 Antithesis 平台的日志数据，脱离 Antithesis 环境时它无法提供实际价值。具体支持哪些查询方式、命令形式或交互细节，以该 Skill 当前官方说明为准。

Skill 安全评估

总体判断：这是一个以查询日志为主的功能型 Skill，来源是 Antithesis 官方组织的 Skills 仓库，属于官方一手来源。它本身的行为预期是读取和检索日志，风险主要取决于它需要接触哪些数据和凭证，而不在于它是不是“危险”。

需要关注的安全点：

– 来源可信度：Skill 来自 antithesishq 官方组织仓库，相较第三方转载版本更可信。安装时应确认来源是官方仓库，避免使用同名 fork 或第三方重新发布版本。
– 第三方平台访问：查询 Antithesis 日志通常需要访问 Antithesis 平台或相关 API，因此大概率涉及凭证（如 API Key、Token 或平台凭据）。这类凭证的权限范围和泄露风险需要用户自行管理。
– 凭证泄露风险：不要把 Antithesis 的高权限凭证随意写入会被提交到仓库的配置文件。若 Agent 环境会把环境变量或配置内容发送到模型侧，需注意凭证暴露面。
– 数据敏感性：日志内容可能包含内部服务名、错误堆栈甚至部分业务信息。把日志交给 Agent 处理前，确认这是否符合你所在组织的合规要求。
– 网络访问：该 Skill 如需读取平台日志，通常需要网络访问。网络权限本身不是问题，但要判断是否与该 Skill 的正常用途一致。
– 文件读取 / 写入：若 Skill 会读取本地日志文件或写入查询结果，属于符合其用途的行为；但应避免给它不必要的广泛文件系统权限。

降低风险的建议：

– 只从 Antithesis 官方仓库安装，确认标识为 antithesishq/antithesis-skills#antithesis-query-logs。
– 为 Antithesis 凭证使用最小权限，不要复用高权限主账号凭证。
– 如果只需要 Agent 帮你组织查询逻辑，可以关闭 Agent 的自动写入或自动执行高权限操作，由你手动确认。
– 对涉及生产数据的日志，按内部合规要求处理。

无法确认的部分：该 Skill 的具体权限声明、所需凭证类型和数据处理方式，应以它当前官方说明为准。没有可靠资料时，本文不推断其安全审计结论。

Skill 使用要求

一、Agent / 客户端

该 Skill 属于 Antithesis 官方 Skills 集合，面向支持 Skill / 指令加载机制的 AI Agent 环境。官方没有公布完整的第三方 Agent 兼容列表。

– 如果官方资料明确主要面向某一 Agent，应优先在该 Agent 中使用。
– 其他主流 Agent（如 Codex、Cursor、Trae、OpenClaw、WorkBuddy 等），在支持 Skills、自定义 Skill 或类似指令加载机制时，通常可以尝试使用。不同 Agent 的 Skill 加载方式和兼容程度可能不同，具体以对应 Agent 当前版本为准。

二、运行环境 / 依赖

该 Skill 的可用性主要取决于是否能访问 Antithesis 平台 / 日志数据以及 Agent 是否支持加载该 Skill。

| 项目 | 要求 |
|—|—|
| Agent | 支持 Skill / 指令加载机制的 Agent |
| Antithesis 平台访问 | 查询日志所需的平台访问能力，以官方说明为准 |
| 网络 | 如查询平台日志通常需要网络访问 |

至于是否需要 Node.js、Python、特定 CLI 或 Docker，官方资料未明确说明时，不应自行假定，以其当前官方说明为准。

三、权限

– 网络访问：如涉及查询 Antithesis 平台日志，通常需要（以官方说明为准）。
– 文件读取：如处理本地日志文件则相关（可选，视使用方式而定）。
– 文件写入：如保存查询结果则相关（可选）。
– Shell：是否必需以官方说明为准；若不需要，可关闭自动执行。

四、账号 / API Key

需要区分两件事：

– Skill 本身：是否需要账号或凭据，以官方说明为准。
– Skill 操作的对象：Antithesis 平台日志查询，通常需要 Antithesis 侧的访问凭证。这类凭证属于平台侧要求，不是 Skill 自己凭空引入的。

最小使用条件

1. 一个支持 Skill 加载机制的 AI Agent。
2. 可访问 Antithesis 平台日志数据（含相应凭证，如需要）。
3. 网络访问（如查询远程平台日志）。

Skill 安装、使用与卸载教程

一、安装

本页面已提供该 Skill 的安装指令，可以直接复制本页面的安装指令，粘贴到对应 Agent 或终端中执行。

如果不确定自己的 Agent 如何安装 Skill，可以直接问当前 Agent：

如何安装 antithesishq/antithesis-skills#antithesis-query-logs？

如何在 Claude Code 中安装 antithesishq/antithesis-skills#antithesis-query-logs？

如何在 Cursor 中安装 antithesishq/antithesis-skills#antithesis-query-logs？

让当前 Agent 根据自己的 Skill 加载 / 管理机制，给出对应的安装方式。若该 Skill 存在特殊官方安装条件，以其官方说明为准。

二、安装后如何使用

安装后，在需要查询 Antithesis 运行日志时，把任务交给这个 Skill。触发方式通常是自然语言描述需求，由 Agent 决定是否调用该 Skill。

适合交给它的任务类型：

– 在指定的 Antithesis 测试运行中查找日志
– 按错误、服务名、时间范围筛选日志
– 把相关日志整理成便于分析的输出

自然语言使用示例：

使用 antithesis-query-logs，帮我在最近一次 Antithesis 测试运行中查找所有出现连接超时的日志。

使用 antithesis-query-logs，按服务名筛选这次运行的日志，找出报错最多的服务。

使用 antithesis-query-logs，查询某个时间窗口内与一致性失败相关的日志条目。

用户可以先用自然语言说清：要查哪次运行、关注什么现象、需要什么范围，Agent 就能更好地调用该 Skill。

三、卸载

不同 Agent 的 Skill 安装位置和管理方式可能不同。如果没有统一的官方卸载命令，直接询问当前 Agent 如何移除通常更稳妥：

如何卸载 antithesishq/antithesis-skills#antithesis-query-logs？

也可以使用对应 Agent / Skill 管理器提供的删除方式，删除对应 Skill。

常见问题

1. 这个 Skill 能脱离 Antithesis 平台使用吗？

不建议。它的用途是查询 Antithesis 运行日志，脱离 Antithesis 环境基本没有实际价值。通用日志查询需求应选择其他 Skill 或工具。

2. 使用它需要 Antithesis 账号或 API Key 吗？

取决于官方说明。Skill 本身是否需要凭据，与查询 Antithesis 日志所需的平台访问凭证是两回事，后者通常属于平台侧要求。请以该 Skill 当前官方说明为准。

3. 安装后 Agent 没有识别到这个 Skill 怎么办？

先确认安装位置和加载方式是否符合当前 Agent 的机制；不同 Agent 的 Skill 目录和加载时机不同。可以重启 Agent 会话，或直接问当前 Agent：“为什么没有加载 antithesishq/antithesis-skills#antithesis-query-logs？”

4. 可以同时安装到多个 Agent 吗？

通常可以，各 Agent 独立管理自己的 Skill。但需要分别确认每个 Agent 的加载机制和兼容程度。

5. Skill 更新后需要重新安装吗？

取决于你的安装方式和对应 Agent 的更新机制。若使用的是通过管理器安装的方式，可能支持更新；若是手动复制，则需按官方说明更新。具体以官方说明为准。

6. 中国大陆使用有网络要求吗？

如果该 Skill 需要访问 Antithesis 平台，访问其平台服务可能受网络环境影响。具体是否需要额外网络配置，以实际访问情况为准。

7. 它会不会修改我已有的代码或文件？

该 Skill 的核心用途是查询日志，预期行为以读取和检索为主。是否写入文件取决于具体使用方式和 Agent 权限设置。如有顾虑，可限制其写入权限。