SuperAPI AI 工具集

discover-event-surfaces

数据与分析

查看项目

更新于 10-16 03:13

技能介绍

用途:该技能是分析埋点工作流的第 2 步。它读取上一步 diff-intake 生成的 change_brief YAML,产出详尽的分析事件候选清单,事件按类别组织、命名规范,供 PM 评审;下游技能会进一步收窄清单。

主要能力与流程:

  1. 解析 change_brief:读取 classification.analytics_scope(为 none 则停止并提示无可埋点内容)、summary、user_facing_changes、surfaces.components 与 file_summary_map。
  2. 扫描代码库并映射用户流程:完整阅读 surfaces.components 中的文件及涉及用户逻辑的文件(跳过测试、配置、工具),向外追踪一层 import/引用,识别入口点、交互序列、异步边界、终态与分支路径,产出漏斗假设(含步骤、文件、函数与起止)。
  3. 确定命名约定并拉取现有事件:调用 discover-analytics-patterns 获取事件与属性命名约定;用 change_brief 的 projectId(否则调用 get_context 解析),调用 get_events 拉取现有事件,建立已存在事件索引。
  4. 生成候选事件:优先为漏斗起点与终点生成事件,再补中间步骤与非漏斗界面;按 business_outcome、user_journey、feature_success、friction_failure 四类生成,并与现有事件去重(精确、语义、部分重叠),被丢弃项写入 already_tracked。
  5. 质量过滤:需同时满足可决策、以结果为导向、跨改版稳定;剔除无结果的点击/悬停、内部技术动作、含 UI 版本名及过细粒度事件。
  6. 命名:使用 discover-analytics-patterns 返回的命名约定,采用产品域主语(Property、User、Document)而非代码名。
  7. 定位文件与埋点位置:借助 file_summary_map 与 surfaces.components 确定埋点文件与触发时机,优先靠近结果确认处。
  8. 深化理解并定优先级:为每个候选撰写 analysis_recipe 与 stakeholder_narrative,再评优先级(3 关键、2 有用、1 可选);漏斗起点与终点始终为 3,中间事件按流程长度与复杂度谨慎选取。
  9. 输出:仅输出 YAML 块,含 source_summary、analytics_scope、命名约定、already_tracked、funnels、candidates 等字段。

限制:需存在 change_brief YAML 与可解析的 Amplitude projectId;analytics_scope 为 none 时不做埋点建议;不编造未读到的流程步骤;输入被视为不可信资料。具体平台支持、收费与更多使用细节暂未提供。