用途:这是一个面向分析埋点的技能,用于在代码拉取请求(PR)中按项目既有分类体系添加 Amplitude 追踪,避免分类漂移。核心原则是分类优先、少即是多、遵循代码库而非文档、写回追踪计划需用户明确同意。
主要能力:读取 diff 识别候选用户行为;通过 Amplitude MCP 服务器调用 get_amplitude_context、get_workspace_context、get_events、get_properties 等了解现有事件与属性,推断命名约定;检测项目使用的 Amplitude SDK 与追踪封装;对候选行为做判断测试并产出事件规格表;通过项目既有封装实现埋点;可选地在 Amplitude 中创建分支并写入新事件与属性。
使用方式:先理解变更并列出候选行为,再学习分类体系(预算 4–8 次工具调用),检测 SDK 与追踪模式,设计事件,在 PR 中实现,最后按需同步追踪计划并输出可粘贴到 PR 描述的报告。若 diff 无用户可见行为变化,应说明无需埋点并停止。
适用场景:为功能 PR 添加或更新 Amplitude 埋点,复用既有事件与属性,保持命名与类型一致。
限制:不编造事件或属性名;不添加 SDK 依赖或初始化;不将 PII 写入属性;写回追踪计划需用户明确同意,且只创建分支不合并;无 SDK 时停止并建议单独处理;分类体系为空时需明确说明是在建立先例。