用途:该技能用于在 .NET/C# 文档仓库中初始化一个新的编译器错误与警告合并文章,产出一个文章骨架、TOC 条目以及可选的种子错误码元数据,作为后续错误合并工作的起点。它明确不负责合并现有文章,也不搜索额外诊断信息,这些属于其他技能。
必要输入:需向用户收集目标文件名(新 .md 文件名,例如 overloaded-operator-errors.md)、主题描述(如“overflow, underflow, and checked and unchecked operators”)、可选的初始种子错误码。
主要步骤:先询问 TOC 放置位置,即该条目应出现在哪个既有条目之后,并等待答复后再改动;随后创建 docs/csharp/language-reference/compiler-messages/{destination-filename},填充包含 title、description、f1_keywords、helpviewer_keywords、ms.date、ai-usage 的 front matter 及正文标题与错误列表占位;接着在 docs/csharp/language-reference/toc.yml 中紧接指定条目添加新条目,保持相邻缩进与样式;若提供种子错误码,则批量处理:提取数字部分,在 ../roslyn/src/Compilers/CSharp/Portable/Errors/ErrorCode.cs 中查找对应常量,在 ../roslyn/src/Compilers/CSharp/Portable/CSharpResources.resx 中查找名称完全匹配(含 ERR_ 或 WRN_ 前缀)的 <data> 元素并读取编译器消息原文,然后按数字排序写入 f1_keywords、helpviewer_keywords、文章主错误列表(暂用 #anchor-tbd)与 TOC 的 displayName,并从 docs/csharp/misc/sorry-we-don-t-have-specifics-on-this-csharp-error.md 的 f1_keywords 中移除这些代码。替换 Roslyn 格式占位符时保留静态消息文本。最后停下来呈现完整目标文件内容、新 TOC 条目及移除摘要,等待用户批准后结束。限制:需用户提供目的地文件名与主题描述;TOC 位置须先确认;不合并现有文章、不额外搜索诊断;资料未提供该技能的收费、平台或效果信息。