agent-skills
为AI智能体提供结构化日志最佳实践指导的Skill
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：agent-skills。 它的用途是：为AI智能体提供结构化日志最佳实践指导的Skill 完整的 Skill 内容见：https://321skill.com/skills/agent-skills-boristane/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“为这个用户登录的API端点添加日志。” 它会依据Skill的指导，生成一条包含用户ID、请求ID、登录结果、地理位置（如果可用）等丰富上下文的“宽事件”日志行，而不是多个分散的日志语句。或者，当您说“帮我审查一下这段日志代码”时，AI会检查代码是否遵循了单一Logger实例、在中间件中记录基础设施信息等关键原则。
介绍
这个Skill旨在解决开发者在编写日志代码时面临的痛点：日志散乱、信息不足、难以追踪和调试。它提供了一套基于“宽事件”理念的结构化日志指导原则，帮助开发者输出高价值、可分析的日志数据。
Skill以预定义的规则和指南形式存在，当AI智能体（如Claude、Cursor等）在处理与日志相关的任务时，会自动调用这些知识来生成或审查代码。例如，当开发者要求“为这个API端点添加日志”时，AI会依据Skill中的最佳实践来编写包含业务上下文、环境信息和高基数维度的日志行。
它非常适合后端开发者、DevOps工程师以及任何需要为服务建立可观测性基础的人员。无论是设计新服务的日志策略，还是优化现有系统的日志代码，这个Skill都能提供专业指导。
与许多仅提供通用代码片段或基础语法提示的AI助手不同，这个Skill深度集成了业界先进的日志理念（如Stripe的“规范日志行”），专注于通过一次富上下文的事件记录来提升调试和监控效率，而非简单地插入console.log语句。
核心特点
本Skill的核心区别在于其严格遵循“宽事件”和“高基数维度”的先进日志哲学，强调为每个请求在每个服务中只生成一条包含全部关键上下文的规范日志行，这与大多数提供零散、通用日志代码片段的工具有本质不同。
注意事项
该Skill主要面向服务端应用的结构化日志设计，对于前端简单的调试日志或特定小众日志库的深度集成场景可能不够适用。
常见问题
这个Skill能帮我自动写日志代码吗？
是的，当您向集成了此Skill的AI智能体提出添加或审查日志的需求时，它会依据最佳实践自动生成或优化代码。
它支持哪些编程语言或日志框架？
Skill提供的是与语言和框架无关的指导原则（如高基数维度、业务上下文），可应用于任何支持结构化日志的环境，具体实现需结合所用语言（如JavaScript/Node.js, Python, Go等）的日志库。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/agent-skills-boristane/raw/index.md 读取 agent-skills 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/agent-skills-boristane/raw/index.md（查看排版版本）