SuperAPI AI 工具集

delete-article

写作与研究

查看项目

更新于 10-16 01:14

技能介绍

用途:在 Azure Architecture Center 仓库中规范地删除一篇文章。仅删除文件不够,因为文章已有发布 URL 被读者、搜索引擎和其他文章引用,必须同步处理重定向、目录、资源与入链。

必要前提:必须先拿到重定向目标 URL(通常是站点相对路径,如 /azure/architecture/...,也可为绝对 URL),由人工决定;人类拥有最终决定权。若未提供,可请调用方给出目标,或代为搜索最合适的替代页面并请其确认。搜索时可使用 microsoft-learn-grounding 技能及其 Microsoft Learn MCP 工具,目标可位于 Microsoft Learn 任意位置,也可为另一篇 AAC 文章。

主要步骤:1) 确认文件形态——YAML+Markdown 对(article-name.yml 与 article-name-content.md,两者都删)、纯 Markdown(article-name.md)、纯 YAML(article-name.yml)。承载发布 URL 的文件是 .yml 或 .md,用作 source_path。2) 在仓库根目录 .openpublishing.redirection.json 的 redirections 数组中添加条目,包含 source_path、redirect_url 和 "redirect_document_id": false(删除时该值为 false;仅内容迁移或改名且仍存在时才为 true)。3) 删除文章文件及专属资源:本地图片文件夹中的图片与 YAML 中 thumbnailUrl 指向的 docs/browse/thumbs/ 缩略图,删除前全仓库搜索引用,仅当无其他引用时才删。4) 删除 docs/toc.yml 中指向该文章的条目及其 name,若父分组变空则一并移除。5) 若文章出现在 docs/index.yml 落地页,需推荐一篇同属 AAC、重要度相当、匹配原分区且未重复展示的替代文章,请人工确认后再改。6) 全仓库 docs/ 搜索并修正入链(相对 Markdown 链接、绝对 URL、图片与缩略图引用),指向重定向目标;若句子语义不再通顺需改句子。例外:*-get-started.md 等精选列表页应直接删除该条目而非替换。7) 验证:URL 承载文件与 include 已删、专属资源与缩略图已删而共享资源保留、重定向条目有效、toc 无残留且无空父组、index.yml 已处理、全仓库搜索旧文件名与旧 URL 无其他引用。最后汇总删除内容、重定向、目录变更、落地页替换与所有改写的入链。

限制:重定向目标须由人工确认;共享图片不得删除;本资料未提供价格、平台等其他信息。