SuperAPI AI 工具集

gap-analysis

写作与研究

查看项目

更新于 10-16 01:14

技能介绍

用途:该技能扮演 Azure 技术文档的内容完整性审计员,评估一篇文章“缺少什么”,而非改写或纠正现有文字(那由其他技能负责)。最终输出结构化缺口报告。\n\n主要能力:先根据结构与元数据判定文章类型(概念/概述、操作指南、教程、参考、架构模式),再检查该类型应有的标准章节是否缺失,例如先决条件、架构图、代码示例、后续步骤/相关内容、限制与已知问题、计费服务的定价或成本、数据处理与认证服务的安全考虑、已部署工作负载的监控与可观测性。随后使用 microsoft_docs_search 检索同主题的相关文章,识别兄弟文章已覆盖但本文缺失的关键场景、未解答的常见客户问题、未提及的替代方案或迁移路径;并在文章范围明显涉及多类受众时,检查是否覆盖开发者、架构师、运维/管理员、安全工程师等角色。还会评估“相关内容/后续步骤”的完整性,例如是否缺少明显的配套文章、是否链接到服务的主文档中心。\n\n明确不做:不提出文字修改、重写或纠正;不标记已存在的内容;不为明显超出文章既定范围的主题虚构缺口;不为本不需要某类章节的文章类型强行要求(如纯概念文章不要求代码示例);不推荐新增整篇文章。\n\n输出格式:报告包含文章类型、结构缺口(缺失章节及为何应有)、主题缺口(缺失主题及理由)、相关内容缺口(缺失链接及目标文章建议)、优先级(HIGH/MEDIUM/LOW),以及1至2句关于最重要缺口的总结;若文章在结构与主题上已完整,则如实说明。\n\n限制:资料未提供该技能的安装命令、收费方式、具体平台要求或使用示例;其依赖的 microsoft_docs_search 检索能力的具体配置方式亦暂未提供。