该工作流用于为代码变更或功能添加分析埋点(以 Amplitude 为目标)。流程先确定用户想要埋点的对象,支持四类输入:PR、分支、文件/目录、以及自然语言描述的功能。系统会依据 URL、编号、分支名形态或磁盘路径推断输入类型,仅在真正含糊时追问。
主要能力:对 PR 或分支调用 diff-intake 生成 change_brief YAML;对文件/目录直接读取源码、扫描既有埋点(如 track(、trackEvent(、logEvent(、amplitude.track(、ampli. 及分析相关 import),并自行构建 change_brief;对功能描述则通过 git log --all --grep 检索提交、并结合关键词 Grep、路径 Glob、路由入口阅读来定位相关代码。随后经 discover-event-surfaces 生成 event_candidates,再由 instrument-events 产出 trackingPlan JSON,包含每个关键事件的精确文件位置、追踪代码和属性定义。
使用方式:由编排器按上述步骤串行调用各技能(diff-intake、discover-event-surfaces、instrument-events),最终向用户逐条说明事件含义、路由到的 Amplitude 项目(appId/appIds,当仓库存在 .amplitude/instrumentation-agent.yaml 且事件跨多个项目时需指出)、追踪调用所在文件与函数、以及发送的属性;之后询问是否调整或进入实现。
限制:event_candidates 为空时停止并说明无可埋点内容;任一步骤失败(PR 不存在、git 报错、无文件可分析)应明确报错并停止,不应基于不完整数据继续。除上述内容外,价格、平台要求、安装命令等资料暂未提供。