SuperAPI AI 工具集

cmd-pr-build-context

通用与其它

查看项目

更新于 10-16 02:37

技能介绍

用途:在人工结对评审前,为 pull request 准备高信噪比的上下文,帮助开发者快速理解改动与风险。

主要能力:1) 自动检测仓库基础分支,依次尝试 gh repo view --json defaultBranchRef -q '.defaultBranchRef.name'、git remote show origin | grep "HEAD branch"、git symbolic-ref refs/remotes/origin/HEAD,不预设 main 或 master,全部失败则询问开发者。2) 按范围分析差异:默认对比当前分支与基础分支;也支持 unstaged(git diff HEAD)、最近 1 个提交(HEAD~1...HEAD)、最近 N 个提交(HEAD~N...HEAD)。3) diff 命令统一排除锁文件与 package.json,并额外采集 --stat 概览。4) 理解改动:行为变化、变更原因、依赖的假设或不变式、可能破坏的正确性/安全/性能/API/数据/运维风险。5) 面向结对评审输出:3-5 条白话要点、关键文件及重要性、可快速推进评审的具体问题、重大问题显式标注(安全、数据丢失、认证破坏、性能断崖、迁移问题、缺测试等),并说明是否阻塞合并。6) 若处于默认分支,切换到仓库上下文模式:探索结构、识别技术栈、查看最近提交、检查未提交改动与 stash,并汇总仓库用途、结构、当前状态与关键入口。

使用方式:作为名为 build_pr_context 的工程 agent 技能调用;可指定范围(unstaged、最近 N 个提交、整个仓库)或不指定。整个仓库范围会走仓库上下文模式。

适用场景:PR 评审前准备、结对评审前的风险梳理、在默认分支上快速了解仓库全貌。

限制:输出需真实,不得编造结果;生成上下文后即停止并等待开发者输入;若基础分支无法确定需询问开发者。具体安装方式与调用入口暂未提供。