SuperAPI AI 工具集

diff-walkthrough

编程与开发

查看项目

更新于 10-31 23:30

技能介绍

用途:diff-walkthrough 用于把一次代码变更集整理成便于审阅者理解的讲解,而不是原始 diff 堆砌或按文件树顺序排列。它明确只解释发生了什么,不负责代码审查;发现问题和结论应交给其他审查技能。\n\n主要能力:\n1. 收集 diff:接受分支、提交范围、暂存或未提交改动,或 PR 引用;远程可达时可用 gh pr diff 获取。若用户未说明指哪个变更集,技能会停下来询问,不从最近历史猜测,也不回退到默认变更集。\n2. 按审阅价值分组:不按字母或文件树顺序展示,而是分为核心逻辑(新行为、算法变化、状态转换、API 表面变化,展示真实 hunk 及上下文)、接线与集成(路由注册、依赖注入、配置管道等连接核心逻辑的部分,压缩展示以确认正确性)、样板与机械性改动(重命名、导入重排、生成代码、格式化、类型再导出,汇总为文件与统计列表,通常不内联 hunk)。核心逻辑放在最前,因为读者注意力在开头最集中。\n3. 密集逻辑补充伪代码:当核心 hunk 嵌套条件多、状态机、重试退避或多步转换难以扫读时,在旁边加几行伪代码,去掉语法和错误处理以暴露关键控制流;只用于确实难读的 hunk。\n4. 用具体示例追踪意外行为:当某 hunk 的行为变化难以通过阅读预测(操作重排、新增短路、边界情况改变)时,选一个小而真实的输入,并排走新旧代码路径,指出分叉步骤和可观察结果;仅用于真正意外的改动。\n5. 少量标注难点:对隐藏风险或易漏点使用简短标签(如 Subtle、Breaking、Race condition、Perf)并配一句话;每次讲解只保留少量标签,避免信号被淹没。\n\n使用方式:调用该技能并指定要讲解的变更集(分支、范围、暂存/未提交改动或 PR 引用)。输出为面向审阅者的中文讲解式说明,而非变更日志:说明为何改动、文件之间如何交互(例如 core.py 中新增的校验器被 routes.py 新增的路由调用),以及 diff 本身不明显的信息;每条说明一到两句,不给出发现、结论或 LGTM 式评价。\n\n适用场景:适合需要快速理解较大或结构复杂的代码变更、希望按审阅价值而非文件顺序阅读 diff 的开发者;也可用于向他人讲解一次变更集的结构与关键路径。\n\n限制:该技能不做代码审查、不发现问题、不给结论;对未指定的变更集不会自行猜测。资料未提供安装命令、收费、价格、平台或具体使用步骤等更多信息。