SuperAPI AI 工具集

error-consolidation-merge-existing

写作与研究

查看项目

更新于 10-15 21:12

技能介绍

用途:把一份经用户批准的独立 C# 编译器错误/警告文章清单,合并进 docs/csharp/language-reference/compiler-messages/ 下已有的汇总文章。需处理完整清单后停止,检索与主题归并不属于本技能。

必要输入:目标汇总文件名、诊断共享的主题描述、用户批准的源文件列表。

关键路径:目标文件位于汇总目录;TOC 为 docs/csharp/language-reference/toc.yml;重定向为 .openpublishing.redirection.csharp.json;重定向技能与脚本位于 .github/skills/redirect-article/ 下。

批量流程(对每个源文件):

  1. 提取错误码、逐字编译器消息与正文。逐字消息需查 ErrorCode.cs 与 CSharpResources.resx 中对应 data 元素的 value。
  2. 更新目标文件:front matter 的 f1_keywords、helpviewer_keywords 按数字顺序加入代码;主错误列表按数字顺序加入条目,锚点暂用 #anchor-tbd;把 '{0}' 等占位符替换为 type、value、operator 等描述性术语,保留静态消息文本并成句;将源正文作为新的 H2 章节追加,去掉源 front matter、H1 与 See also,并把源标题降一级。
  3. 创建重定向:须调用 create-redirect-entry.ps1,不要手改重定向 JSON;同时按重定向技能要求更新仓库中指向被删文章的链接。
  4. 更新 TOC:把代码按数字顺序加入目标条目的 displayName,并删除源文件完整的 TOC 条目。
  5. 在内容、重定向、链接、TOC 都处理完后删除源 Markdown 文件。

完成后输出批次汇总:已合并源文件、错误码数量、创建的重定向、移除的 TOC 条目。不要继续进行检索或主题归并。

限制:仅处理已批准的清单;主题锚点由后续归并阶段分配;具体收费、平台支持等资料暂未提供。