用途:instrument-events 是分析埋点工作流(analytics instrumentation workflow)的第三步。它接收 discover-event-surfaces 产出的 event_candidates YAML,为优先级为 3(关键)的事件生成一份工程师可逐行落地的埋点计划。它按软件架构师审查 PR 的视角,强调与既有模式一致、最小改动,以及只保留真正驱动仪表盘的属性。
主要能力:先读取 ../taxonomy/SKILL.md 理解事件命名标准;从 event_candidates YAML 中仅筛选 priority: 3 的事件,若无则告知用户并停止,并列出筛选结果供确认。随后逐个事件:读取提示的 file 与 instrumentation 字段,定位确切的插入点(结果确认处而非动作发起处,并参考附近已有 track() 调用);基于插入点作用域内的变量设计属性,只保留可用于图表维度或筛选的原始类型值,通常每事件 2-4 个;调用 discover-analytics-patterns 获取 event_naming_convention 与 property_naming_convention 并遵循其命名解析流程;与已有埋点调用对比导入、函数、属性形状与放置模式,保持一致。最终输出指定结构的 JSON 跟踪计划(含 trackingRequired、reasoning、existingPattern、trackingPlan,其中每个事件含 eventName、eventProperties、eventDescriptionAndReasoning、implementationLocations),并向用户逐事件讲解、询问是否调整。
限制:仅处理 priority 3;不改动代码,也不提出为传递数据而重构(属单独 PR);只使用插入点处可用的变量,若重要属性在别处,仅在 reasoning 中记录,不写入计划;命名细则以 discover-analytics-patterns 为准,本技能不重复定义。收费、平台、效果等信息暂未提供。