# Jev Agent Quality

给任何代码 Agent 使用的 Jev 质量检查工具。项目只有两部分：一个标准 MCP 服务和一份可复制的 Skill。它不绑定 Codex、Claude Code、CodeBuddy 或 DeepSeek Harness。

## 三步使用

### 1. 下载

```bash
git clone --depth 1 https://github.com/diegozhou114-cloud/jev-agent-quality.git
cd jev-agent-quality
```

仓库已经提交可直接运行的 `dist/server.js`，无需安装 Node 依赖。开发或需要重新构建时使用 `npm ci && npm run build`。

### 2. 配置 key

在启动 Agent 的环境中设置：

```bash
export JEV_API_KEY="your-typesafe-key"
```

不要把 key 写进配置文件、仓库或规则文本。

### 3. 配置 MCP 和 Skill

把下面的 MCP 配置复制到 Agent 的 MCP 设置中，把路径改成实际目录：

```json
{
  "mcpServers": {
    "jev-agent-quality": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/jev-agent-quality/dist/server.js"],
      "env": {"JEV_API_KEY": "${JEV_API_KEY}"}
    }
  }
}
```

完整模板见 [`mcp.json`](mcp.json)。将 [`skills/jev-review/SKILL.md`](skills/jev-review/SKILL.md) 复制到 Agent 的 Skill 目录，或把它的内容加入 Agent 的全局规则。这样用户不需要每次输入“使用 Jev”。

不同 Agent 的配置文件位置不同，但 MCP 都只需要这三个值：`command=node`、`args=dist/server.js`、环境变量 `JEV_API_KEY`。如果 Agent 支持 MCP，就可以直接使用；如果只支持规则文件，就复制 Skill 并让它调用自己的 MCP 客户端。

## 它什么时候调用

Skill 会自动判断风险：跨文件、公共 API、状态/控制流、错误处理、安全、并发、测试和重构默认检查；格式、文档、拼写、依赖安装和一行机械修复默认跳过。检查只发送聚焦 diff 和必要上下文，不会自动读取或上传整个仓库。

Jev 返回结构化分数、置信度和弱项提示。Agent 负责解释、修改和测试；Jev 不改代码，也不替代测试、静态分析或人工审查。

## MCP 工具

服务只提供一个只读工具：`jev_review`。

```json
{
  "task": "需求和验收条件",
  "diff": "当前聚焦 diff",
  "files": [{"path": "src/example.ts", "content": "必要的当前内容"}],
  "repositoryContext": "必要的架构、约定和测试结果",
  "previousEvaluation": {}
}
```

## 本地开发

```bash
npm ci
npm run validate
```

源码在 `src/`，构建产物在 `dist/server.js`。MCP 使用 stdio，适用于支持 MCP 的桌面 Agent、CLI Agent 和自建 Harness。

## 隐私和成本

只有明确传入 `jev_review` 的 task、diff、文件和上下文会发送到 TypeSafe Jev API。不要发送密钥、`.env`、证书、生成文件、vendor 目录或无关专有代码。按风险触发可以减少延迟和 API 成本。

## License

MIT，见 [LICENSE](LICENSE)。