SuperAPI AI 工具集

pnp-copilot-pr-review

智能体与模型

查看项目

更新于 10-16 01:14

技能介绍

用途:将一套固定的 Azure Patterns & Practices 工程质量标准,融入 GitHub Copilot 对 Azure Architecture Center 文章的自动拉取请求(PR)审查。它主要是在常规 PR 审查行为之上补充检查项;当本技能指令与默认审查行为冲突时,对这类文章以本技能为准。反馈以审查评论形式给出,并尽量用 GitHub 建议功能在具体行内提供一键可应用的具体修改。

特殊 PR 处理:运行任何检查前先判断两类 PR。操作同步 PR(头分支恰为 repo_sync_working_branch、基分支恰为 main,或标题为确认从 repo_sync_working_branch 合并到 main 以同步)只产出一条用户可见消息:No review performed, as this is a sync PR;不检查变更、不产生发现或行级评论。仅编辑类 PR(标题或正文出现 PnP 编辑、复制编辑、P4 编辑、发布后编辑等明确信号)只审查本次改动行,仅限专业文字编辑应处理的严重文案问题;不评论技术正确性、弃用、架构选择、缺失指南、组件选择、替代方案、Well-Architected 对齐、成本估算或参考实现,跳过检查 1 至 10。

审查范围与方式:以 PR 中文章当前状态为准,而非仅改动行,阅读正文及配套 .yml 元数据。按内容类型调整审查力度,目标读者为面向 Azure 设计真实工作负载的专业云架构师或软件工程师。每次推送都会运行:首次运行做完整审查;重复运行只关注上次审查后的变化及其影响,提高评论门槛,不重复已提出的发现,不制造发现。

十项检查:1 事实正确并以 Microsoft Learn 为依据;2 与标题、开头描述和元数据描述一致,防止范围漂移;3 不含弃用技术或操作流程,违反按高严重度处理并给出继任方案;4 指导良好且有主见,对齐 Well-Architected 与 Cloud Adoption Framework,识别未披露缺陷、内部矛盾、缺失核心指导、非主流做法和含糊措辞;5 图片与文字叙述一致,并检查架构图箭头约定一致;6 Components 章节完整、准确且有针对性(仅在有该章节时),含 WAF 服务指南或相应文档链接;7 替代方案集中记录并说明取舍;8 Well-Architected 支柱内容归类正确(仅在文章按支柱组织时);9 Cost Optimization 章节链接具体定价估算(仅在存在该章节时);10 文章与参考实现一致(仅在提供可部署仓库链接时)。