返回首页

面向 AI Agent 的 Jev Skills:安装与使用指南

安装 AutoJev 工具路由 Skill,以及用于模型路由、任务路由、工具调用防护、调研验证和完成审查的专项 Jev Skills。

最近更新: 2026-09-19

Jev Skills 是可移植的指令文件,教 AI Agent 何时向 Jev 模型请求决策、应该发送哪些任务状态,以及怎样处理结构化结果。它们与提供可调用工具的 AutoJev Jev MCP Server 配合使用。

MCP 回答“有哪些工具可以调用?”,Skill 则回答“Agent 应该在什么时候使用这个工具,以及如何处理结果?”

AutoJev 提供的六个 Jev Skills

AutoJev Tool Router

autojev 会把当前决策边界映射到六个 AutoJev MCP 工具之一。希望广泛使用 AutoJev、但不想加载所有专项工作流 Skill 时,可以安装它。它会优先使用五个预设工具,只有自定义结构化决策才使用 autojev_decide

Jev Task Router

autojev-task-router 帮助 Agent 在快速继续、深度审查、拆分任务和阻塞之间选择。它适合存在明显歧义、风险、验证不足或不可逆后果的工作。

Jev Model Router

autojev-model-router 在当前环境真正可以调用的模型中进行选择。Skill 要求 Agent 描述任务风险、质量、成本、延迟、上下文和工具需求,同时禁止编造 Benchmark。

Jev Tool Guard

autojev-tool-guard 在高影响工具真正执行前评估这次调用。它适用于改变外部状态、花费资金、暴露数据、发布内容、修改权限、部署和其他难以撤销的操作。

Jev Research Guard

autojev-research-guard 检查已经收集的证据能否支持一个明确结论。它适合来源冲突、出处较弱、时效性事实和高风险结论。

Jev Completion Review

autojev-completion-review 在 Agent 报告成功之前,把目标与已完成工作、验证、失败记录和已知缺口进行比较。

一次安装全部 AutoJev Skills

在项目根目录运行一次下面的命令,也可以让本地编程 Agent 直接执行。这个循环会把总控路由 Skill 和五个专项 Skills 全部安装到项目的 .agents/skills 目录:

bash
for skill in autojev autojev-task-router autojev-model-router \
  autojev-tool-guard autojev-research-guard autojev-completion-review; do
  mkdir -p ".agents/skills/$skill"
  curl -fsSL "https://autojev.ai/skills/$skill/SKILL.md" \
    -o ".agents/skills/$skill/SKILL.md"
done

安装后,让 Agent 读取 .agents/skills/autojev/SKILL.md,并为当前项目配置 AutoJev。把 Skills 安装到可信用户目录或项目目录前应该先阅读内容。它们是可读指令,团队可以像管理其他项目策略一样进行版本管理、审计和定制。

连接 Jev MCP Server

Skills 需要对应的 AutoJev MCP 工具可用。Codex 用户可以把 AutoJev 访问密钥保存在环境变量中,然后添加:

toml
[mcp_servers.autojev]
url = "https://autojev.ai/mcp"
bearer_token_env_var = "AUTOJEV_API_KEY"
tool_timeout_sec = 30

把 AutoJev 访问密钥保存在环境变量中,不要写进提交到仓库的 MCP 配置或 Skill 文件。

其他客户端配置和工具详情请阅读 Jev MCP 指南

Jev Skills 怎样触发决策

一个实用的 Jev Skill 不只是写出工具名称,还应该定义:

  • 触发条件:识别真正的决策边界。
  • 上下文准备:保持状态精简,并排除无关数据。
  • 工具选择:把当前情况映射到一个结构化 Jev MCP 工具。
  • 结果处理:说明怎样理解 allow、confirm、review、deny 或其他预设结果。
  • 安全约束:保留用户权限、现有授权和必须执行的审批。

例如,工具防护 Skill 会在高影响调用真正执行之前触发,而不是在无关规划开始时触发。它发送提议操作、副作用、防护措施和策略,然后使用返回结论,但不会把这个结论当成新的执行授权。

Jev Skills 不会扩大权限

安装 Skill 不会授予文件、Shell、部署或花费资金的权限。Agent 仍然受到宿主环境、用户指令和现有审批规则限制。

Jev Skills 不应该用于:

  • 绕过用户或平台已经要求的确认。
  • 向决策工具发送密码、API Key 或无关隐私数据。
  • 把模型置信度当成正确性的证明。
  • 取代可以通过代码稳定完成的确定性验证。
  • 仅仅因为模型返回 allow 就执行不可逆操作。

应该安装哪些 Jev Skills?

工作流需求推荐 Skill
在全部六个 AutoJev 工具之间路由autojev
为存在歧义的任务选择执行路径autojev-task-router
在可用 AI 模型中进行选择autojev-model-router
检查高影响工具调用autojev-tool-guard
验证证据是否支持某个结论autojev-research-guard
检查任务是否真正完成并经过验证autojev-completion-review

上面的命令会安装全部六个 Skills,也是推荐的默认方式。如果宿主需要保持最小上下文,也可以只选择表格中的一项,把对应文件下载到 .agents/skills/<skill-name>/SKILL.md。专项 Skill 使用更窄的触发条件,总控 autojev Skill 负责广泛发现工具。

相关 Jev 资源