launch-analytics

此技能会为一次发布活动添加归因跟踪。以下规则不可妥协：

1. 链接或事件中不得包含个人身份信息（PII）。切勿在 UTM 参数或事件参数中加入电子邮件、姓名或标识符。 遵守项目的同意／Cookie／GDPR 设置；如果存在同意门控，不要绕过它。
2. 采用统一的方案。只定义一次 UTM 规范（使用小写，并记录说明），并将其用于列表页、推广触达和社交媒体上的所有发布链接——标签不一致会导致报告数据分散。
3. 不要破坏现有分析配置。先检测项目当前使用的技术栈；在此基础上扩展，绝不重复添加标签管理器，也不重复触发 page_view。如果没有 GA4，则建议添加，不要想当然。
4. 衡量持久成果。跟踪整个漏斗，直到注册和激活，而不仅仅是访问／点赞——发布活动的价值在于它带来的电子邮件订阅和已激活用户，而非虚荣指标的短暂飙升。
5. 对照当前文档验证代码片段。GA4／gtag 的具体用法会变化；粘贴代码前，请根据当前 Google 文档确认事件语法（使用 docs／find-docs 技能），并根据实际技术栈调整。
6. 绝不捏造数字。配置好衡量方式；只报告工具实际显示的数据。
7. 将工具包写入磁盘的 .ulpi/launch/<channel>/analytics.md（如有需要，创建目录）——产出持久、可直接粘贴使用的文档，而不是转瞬即逝的建议。

launch-analytics

输入

• $request：发布来源和网站／技术栈。由发布技能调用时，调用方会传入 channel（磁盘上的连字符命名输出目录，例如 product-hunt）、GA 的 utm_source 值（例如 producthunt，不带连字符）以及目标链接。独立调用时，询问发布来源、网站 URL 和当前分析技术栈（默认使用根据来源生成的 channel 名称）。

目标

将一套发布归因工具包写入 .ulpi/launch/<channel>/analytics.md：统一的 UTM 方案、逐链接 UTM 映射、转化漏斗的 GA4（或现有技术栈）事件计划、接入代码片段，以及验证和结果解读计划。

步骤 0：确定来源和技术栈

确定 channel（输出目录名称，例如 product-hunt）和 GA 的 utm_source 值（例如 producthunt）——两者应保持区分；并检测当前的分析工具：查找 GA4／gtag.js、Google Tag Manager、Plausible／Fathom／PostHog，或确认没有分析工具。成功标准：已确认 channel、utm_source 和实际使用的分析技术栈。

步骤 1：定义 UTM 方案和链接映射

加载 references/utm-and-events.md。采用统一规范（小写、连字符分隔），并生成 UTM 映射表——为每个发布链接添加标签，标明其展示位置：

• utm_source = 平台（例如 producthunt）
• utm_medium = 投放位置（例如 launch、maker-comment、email、social）
• utm_campaign = 发布活动（例如 ph-launch-2026-06）
• utm_content = 具体链接（例如 x-thread、wave1-email、gallery-cta）

由发布技能调用时，将带标签的链接交还调用方（列表页／推广触达），确保每个链接都可归因；独立调用时，写入文档的带标签链接映射表就是交付给用户应用的成果。成功标准：采用单一方案，且每个链接展示位置都有带标签的链接。

步骤 2：映射漏斗和事件

定义转化漏斗，以及标记各步骤的事件——通常包括 page_view（自动触发）→ sign_up → 一个关键的激活事件（用户首次获得实际价值的时刻）。在 GA4 中将 sign_up 和激活事件标记为转化／关键事件。成功标准：漏斗每一步都有命名事件，且关键事件已标记为转化。

步骤 3：接入跟踪

提供适用于实际技术栈的跟踪代码片段（GA4 gtag('event', …) 或等效代码），并根据当前文档完成验证；同时说明应将代码添加到何处。保持精简，并遵循用户同意要求。 成功标准：代码可直接复制粘贴，适配技术栈且不会重复触发事件。

第 4 步：验证并读取数据

提供验证步骤（通过 GA4 DebugView / Realtime 确认事件是否以正确参数触发），并制定简单的数据读取计划：在哪里查看发布当天按 utm_source 划分的流量、按来源划分的注册数，以及漏斗转化率。成功标准：用户可以在发布前确认跟踪正常工作，并在发布后读取结果。

第 5 步：保存工具包

将以上所有内容写入 .ulpi/launch/<channel>/analytics.md（如有需要，创建目录）：UTM 方案 + 已添加标签的链接映射、漏斗/事件计划、接入代码片段，以及验证/数据读取步骤。<channel> 是调用方传入的连字符分隔的发布代号（例如 product-hunt），与 utm_source 不同。成功标准：磁盘上存在一份持久保存、可直接粘贴使用的 analytics.md。

防护措施

• UTM 或事件参数中不得包含 PII；遵守用户同意要求/GDPR。
• 采用一套有文档记录的方案；全部使用小写；每个链接都使用同一套方案。
• 扩展现有技术栈；不要重复埋点或破坏用户同意机制。
• 跟踪注册/激活，而不只是访问量；关注持久的成果，而非虚荣指标。
• 根据最新文档验证 GA4/gtag 语法；根据实际技术栈调整。
• 只报告真实数据；绝不捏造。

何时加载参考资料

• references/utm-and-events.md — UTM 规范 + 单个链接映射、GA4 事件分类和转化设置、接入代码片段模式，以及验证步骤（第 1–4 步）。

输出约定

写入 / 返回 .ulpi/launch/<channel>/analytics.md：

1. UTM 方案 + 每个发布链接的已添加标签链接映射
2. 漏斗及其事件，并将 sign_up/激活标记为转化
3. 适用于实际技术栈的接入代码片段（根据最新文档验证）
4. 验证步骤（DebugView/Realtime）和数据读取计划（按来源划分的流量/注册数）