用途
本技能是一个产品遥测工程技能，用于把追踪计划（tracking plan）转化为面向特定分析 SDK 的埋点实施指南。它不重复追踪计划中的每一个事件，而是展示核心调用模式、SDK 语法和约束，供后续实施阶段套用到完整事件列表。最终产出 .telemetry/instrument.md，作为实施阶段遵循的契约。
主要能力
- 映射三个核心分析调用：identify（用户识别）、group（分组）、track（事件追踪），提供目标 SDK 的真实模板代码。
- 处理分组层级：说明每个分组层级如何映射到 SDK，多层级嵌套如何处理，以及事件级分组归属的 SDK 特定模式。
- 支持多种目标平台参考，包括：
- 产品分析与 CDP：Segment、Amplitude、Mixpanel、PostHog、RudderStack
- B2B 互动平台：Accoil、CustomerScore.io、Intercom、Journy
- 全栈与 Web 分析：Google Analytics (GA4)、Usermaven、Plausible、Fathom、Simple Analytics、Microanalytics、Cabin (WithCabin)、Cloudflare Web Analytics
- 错误与性能监控：Sentry、New Relic、Azure Application Insights
- 功能开关与实验：LaunchDarkly、Statsig
- 产品采用平台：Userpilot
- 会话与行为工具：HotJar
- 标签管理：Google Tag Manager
- 平台与架构：Forge platform、通用 HTTP 架构
- 文档化架构：初始化、客户端与服务端路由、关闭/刷新、错误处理、环境变量、SDK 特定约束。
- 提供验证方法：如何确认事件到达目标、预期延迟、成功与失败投递的表现、开发环境测试方式。
- 提供上线策略：分阶段（先生命周期事件，再核心价值事件）或一次性上线。
使用方式
- 前置检查：需要 .telemetry/tracking-plan.yaml（必需），若不存在则停止并提示用户先运行 product-tracking-design-tracking-plan 技能。可选读取 .telemetry/current-implementation.md 获取现有 SDK 设置上下文。
- 验证参考文件访问：先读取 references/behavioral-rules.md 和 references/accoil.md，再读取与目标 SDK 匹配的参考文件，逐一确认可访问。
- 确定目标 SDK：优先从上游产物（tracking-plan.yaml 的 meta 块、product.md 的 Integration Targets）继承，仅在无上下文时询问用户。
- 多目标指引：若追踪计划列出多个分析目标，建议使用 CDP（Segment、RudderStack）作为单一接入层；若已有 CDP，则指南仅针对 CDP 的 SDK。
- 语言感知：指南需匹配用户技术栈。TypeScript/JavaScript 使用完整类型安全；Ruby、Python、Go、Java 等使用通用 HTTP 架构与语言对应实现；纯前端可直接调用分析 SDK，但优先后端路由以保护 API 密钥。
- 扫描现有约定：有针对性地查看路由/端点、2-3 个关键模型/服务、依赖清单、后台任务基础设施、现有分析调用，提取 HTTP 客户端、后台任务、模块组织、配置管理等约定，并遵循这些约定设计遥测实现。
- 加载追踪计划，映射 identify()、group()、track()，文档化分组级归属与架构，编写验证与上线策略。
- 读取 references/output-template.md 获取输出结构，将指南写入 .telemetry/instrument.md，并在对话中仅给出简洁摘要（不超过 20 行）。
适用场景
- 已有追踪计划，需要为特定分析 SDK 生成埋点实施指南。
- 需要统一 identify、group、track 调用模式，避免散落的原始字符串。
- 需要处理多层级分组归属（如 account > workspace > project）。
- 需要为后续实施阶段提供可复制粘贴的完整模块代码。
限制
- 并非所有目标都支持完整的 identify → group → track 模型。Web 分析工具（Plausible、Fathom 等）仅追踪页面浏览和简单事件；错误监控工具（Sentry、New Relic）提供调试用用户上下文而非产品分析；功能开关工具（LaunchDarkly、Statsig）管理定向上下文和实验曝光。每个参考文件记录该工具支持与不支持的内容。
- 分组层级支持强度不同：Segment、Mixpanel、PostHog 较强；Amplitude 中等；GA4 和基础 HTTP 目标较弱。若追踪计划使用多层级分组而目标系统支持弱，需注明差距并建议变通方案。
- Accoil 是例外：track 调用不携带分组上下文，仅含 userId 和事件名，归属来自用户成员关系与 parent_group_id 特征的汇总。
- 必须读取匹配的 SDK 参考文件后才能产出内容；若为 Forge，还需读取 Forge 平台参考和目标 SDK 参考。
- 输出为文件，对话中仅展示摘要，不得粘贴超过 20 行。
- 质量规则：展示模式而非目录；使用真实 SDK 语法；提供完整可复制粘贴的代码；使用单一投递任务（带方法/动作参数），避免为每种调用类型创建独立任务类。
后续阶段
生成实施指南后，建议用户运行 product-tracking-implement-tracking，从该指南生成真实埋点代码。