用途:作为分析埋点工作流的第一步,读取 PR 或分支 diff,输出机器可读的 YAML 变更简报,供下游技能(discover-event-surfaces、instrument-events)使用。输出需精确、无多余散文。
主要能力:
- 收集并分类变更文件。通过 gh pr view <number-or-url> 或 git log/git diff --stat <main|master>..<branch> 获取变更列表,按路径归类为 Core Logic、Generated、Testing、Config/Dependencies、Documentation、Noise,并记录 path、category、change type、analytics likelihood(1–5)。
- 构建文件摘要映射。仅处理 Core Logic 文件,用 git diff <baseRefOid>...<headRefOid> -- <files> 或 git diff main..feature/foo -- <files> 获取详细 diff,为每个文件记录 summary、stack(frontend/backend/shared),并派生 user_facing_changes 与 surfaces.components(name、file、change)。后端专属或无交互界面时省略 surfaces.components。
- 分类整体变更。按 feat/fix/refactor/perf/revert/style/docs/test/build/ci/chore 推断类型与 analytics_scope(none/low/medium/high)。若为 none,则输出简报并说明无需下游技能。
- 输出 YAML 简报。仅输出 YAML 块,格式含 classification(primary、types、analytics_scope、stack)、summary、user_facing_changes、surfaces.components、file_summary_map(逐文件列出,不用 glob)。
使用方式:按步骤执行,先取变更文件并分类,再读 Core Logic 文件生成摘要,随后分类整体变更,最后输出 YAML。遇到 PR 号或分支名歧义时自行推断,除非认证失败否则不询问。
适用场景:需要为代码变更自动生成埋点分析简报的工程与分析协作流程。
限制:仅处理 Core Logic 文件生成摘要;无交互界面时不虚构 surfaces;analytics_scope 为 none 时下游技能不适用。具体认证、平台与收费信息暂未提供。