mcpField
I
integration-angular

integration-angular

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

关于 integration-angular

用于在 Angular 应用中接入 PostHog 分析的技能。它提供分步集成流程，并针对服务配置、用户识别和错误跟踪给出 Angular 专属指导。

主要功能

  1. 01四步集成流程
  2. 02Angular 示例与文档
  3. 03单例 PosthogService 配置
  4. 04环境配置指导
  5. 05用户识别指导
  6. 06错误跟踪指导

适用场景

  1. 01为 Angular 应用接入 PostHog
  2. 02通过共享服务提供 PostHog
  3. 03在登录和注册时识别用户
  4. 04跟踪关键流程中的错误

安装

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

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

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

包含的文件

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

references/
angular.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

详细介绍

Angular 的 PostHog 集成

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

工作流

按顺序完成集成：

  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 - Angular 示例项目代码
  • references/angular.md - Angular - 文档
  • 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 代码。不要替换或重构现有代码。
  • 遵循示例：实现应尽可能贴合示例项目的模式。

框架指南

  • 使用 inject()，而不是构造函数注入。需要 PostHog 服务的组件/服务应通过 inject() 注入该服务。
  • 创建专用的 PosthogService 单例根服务，用于封装 PostHog SDK。
  • 始终优先使用独立组件，而不是 NgModules。
  • 在 src/environments/environment.ts 文件中配置 PostHog 凭据，因为 Angular 会从这些配置文件中读取环境变量。

识别用户

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

错误跟踪

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

评论

支持 Markdown