SuperAPI AI 工具集

pr-visual-guided-review

编程与开发

查看项目

更新于 10-26 07:56

技能介绍

PR Visual Guided Review 是一个用于审查单个 GitHub 拉取请求(PR)并生成交互式 HTML 审查页面的技能。该工具的设计目标是让审查结果以图表优先的方式呈现,便于阅读和理解。

主要能力:

  • 针对一个 GitHub PR 生成一个自包含的 HTML 审查页面,页面包含图表和交互元素。
  • 使用一个全新的智能体来撰写审查,该智能体不继承当前会话的历史,仅能看到提供的 PR 信息。
  • 支持选择用于撰写审查的模型和推理强度,但仅限当前运行时能够启动的模型,且没有默认选项,需要用户明确指定。
  • 审查完成后,返回页面路径、审查结论以及发现问题的数量统计。

使用方式:

  1. 用户需显式调用该技能,并提供 PR 的 URL 或编号。
  2. 用户需指定用于撰写审查的模型和推理强度。
  3. 系统会启动一个全新智能体(无历史上下文),向其提供 PR URL、写作规范文件(references/writer-brief.md)的路径以及输出文件夹路径(可通过 node <skill-dir>/scripts/reviews.mjs path 获取)。
  4. 智能体根据规范撰写审查并生成 HTML 页面。
  5. 用户收到页面路径、结论和问题计数。

文件结构:

  • references/writer-brief.md 是写作规范,指向其他参考文件:references/review-checks.md、references/diagram-types.md、assets/template.html 和 assets/marks.html。这些文件仅由撰写审查的智能体读取。

适用场景:

  • 需要对一个 GitHub PR 进行结构化、可视化审查的开发者。
  • 希望获得图表优先、易于阅读的审查报告的场景。

限制:

  • 仅当用户明确提供 PR URL 或编号时才会运行,不会自动触发。
  • 必须手动选择模型和推理强度,没有默认值。
  • 旧审查报告会一直保留,直到用户请求删除;删除时需运行 node <skill-dir>/scripts/reviews.mjs clean --older-than <days> --dry-run 先预览列表,确认后再去掉 --dry-run 执行。
  • 关于模型支持、平台兼容性、收费等细节,资料中未提供。