mcpField
S
statistik

statistik

github.com/dischen87其他09 次安装今天更新
代码仓库

关于 statistik

statistik 是指导 Agent 为网站设计并接入 PostHog 统计的技能，适合希望衡量关键网站行为的运营者。它强调先规划事件、只在操作成功后计数，并减少对访客数据的收集。

主要功能

  1. 01规划少量且明确的统计事件
  2. 02配置 PostHog EU 项目
  3. 03以无 Cookie 设置接入统计
  4. 04在操作成功后记录事件
  5. 05过滤内部访问并验证数据

适用场景

  1. 01统计网站页面访问
  2. 02衡量联系表单提交成功次数
  3. 03核对统计事件与实际咨询量

安装

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

$npx skills add https://github.com/dischen87/albatros-skills --skill statistik

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

详细介绍

# 统计：店门口的划线计数

这个比喻

店主在门口划线计数。她只数事先列在清单上的内容，而且只有事情真的发生后才划线：顾客已经付款，而不是刚拿出钱包。她不会记住顾客的长相。

你的网站统计也应该这样运作：只记录少量、名称明确的划线，在恰当的时刻计数，不储存超出必要范围的访客信息。统计中的一条划线称为事件。

如何运用这个比喻： 在你的第一条回复中，先把这个比喻讲给对方听，再提问或展示命令，即使对方一上来就想要解决方案也一样。

沟通方式

  • 不要只提问： 如果缺少项目或某项信息，仍然给出具体步骤，或者先起草文件并标出假设（[假设：……]）。最后再询问缺少的内容。
  • 使用「你」的称呼，不用专业术语。只有在讲完划线计数的比喻后，才使用「事件」一词。
  • 隐私保护不是附带事项。任何会储存更多个人信息的设置都需要有合理理由，并在隐私声明中说明（技能 recht-ch）。
  • PostHog 账户由对方自行在浏览器中创建。对方可以把项目密钥（以 phc_ 开头）提供给你，它用于网站，属于公开信息。个人 API 密钥（phx_）绝不能写入代码。

流程

1. 先列清单，再接入

和对方一起创建 docs/statistik.md。开始时只需一个目标事件：对方关心的行动（见 docs/plan.md 的「我们如何判断成功」）。

# Ereignis-Plan

| Ereignis | zählt wenn | Pflicht-Angaben |
|---|---|---|
| `$pageview` | automatisch bei jedem Seitenaufruf | – |
| `generate_lead` | Formular erfolgreich abgeschickt (Server hat bestätigt) | `form` (welches Formular) |
| `sign_up` | Newsletter-Anmeldung bestätigt | `location` (wo auf der Seite) |

Eigene Besuche: herausgefiltert seit <Datum>
Änderungen: <Datum> – <was umbenannt, warum>

命名规则：使用小写字母和下划线（generate_lead），优先采用常见的标准名称（purchase、sign_up、generate_lead），每个行动对应一个事件，变体作为属性记录（form: "kontakt"），不要按位置命名（schritt_2）。

2. 创建 PostHog 项目

对方注册 PostHog，选择 EU 区域并创建项目。然后对方将项目密钥提供给你。

3. 接入

将 PostHog 指南中最新的接入代码片段（「Web snippet」）放入每个页面的 <head> 中，并使用以下设置：

posthog.init('phc_…', {
  api_host: 'https://eu.i.posthog.com',
  persistence: 'memory',              // keine Cookies, kein Banner nötig
  person_profiles: 'identified_only', // keine Profile von anonymen Besuchern
})

persistence: 'memory' 表示：每次页面浏览都会计数，但 PostHog 不会通过 Cookie 记住任何访客。因此，「独立访客」的数据会不够准确。请检查最新的 PostHog 指南，确认现在是否已有更好的无 Cookie 设置。

4. 在恰当的时刻记录目标事件

只有成功后才计数，不要在打开表单时计数：

// nachdem der Server das Formular bestätigt hat:
posthog.capture('generate_lead', { form: 'kontakt' })

绝不要将姓名、电子邮件地址、电话号码或自由文本作为属性一并发送。

5. 过滤自己的访问

在 PostHog 的项目设置中，启用「过滤内部用户和测试用户」，并设置过滤器（例如自己的 IP 地址）。在 docs/statistik.md 中记录日期。

6. 检查
  1. 日志簿和流水线（技能 git-logbuch、pipeline）。
  2. 打开页面，测试提交一次表单。
  3. 在 PostHog 的「Activity」或「Live events」中，是否出现了带有 form 属性的 $pageview 和 generate_lead？
  4. 一周后：generate_lead 的数量是否大致与邮箱中的实际咨询数量相符？如果不符：事件是不是在打开表单时触发，而不是成功后触发？测试是否也被计入了？

常见问题

  • 事件在加载时而非成功后触发：尝试会被当作成功。
  • 一次添加太多事件：没人会查看。宁可先做好三个。
  • 重命名事件，却没有调整分析：看起来就像数据突然暴跌。
  • 忘记隐私声明：必须在其中说明 PostHog、用途和所在区域（技能 recht-ch）。

检查任务

使用 mission_pruefen 检查 webseite-07-statistik。检查会确认 ~/projekt/docs/statistik.md 是否存在，以及页面是否包含 PostHog 接入代码。

## 最终消息

你在此步骤中的最后一条消息以一句关于图片“店门口的记数表”的话开头，再次点明核心。然后说明：完成了什么、结果在哪里、还有什么未完成，以及接下来要做什么。

评论

支持 Markdown