mcpField
E
error-tracking-svelte

error-tracking-svelte

github.com/posthog开发7694 次安装今天更新
代码仓库

关于 error-tracking-svelte

为 Svelte 应用添加 PostHog 错误追踪提供指导的技能，面向集成错误监控的开发者。它强调保留现有错误处理、优先启用异常自动捕获，并提供源码映射和框架相关参考。

主要功能

  1. 01指导配置 PostHog 错误追踪
  2. 02建议使用环境变量存放密钥
  3. 03优先启用异常自动捕获
  4. 04提供源码映射与告警参考
  5. 05建议用 Svelte 工具检查组件

适用场景

  1. 01在 Svelte 应用中接入错误监控
  2. 02为错误边界补充手动异常捕获
  3. 03排查无法映射到源码的堆栈
  4. 04验证新建或修改的 Svelte 组件

MCP 相关

建议使用 Svelte MCP 服务查询 Svelte 文档并验证组件，包括调用文档查询工具和 svelte-autofixer。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/posthog/skills --skill error-tracking-svelte

安装后在 Claude Code 中输入/error-tracking-svelte确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
alerts.md
assigning-issues.md
fingerprints.md
monitoring.md
svelte.md
upload-source-maps.md

详细介绍

Svelte 的 PostHog 错误跟踪

此技能可帮助你在 Svelte 应用中添加 PostHog 错误跟踪。

参考文件

  • references/svelte.md - Sveltekit 错误跟踪安装文档
  • references/fingerprints.md - 指纹文档
  • references/alerts.md - 发送错误跟踪警报文档
  • references/monitoring.md - 监控和搜索问题文档
  • references/assigning-issues.md - 将问题分配给队友的文档
  • references/upload-source-maps.md - 上传源映射文档

请参阅文档，了解 API 详情和特定框架的模式。

核心原则

  • 环境变量：始终使用环境变量配置 PostHog 密钥和主机 URL。切勿将其硬编码。
  • 最小化更改：在现有错误处理的基础上添加错误跟踪。不要替换或重构现有错误处理代码。
  • 优先自动捕获：在添加手动捕获之前，先在 SDK 初始化时启用异常自动捕获。
  • 源映射：上传源映射，让堆栈跟踪能解析到原始源代码，而不是压缩后的程序包。
  • 在边界处手动捕获：对于不会传播到全局处理程序的错误，请在错误边界和 catch 块中使用 captureException()。

框架指南

  • 在 svelte.config.js 中将 paths.relative 设置为 false — 这是 PostHog 会话回放在 SSR 下正常运行的必要条件，而且很容易遗漏
  • 使用 Svelte MCP 服务工具检查 Svelte 文档（list-sections、get-documentation）并验证组件（svelte-autofixer）——在完成之前，务必对新增或修改的 .svelte 文件运行 svelte-autofixer

评论

支持 Markdown