SuperAPI AI 工具集

pnp-engineering-review

写作与研究

查看项目

更新于 10-16 01:15

技能介绍

用途:在人类明确请求时,对 Azure Architecture Center 文章按固定质量标准做工程评审,产出供作者参考的反馈。评审为只读,只有调用者明确要求修复某条发现时才编辑文章。

范围与视角:评审工作区中当下的整篇文章,先读正文与配对的 .yml 元数据再评估;按内容类型调整力度(solution idea 不要求覆盖所有 Well-Architected 支柱,reference architecture 则要求)。目标读者是设计真实 Azure 工作负载的专业云架构师或软件工程师,通常为全新项目。

工作流程:先建 todo 清单并等调用者确认后再开始,可增删步骤;逐项进行,标记 in-progress、收集证据、给出结论,不批量处理;每项报告清晰 PASS/FAIL(或 PASS-with-findings),发现按严重度标记 Critical(错误或失效)、High(缺核心指导、未披露缺陷)、Medium(重定向、过时但可用)、Low(可选改进),并链接到具体行;最后给出跨步骤总结。

评审步骤(用户可改顺序,默认按序):1) 事实正确、以 Microsoft Learn 为依据;2) 与标题、开头描述、元数据描述一致;3) 无废弃技术或运维流程;4) 提供优秀且有主见的指导;5) 保留上一版文章的主见性指导;6) 图片与文字一致;7) Components 部分完整、准确、有目的;8) Alternatives 集中且有理由;9) Well-Architected 支柱内容归类正确;10) Cost Optimization 部分链接到已保存的 Azure 定价计算器估算;11) 文章与参考实现一致;12) 与业界观点一致;13) 术语与缩写准确;14) URL 避免重定向与死链。

不检查项:语法与拼写;元数据正确性(如 ms.date、author、ms.author、ms.topic、ai-usage)。

限制:不评估成本估算计算是否准确或最新;对参考实现只做轻量比对,不审计或运行代码;链接检查交由 link-checker agent,并注意无浏览器标识导致的误报;评论“当前最佳实践”时须以 Microsoft Learn 为依据并引用来源。