SuperAPI AI 工具集

drive-pr-walkthrough

编程与开发

查看项目

更新于 10-16 08:10

技能介绍

用途:为 PR/分支或提交范围生成“意图优先”的语义叙述,说明作者想达成什么、系统行为发生了哪些有意义的变化及原因;默认输出为磁盘上的 Markdown 文件,聊天中只输出指向该文件的简短提示,除非用户明确要求内联展示。

主要能力:默认范围是当前分支相对基线的全部改动,优先 origin/main...HEAD,回退 main...HEAD,并收集 git log --oneline <base>..HEAD;输出位置默认按 PR 编号写入 docs/reviews/pr-<PR_NUMBER>/walkthrough.md,用户指定 spec 目录时写入 <spec-folder>/walkthrough.md,两者都没有时写入 wip/walkthrough.md。优先采用显式意图来源(PR 标题/正文、关联 Linear 工单、合并提交信息、分支名),可运行 gh pr view --json title,body,url;工作流包括获取上下文、提取意图与线程、推导行为变化、映射证据并套用模板。链接约定:在 Cursor 环境(检测到 CURSOR_AGENT、CURSOR_TRACE_ID 或 CURSOR_CLI)使用仅路径链接,行号以纯文本写在链接外;其他环境可用范围链接。

适用场景:PR/分支评审、历史合并提交走查,需要把实现与测试作为同一意图的证据组织成叙事。

限制与要求:避免逐文件变更日志、过程叙述和把测试当成独立目的;每个行为变化应链接 1 至 5 个实现触点和至少一个测试,缺失测试需明确说明;重构应标注“无行为变化”;仅在有实质澄清作用时保留 1 至 3 个代码片段;输出非 HTML,未提供的内容不得编造。