参考
Agent 技能
使用 Agent 技能进行 AI 辅助代码审查和 evlog 迁移。借助 Agent 技能，让 AI 审查你的日志模式并指导迁移到宽事件。
evlog 包含帮助 AI 助手审查日志模式并指导 evlog 采用的 Agent 技能。
什么是 Agent 技能？
Agent Skills 是一种用于打包 AI 助手能力的开放规范。技能提供：
- 领域知识：宽事件和结构化错误处理的最佳实践
- 代码审查：识别代码库中的日志反模式
- 引导迁移：逐步帮助迁移到 evlog
可用的技能
| 技能 | 描述 |
|---|---|
skills/review-logging-patterns | 审查代码中的日志模式，建议采用 evlog，并指导宽事件设计 |
skills/build-audit-logs | 设计、接入和审查防篡改审计轨迹：策略、auditEnricher、auditOnly、signed、拒绝、脱敏、测试 |
skills/analyze-logs | 分析 .evlog/logs/ 中的应用日志，用于调试错误、排查性能和理解行为 |
安装技能
兼容的代理（Cursor、Claude Code 等）可以自动发现并使用技能。
若要手动使用 skills CLI 安装，请运行：
Terminal
npx skills add https://www.evlog.dev
技能的作用
代码审查
该技能会分析你的代码库，识别以下问题：
- 分散的日志记录：请求处理程序中多个
console.log或logger.info调用 - 缺少上下文：没有用户、请求或业务上下文的日志
- 无用的错误：不带结构化字段的
throw new Error() - 关联缺失：缺少请求 ID 或跟踪 ID
迁移指导
该技能可帮助你：
- 将传统日志转换为宽事件
- 设计高效的宽事件架构
- 使用
why、fix和link实现结构化错误 - 在 Nuxt、Nitro 或独立 TypeScript 中设置 evlog
日志分析
analyze-logs 技能可让 AI 助手读取 .evlog/logs/ 中的结构化日志：
- 错误调试：查找并解释错误、堆栈跟踪和失败模式
- 性能调查：通过持续时间识别缓慢请求
- 请求跟踪：使用
requestId跟踪请求的生命周期 - 模式检测：发现重复问题或异常
示例提示
向你的 AI 助手提问：
Review my code for logging anti-patterns
Convert console.log calls to a wide event
Suggest context to add to my wide event
Design or review an audit trail with evlog
Structure this error with evlog
Debug a failing endpoint from logs
Find the slowest requests from today
技能结构
skills/
├── review-logging-patterns/
│ ├── SKILL.md # 主要技能说明
│ └── references/
│ ├── wide-events.md # 宽事件模式
│ ├── structured-errors.md # 错误处理指南
│ └── code-review.md # 审查清单
├── build-audit-logs/
│ ├── SKILL.md # 审计策略、接入、审查清单
│ └── references/
│ └── framework-wiring.md
└── analyze-logs/
└── SKILL.md # .evlog/logs/ 的日志分析
参考文档
该技能包含提供以下内容的参考文档：
wide-events.md
- 宽事件结构与最佳实践
- 上下文分组模式
- 输出格式示例
structured-errors.md
- 错误字段定义
- 状态码指南
- 前端集成模式
code-review.md
- 日志代码审查清单
- 要识别的常见反模式
- 迁移建议
下一步
- Quick Start - 快速开始使用 evlog
- Wide Events - 了解宽事件设计
- Structured Errors - 错误处理模式