SuperAPI AI 工具集

pr-walkthrough

通用与其它

查看项目

更新于 10-15 16:45

技能介绍

用途:把当前分支的拉取请求整理成一个本地可见的静态走查站点,帮助评审者快速定位受影响的代码与改动路径。资料将其定位为“基于画布的 PR 理解实验”,不是代码审查技能,不生成新的审查结论、批准或要求修改的建议,也不做全面批评。

主要能力:生成四个可切换的独立画布视图。系统概览视图以少量展开的组件卡片呈现 PR 触及子系统的体系结构,不出现 PR、变更文件、评审意见、diff 链接、截图或规格内容;数据流图展示状态、数据、事件、请求、文件、资源或渲染输出如何在被改系统中流动;代码依赖图展示变更组件之间的依赖关系、主要接缝以及入口与叶依赖文件;用户操作图展示用户行为、交互界面及其如何流经实现。每个视图提供导览,按顺序讲解节点。站点内数据存放在 window.PR_WALKTHROUGH_D3_DATA 中,不通过 fetch 加载。

使用方式:生成自包含站点于 .warp/pr-walkthrough/index.html,可直接用 file:// 打开,无需开发服务器、安装依赖、打包或构建。建议使用单一 HTML 文件内联 CSS、JavaScript 和数据;若拆分文件,只使用相对本地路径。D3 从固定官方版本加载:https://cdn.jsdelivr.net/npm/d3@7.9.0/dist/d3.min.js。可使用脚本 scripts/d3_canvas_runtime.py 生成可复用的确定性 D3 渲染,该脚本包含缩放、平移、图切换、搜索、节点详情、适配视图与导览控件。生成后需用 scripts/validate_d3_canvas.py 校验;若画布未初始化、D3 未加载、缺少必要图、导览控件失效或节点边未渲染,应调试并重新生成,若确无浏览器环境则报告渲染未验证。

视觉与上下文:应用 Brandalf 品牌源,失败时回退到给定颜色值(页面 #121212、面板 #1e1e1d/#292929、文字 #faf9f6/#ffffff,强调粉 #a43787,各图颜色为黄 #c0872a、绿 #34895c、蓝 #2e5d9e、紫 #754dac)。通过 gh 命令获取 PR 基础分支、标题、正文、URL、状态及变更文件,并用 git diff 收集改动。依据改动行数与文件数控制规模:极小、小、中、大型 PR 分别对应不同节点与导览步数,避免为凑满画布而膨胀小 PR。应读取 head 提交下的完整代码库,而不仅看 diff。

限制:资料未提供具体安装命令、收费、价格或平台信息;目录、命令与 URL 需保持原样。