agent-eyes SKILL.md skillA

agent-eyes from webkubor/vite-plugin-agent-eyes is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

mdr add webkubor/vite-plugin-agent-eyes/agent-eyes@v0.16.0

Pins v0.16.0 in mdr.lock. Pin the fingerprint instead.

Audit grade

A, 17 of 17 checks passed

Kind

SKILL.md skill

Repository

webkubor/vite-plugin-agent-eyes

Path

SKILL.md

Versions recorded

8

Latest version

v0.16.0, committed Nov 3, 2026

First version recorded

Jun 28, 2026

Size

9,412 bytes

Repository stars

105

License

MIT

vite-plugin-agent-eyes 的 agent 使用手册。两块能力：① 自愈遥测——读结构化运行时日志（API/错误/控制台/交互/代理 header）+ 脱敏登录态 + 截图 + DOM 快照，不靠猜代码就诊断修复；② 提交治理——agentGit（去 husky，统一 pre-commit/post-commit + 飞书通知）、agentGuard（提交期硬拦 secret/超长文件/屎山）、agentSizeWatch（dev 期实时警告超长文件）。在 Vite/Astro 项目里配置 agentGit/agentGuard/agentSizeWatch 或排查 guard 拦截/误报时必读。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Vite Agent Debugger

让在 Vite 项目里干活的 agent 拥有**运行时视野**，跑「读日志 → 定位 → 改 → 重启 dev → 再读验证」的自愈闭环。
配套 npm 包 `vite-plugin-agent-eyes`（源码在本目录 `src/`，可 `npm publish` 或 git 安装）。
如果只需要 agent 操作流程，优先读 `AGENT_GUIDE.md`；如果要让 Codex、Claude、Gemini、Hermes 主动发现并使用，读 `AGENT_BOOTSTRAP.md`；README 面向人类安装和评估。

## 何时用

- 用户报"页面坏了 / 登录不上 / 请求失败 / cookie 问题"，但你**不该靠猜代码**——先读遥测。
- 你自己改完要**验证**：重启 dev、触发操作、读日志确认行为对了。
- 需要还原已登录 UI 或浏览器控制时，先看 `log/<port>/auth-state.json` 确认当前账号画像，再看 `log/<port>/interaction.log` 还原最近交互路径。
- 用户提交被 guard 阻断或要求提前规避明显错误 / 屎山信号时，先读 `log/guard-report.json`。
- 给一个还没接入的 Vite 项目装上这套自愈能力。

## 接入（一次性，默认 1 步）

```ts
// vite.config.ts
import { agentEyes, agentProxy } from 'vite-plugin-agent-eyes'
export default defineConfig({
  plugins: [...agentEyes()],  // 默认：日志 + 自动客户端埋点 + 项目体检 + size watch + 提交 guard
  server: { proxy: { '/api': agentProxy('https://your-api.example.com') } },
})
```

`agentEyes()` 只在 `vite dev` 生效，并会自动向 dev HTML 注入 `autoInstrument()`；普通项目不用再改应用入口。

**如果关闭了自动注入**（`agentEyes({ client: false })`），才需要在应用入口手动加：
```ts
import { autoInstrument } from 'vite-plugin-agent-eyes/client'
autoInstrument()
```

**或手动埋点**（需精细控制时）：
```ts
…

Read the whole file at its exact version.

How to install

mdr add webkubor/vite-plugin-agent-eyes/agent-eyes@sha256:92142e5ab3aa4e74

[![mdr](https://markdownregistry.com/badge/art_6b3hadko447big3l.svg)](https://markdownregistry.com/a/art_6b3hadko447big3l)

Versions

The registry has recorded 8 versions of this file, between Jun 28, 2026 and Nov 3, 2026, about one every 18 days.

Audit of the latest version

Source

API

GET https://markdownregistry.com/api/v1/artifacts/art_6b3hadko447big3l
GET https://markdownregistry.com/api/v1/resolve?ref=webkubor/vite-plugin-agent-eyes/agent-eyes
GET https://markdownregistry.com/api/v1/blob/92142e5ab3aa4e74827e9be4fba1079aa76f54c603da6025c1c2d9726a75df96

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from webkubor/vite-plugin-agent-eyes

Every file in webkubor/vite-plugin-agent-eyes

Browse by kind, by grade A, or by owner.