PR Visual Guided Review 是一个用于审查单个 GitHub 拉取请求(PR)并生成交互式 HTML 审查页面的技能。该工具的设计目标是让审查结果以图表优先的方式呈现,便于阅读和理解。
主要能力:
- 针对一个 GitHub PR 生成一个自包含的 HTML 审查页面,页面包含图表和交互元素。
- 使用一个全新的智能体来撰写审查,该智能体不继承当前会话的历史,仅能看到提供的 PR 信息。
- 支持选择用于撰写审查的模型和推理强度,但仅限当前运行时能够启动的模型,且没有默认选项,需要用户明确指定。
- 审查完成后,返回页面路径、审查结论以及发现问题的数量统计。
使用方式:
- 用户需显式调用该技能,并提供 PR 的 URL 或编号。
- 用户需指定用于撰写审查的模型和推理强度。
- 系统会启动一个全新智能体(无历史上下文),向其提供 PR URL、写作规范文件(references/writer-brief.md)的路径以及输出文件夹路径(可通过 node <skill-dir>/scripts/reviews.mjs path 获取)。
- 智能体根据规范撰写审查并生成 HTML 页面。
- 用户收到页面路径、结论和问题计数。
文件结构:
- 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 执行。
- 关于模型支持、平台兼容性、收费等细节,资料中未提供。