Vet

**在任何逻辑代码单元更改后立即运行vet。** 不要批量处理更改，不要等待被要求运行vet，确保你是积极主动的。

Vet会审查git差异和对话历史，以发现代码更改和对话历史中的问题。当结合对话历史频繁运行时，它最为有效，这有助于它捕捉请求内容与实现内容之间的误解。尽管如此，vet并不能替代运行测试。

安装

使用pip、pipx或uv安装vet：

# Using pip
pip install verify-everything

# Using pipx
pipx install verify-everything

# Using uv
uv tool install verify-everything

# Verify installation:
vet --help

运行Vet

标准用法

运行vet之前，确定正确的Python二进制文件：

$(command -v python3 || command -v python)

使用可解析的那个（优先使用python3）。下面的示例使用python3，如果你的系统提供的是python，请进行替换。

OpenCode：

vet "goal" --history-loader "python3 ~/.agents/skills/vet/scripts/export_opencode_session.py --session-id <ses_ID>"

Codex：

vet "goal" --history-loader "python3 ~/.codex/skills/vet/scripts/export_codex_session.py --session-file <path-to-session.jsonl>"

Claude Code：

vet "goal" --history-loader "python3 ~/.claude/skills/vet/scripts/export_claude_code_session.py --session-file <path-to-session.jsonl>"

无对话历史

vet "goal"

查找您的会话

您应该只从您的编码工具中搜索会话。如果用户要求您使用不同的工具，他们很可能指的是 vet 的代理模式，而不是会话。

OpenCode：该--session-id参数需要一个ses_...会话 ID。要查找当前会话 ID：

1. 运行：opencode session list --format json以 JSON 格式列出最近的会话及其 ID 和标题。
2. 通过匹配标题或时间戳，从列表中识别当前会话。
   • 重要提示：请验证您找到的会话与当前对话是否匹配。如果标题不明确，请比较时间戳或检查多个候选会话。
3. 将会话 ID 作为--session-id参数传入。

Codex：会话文件存储在~/.codex/sessions/YYYY/MM/DD/目录下。要找到正确的会话文件：

1. 在当前对话中找出最独特的句子/问题/字符串。
2. 在 ~/.codex/sessions/` 目录中搜索你的独特消息字符串，以找到匹配的会话文件。
   • 重要：请确认你找到的对话与当前对话匹配，并且不是另一个具有相同搜索字符串的对话。
3. 将匹配的文件路径作为--session-file参数传递。

Claude Code:会话文件存储在~/.claude/projects/<encoded-path>/目录中。编码后的路径将/替换为-（例如，/home/user/myproject变为-home-user-myproject）。要找到正确的会话文件：

1. 在当前对话中找出最独特的句子/问题/字符串。
2. 在 ~/.claude/projects/` 目录中搜索你的独特消息字符串，以找到匹配的会话文件。
   • 重要：请核实找到的对话记录是否与当前对话匹配，确保它不是另一个使用相同搜索字符串的对话。
3. 将匹配到的文件路径作为--session-file参数传递。

注意：标准用法部分的示例假设用户是在用户级别而非项目级别安装的vet技能。在尝试运行vet之前，请检查它是否安装在项目级别（项目级别应优先于用户级别）。如果安装在项目级别，请确保history-loader选项指向正确的位置。

结果解读

Vet会分析从基础提交开始的完整git差异。这可能包括同一仓库中其他代理或会话所做的更改。如果vet报告的问题与你在此会话中未做的更改相关，请忽略它们，假设它们属于其他代理或用户。

常用选项

• --base-commit REF：用于差异比较的Git引用（默认：HEAD）
• --model MODEL：使用的LLM模型（默认：claude-opus-4-6）
• --list-models：列出vet支持的所有模型
  • 运行vet --help并查看 vet 仓库的 README 文件，了解如何定义自定义 OpenAI 兼容模型的详细信息。
• --confidence-threshold N：最小置信度 0.0-1.0（默认值：0.8）
• --output-format FORMAT：输出格式为text（文本）、json或github
• --quiet：抑制状态消息和“未发现问题”提示
• --agentic：此模式通过本地安装的 Claude Code 或 Codex CLI 路由分析，而不是直接调用 API。如果 vet 因缺少 API 密钥而失败，请尝试此模式。此模式速度较慢，因此不是默认设置，但通常能更精确地识别问题。--model参数会转发给测试框架，但 vet 不会验证它，因为 vet 不知道每个测试框架支持哪些模型。
• --agent-harness：此选项的两个选择是codex和claude. Claude Code 是默认选项。
• --help：显示完整的选项列表

更新

随着智能体框架和 LLM API 的变化，vet CLI、技能文件和导出脚本可能会过时。

如果发生这种情况，请尝试更新它们。运行which vet来确定 vet 的安装方式并进行相应更新。对于技能文件，请检查磁盘上存在哪些技能目录，并使用来自https://github.com/imbue-ai/vet/tree/main/skills/vet的最新版本进行更新。

附加信息

更多信息可以在 vet 仓库中找到：

https://github.com/imbue-ai/vet