SuperAPI AI 工具集

diff-intake

数据与分析

查看项目

更新于 10-15 16:49

技能介绍

用途:作为分析埋点工作流的第一步,读取 PR 或分支 diff,输出机器可读的 YAML 变更简报,供下游技能(discover-event-surfaces、instrument-events)使用。输出需精确、无多余散文。

主要能力:

  1. 收集并分类变更文件。通过 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)。
  2. 构建文件摘要映射。仅处理 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。
  3. 分类整体变更。按 feat/fix/refactor/perf/revert/style/docs/test/build/ci/chore 推断类型与 analytics_scope(none/low/medium/high)。若为 none,则输出简报并说明无需下游技能。
  4. 输出 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 时下游技能不适用。具体认证、平台与收费信息暂未提供。