SuperAPI AI 工具集

discover-analytics-patterns

数据与分析

查看项目

更新于 10-15 16:49

技能介绍

用途:找出代码库中发送分析事件的真实代码模式,而非事件清单,便于新增事件与现有代码保持一致,并向下游技能说明事件名与属性名的书写习惯。

主要能力:按优先级确定命名约定,依次为 .amplitude/instrumentation-agent-context.md 中的客户指令、Amplitude MCP 服务器观察到的事件与属性、代码库中真实埋点调用点、../taxonomy/SKILL.md。若 MCP 已连接,用其分类读取器取非系统产品事件样本,再用事件属性读取能力查看真实属性名;随后用 Grep 搜索这些事件名定位调用点。若 MCP 不可用,则搜索 .track(、ampli.、amplitude.track|amplitude.logEvent、sendEvent、amplitude 导入语句、https://api2.amplitude.com/2/httpapi 等信号,并主动查找自定义封装(如 trackEvent()、track()、useAnalytics()、useTracking())。排除测试与 mock 文件,除非模式仅出现在那里。

使用方式:先读仓库埋点上下文;再按上述两种路径查找调用;按库/SDK/函数、方法名、参数结构分组,封装与底层 SDK 调用分开记录;分别解析事件命名约定与属性命名约定;最后先输出约定,再按出现频率从高到低列出每个唯一模式,含描述、泛化示例(导入与调用)和相关路径。

适用场景:为代码库补充埋点、统一事件命名、让新事件与既有风格一致。

限制:不得从 [Amplitude]、[Guides-Surveys]、[Assistant]、[Experiment] 等方括号系统名推断命名;证据不足时明确说明,不猜测;若未找到任何埋点调用,应提示用户确认是否已接入 Amplitude 或其他分析库,并可代为搜索 Segment、Mixpanel、PostHog 等。