mcpField
I
integration-sveltekit

integration-sveltekit

github.com/posthog数据与数据库7696 次安装今天更新
代码仓库

关于 integration-sveltekit

用于在 SvelteKit 应用中集成 PostHog 分析的技能，按阶段指导配置，并提供用户识别与错误跟踪建议。

主要功能

  1. 01四阶段集成流程
  2. 02SvelteKit 配置指南
  3. 03通过环境变量管理密钥
  4. 04用户识别建议
  5. 05错误跟踪建议
  6. 06Svelte 组件校验

适用场景

  1. 01为 SvelteKit 应用添加 PostHog
  2. 02为登录和注册添加识别逻辑
  3. 03为关键流程添加错误跟踪

MCP 相关

该技能要求使用 Svelte MCP 服务工具查阅文档并校验组件。

安装

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

$npx skills add https://github.com/posthog/skills --skill integration-sveltekit

安装后在 Claude Code 中输入/integration-sveltekit确认已加载。

包含的文件

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

references/
basic-integration-1.0-begin.md
basic-integration-1.1-edit.md
basic-integration-1.2-revise.md
basic-integration-1.3-conclude.md
EXAMPLE.md
identify-users.md
svelte.md

详细介绍

SvelteKit 的 PostHog 集成

此技能可帮助你将 PostHog 分析功能添加到 SvelteKit 应用中。

工作流

按以下步骤顺序完成集成：

  1. basic-integration-1.0-begin.md - PostHog 设置 - 开始 ← 从这里开始
  2. basic-integration-1.1-edit.md - PostHog 设置 - 编辑
  3. basic-integration-1.2-revise.md - PostHog 设置 - 修订
  4. basic-integration-1.3-conclude.md - PostHog 设置 - 总结

参考文件

  • references/EXAMPLE.md - SvelteKit 示例项目代码
  • references/svelte.md - Svelte - 文档
  • references/identify-users.md - 识别用户 - 文档
  • references/basic-integration-1.0-begin.md - PostHog 设置 - 开始
  • references/basic-integration-1.1-edit.md - PostHog 设置 - 编辑
  • references/basic-integration-1.2-revise.md - PostHog 设置 - 修订
  • references/basic-integration-1.3-conclude.md - PostHog 设置 - 总结

示例项目展示了目标实现模式。请参阅文档了解 API 详情。

核心原则

  • 环境变量：始终使用环境变量存储 PostHog 密钥。切勿将密钥硬编码。
  • 尽量减少改动：在现有集成旁添加 PostHog 代码。不要替换或重构现有代码。
  • 遵循示例：实现应尽可能贴合示例项目中的模式。

框架指南

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

识别用户

在登录和注册事件期间识别用户。请参阅示例代码和文档，了解此框架的正确识别模式。如果同时存在前端和后端代码，请使用 X-POSTHOG-DISTINCT-ID 和 X-POSTHOG-SESSION-ID 标头传递客户端会话和 distinct ID，以保持关联。

错误跟踪

在相关文件中添加 PostHog 错误跟踪，尤其是在关键用户流程和 API 边界附近。

评论

支持 Markdown