用途:查找代码库如何发送分析事件,关注具体的埋点代码模式而非事件清单,输出可帮助工程师以与现有代码一致的方式新增事件,并向下游技能说明事件名与属性名的书写约定。
主要能力:1) 定位埋点调用点:连接 Amplitude MCP 时调用 get_events 取样,再用 get_event_properties 查看真实属性名,并用 Grep 在代码库中搜索对应调用点;未连接 MCP 时回退到代码库搜索,关键词包括 .track(、ampli.、amplitude.track|amplitude.logEvent、sendEvent、from.*amplitude|import.*amplitude|require.*amplitude、https://api2.amplitude.com/2/httpapi。2) 识别自定义封装:查找导入 Amplitude SDK 并对外导出 trackEvent()、track() 或 useAnalytics()/useTracking() 等函数或 Hook 的文件,封装视为独立模式。3) 按模式分组:相同库/SDK/函数、方法名、参数结构归为同一模式;直接 SDK、Ampli 类型化方法和自定义封装分别记录。4) 解析命名约定:event_naming_convention 与 property_naming_convention 分别解析,优先级为 Amplitude MCP、代码库、../taxonomy/SKILL.md;证据不足则明确说明,不猜测。5) 输出约定与模式清单,按常见程度排序,含泛化示例与相关路径。
使用方式与限制:排除测试与 mock 文件,除非某模式仅在其中出现;不将 [Amplitude]、[Guides-Surveys]、[Assistant]、[Experiment] 等方括号系统名用于命名推断;MCP 样本不足时回退代码库推断;无任何结果时明确说明并建议检查项目是否已接入分析库,或搜索 Segment、Mixpanel、PostHog 等。具体安装命令与代码示例资料中未完整提供。