用途:PR Reference 是一个 PR 参考生成技能,通过查询 git 的提交元数据与分支间统一差异,生成结构化 XML 文档,便于生成 PR 描述、准备代码审查、发现工作项和分析修改文件的安全性。生成成功后需在响应中附上 XML 输出的绝对路径文件链接。
主要能力:提供 bash 与 PowerShell 两套实现;可指定基础分支(auto 可自动检测远程默认分支);支持 merge-base 三方比较;可排除 markdown 文件、按扩展名和路径前缀过滤差异。输出默认保存至 .copilot-tracking/pr/pr-reference.xml。XML 以 <commit_history> 为根元素,封装提交元数据与统一差异。另有工具脚本:list-changed-files 可按类型(增/改/改名等)筛选并输出 plain/json/markdown;read-diff 支持分块查看(--info/--chunk/--file/--summary),应对大型差异。
使用方式:前置条件是仓库相对基础分支至少有一个分歧提交。macOS/Linux 用 bash,Windows 用 PowerShell 7+(pwsh)。快速开始:scripts/generate.sh 或 scripts/generate.ps1;例如 scripts/generate.sh --base-branch auto --merge-base --exclude-ext yml,json(PowerShell 对应 scripts/generate.ps1 -BaseBranch auto -MergeBase -ExcludeExt yml,json)。参数含基础分支、merge base、排除 markdown、排除扩展名、排除路径、输出路径。
适用场景:PR 描述生成、代码审查上下文准备、基于分支变更的工作项发现、修改文件安全分析。
限制:需 git 在 PATH 且基础分支引用存在,否则报错(如 Branch not found,可 git fetch origin 更新);无分歧提交时输出为空。其余完整 XML schema、元素参考及工作流集成细节,资料仅指向参考指南,暂未提供。