SuperAPI AI 工具集

pr-visual-overview

编程与开发

查看项目

更新于 10-26 07:56

技能介绍

用途:为单个 GitHub 拉取请求生成一份交互式、以图解为主的 HTML 概览,直观展示该 PR 做了什么。页面不含任何审查发现或问题结论,适合与专门的问题审查报告配合使用。仅在用户显式提供 PR URL 调用时运行。

主要能力:由一个全新上下文的智能体读取单个 PR,生成自包含的 HTML 页面,页面含 Architecture 与 UI/UX 两个标签页。该智能体只看到 PR,不会看到当前会话内容。

使用方式:先询问用哪个模型和推理强度撰写概览,只列出当前运行时能够作为全新智能体启动的模型,不提供默认选项。随后以无历史方式启动一个全新智能体:在 Claude Code 中使用 Agent 工具的 general-purpose,在 Codex 中使用 spawn_agent 并设 fork_turns: "none",在 T3 Code 中使用 delegate_task。仅向其提供 PR URL、references/writer-brief.md 的路径,以及 node <skill-dir>/scripts/overviews.mjs path 打印出的输出文件夹。完成后回复页面路径。

文件结构:仅撰写者读取这些文件。references/writer-brief.md 指向其余文件:references/diagram-types.md、assets/template.html 和 assets/marks.html。

清理旧概览:旧概览会一直保留,直到用户要求移除。此时运行 node <skill-dir>/scripts/overviews.mjs clean --older-than <days> --dry-run,展示列表,待用户确认后再去掉 --dry-run 执行。

适用场景:需要在代码审查之外快速理解某个 PR 的结构与界面变化时使用。

限制:页面不含审查发现;必须显式以 PR URL 调用;撰写概览的模型须为当前运行时能启动的模型;具体支持模型列表、脚本其他参数及运行环境要求资料未详述。