agent-skill
AI编码代理的可观测性技能包
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:agent-skill。 它的用途是:AI编码代理的可观测性技能包 详细介绍见:https://321skill.com/skills/agent-skill-honeycombio/ 请根据该页面的说明完成安装。
使用示例
'帮我排查一下用户登录接口最近5分钟的错误激增原因',它会自动调用honeycomb-investigator智能体,查询Honeycomb中的追踪数据和指标,进行多步骤根因分析,最终给出可能的慢查询、异常堆栈或依赖服务故障。
介绍
Honeycomb Agent Skill 为AI编码代理提供开箱即用的可观测性能力。它包含9个预设技能、2个专用智能体和1个交互式配置命令,覆盖查询模式、生产故障排查、SLO与触发器管理、OpenTelemetry 埋点接入以及Beeline迁移指导。无论你是用Claude Code、Cursor还是OpenAI Codex,都能通过插件市场一键安装,让AI助手直接理解Honeycomb数据模型,自主完成多步骤的生产调试和代码分析。
使用方式非常简单:在支持的AI编码工具中通过插件市场安装该技能包,然后通过 /honeycomb-setup 命令交互式配置Honeycomb MCP服务器。安装后,AI代理会自动获得可观测性领域知识,你可以在提问时直接触发预设技能,例如“帮我排查这个查询的慢路径”或“分析当前SLO状态”。对于复杂场景,honeycomb-investigator 智能体可以自主执行多步骤根因分析,instrumentation-advisor 智能体则能提示代码库与Honeycomb之间的埋点差距。
适合所有使用AI编码助手并依赖Honeycomb进行可观测性的团队,尤其是后端开发、运维工程师和数据分析师。它也适合正在从Beeline迁移到OpenTelemetry的团队,以及需要快速建立生产环境调试能力的组织。
建议在安装后先通过 /honeycomb-setup 完成MCP服务器配置,确保AI代理能查询到真实数据。对于首次使用Honeycomb的用户,建议先熟悉Honeycomb基础概念再启用技能包。注意:该技能包需要访问Honeycomb API,请确保API密钥有足够的权限。
核心特点
与通用可观测性提示词不同,Honeycomb Agent Skill 是官方维护的深度集成包,包含预构建的智能体可自主执行多步骤生产调试和埋点差距分析,无需手动编写复杂查询。
注意事项
不适用于不使用Honeycomb作为可观测性后端的项目,且需要正确的Honeycomb API密钥和网络访问权限。
常见问题
如何配置Honeycomb MCP服务器?
在Claude Code或Cursor中使用 `/honeycomb-setup` 命令即可交互式完成配置,需要提供Honeycomb API密钥和数据集名称。
支持哪些AI编码工具?
支持Claude Code、Cursor、OpenAI Codex、Augment (Auggie CLI)、GitHub Copilot CLI等,部分工具需要手动配置技能目录和MCP设置。