mcpField
I
integration-astro-static

integration-astro-static

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

关于 integration-astro-static

用于为静态 Astro 应用添加 PostHog 分析功能的技能。它提供分阶段集成流程和示例，并说明脚本、环境变量及可复用初始化的 Astro 特定做法。

主要功能

  1. 01四步集成流程
  2. 02Astro 示例与文档
  3. 03PostHog 内联脚本指导
  4. 04PUBLIC_ 环境变量指导
  5. 05可复用组件初始化
  6. 06用户识别与错误跟踪

适用场景

  1. 01为静态 Astro 应用添加 PostHog
  2. 02配置客户端项目令牌
  3. 03通过布局复用初始化逻辑
  4. 04识别用户并跟踪错误

安装

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

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

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

包含的文件

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

references/
astro.md
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

详细介绍

PostHog 与 Astro（静态）的集成

此技能可帮助你将 PostHog 分析功能添加到 Astro（静态）应用中。

工作流

按顺序执行以下步骤，完成集成：

  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 - Astro（静态）示例项目代码
  • references/astro.md - Astro - 文档
  • 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 代码添加到现有集成旁边。不要替换或重构现有代码。
  • 遵循示例：实现应尽可能贴近示例项目中的模式。

框架指南

  • 始终在 PostHog 脚本标签上使用 is:inline 指令，避免 Astro 处理这些脚本并导致 TypeScript 错误
  • 在 Astro 中，客户端环境变量使用 PUBLIC_ 前缀（例如 PUBLIC_POSTHOG_PROJECT_TOKEN）
  • 在 src/components/ 中创建 posthog.astro 组件，以便在多个页面中重复使用初始化逻辑
  • 在 Layout 中导入 PostHog 组件，并使用该 Layout 包裹所有页面

用户识别

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

错误跟踪

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

评论

支持 Markdown