ADO Wiki 转换器
将 VitePress/GFM 文档转换为可发布到 Azure DevOps Wiki 的格式。
技能要求先解析仓库来源并询问用户，明确源文件不修改、输出写入 dist/ado-wiki/，且仅使用 Node.js 内置模块，降低了外部依赖和数据外传风险。扣分在于未明确写入前确认、输出目录冲突处理、回滚/清理策略、敏感数据处理和发布到 ADO 时的权限边界。
转换规则、示例函数和验证清单较具体，异常时要求未解析仓库上下文则停止。静态材料未提供该技能专属测试，collectMarkdownFiles、容器转换、索引页和 .order 实现不完整，且链接、前言和 Mermaid 边界情况处理有限；按静态上限扣分。
目标受众和场景清楚，即将 VitePress/GFM 文档转换为 Azure DevOps Wiki 格式，并声明保留同目录及外部链接、跳过目录等边界。扣分在于触发条件、输入输出契约和不适用场景仍不够形式化；未说明中文文档验证或中国大陆网络环境，尽管核心转换本地运行。
Front Matter 元数据包含名称、描述、MIT 许可证、作者和版本；文档按问题、规则、脚本结构、验证和限制分层组织。扣分在于缺少安装/Node 版本要求、完整可运行示例、FAQ、变更记录和明确维护更新路径，且部分要求与给出的主流程不一致。
核心 Mermaid、Front Matter、链接和容器转换目标明确，输出副本可直接用于后续 Wiki 发布。扣分在于生成脚本的关键辅助逻辑未完整给出，索引页、.order、非 Markdown 文件复制和 npm 集成仅作为要求或片段，静态材料不足以证明结果完整可用。
技能提供了具体转换代码、验收清单和可审计的规则说明，仓库还展示通用 CI 与测试基础设施。扣分在于没有该技能专属测试、真实输出样例或第三方执行证据，且提供的 CI/测试材料并不覆盖此技能关键路径。
- 不要将该 SKILL.md 视为已验证的完整构建脚本；补齐并测试目录收集、索引页、.order、非 Markdown 文件复制和容器转换逻辑后再用于生产。
- 执行前确认 git remote、源目录和 dist/ado-wiki/ 的写入范围，避免覆盖已有输出；发布到 Azure DevOps 前另行确认凭据和权限。
- Mermaid 语法、ADO 版本兼容性、相对链接和中文内容渲染仍需在目标 Wiki 中抽样复核。
它能做什么 & 适用场景
这是 Microsoft Agent Skills 仓库中的一个文档工程技能，专门处理 VitePress 或 GFM Markdown 到 Azure DevOps Wiki 格式的转换。它指导代理生成仅依赖 Node.js 内置模块的 ESM 构建脚本，并将转换后的副本写入 dist/ado-wiki/。转换范围包括 Mermaid 图表、YAML front matter、源代码链接和 VitePress 容器指令。源文件保持不变，同时要求保留引用、图表内容、目录结构和图片。
指导代理先解析源仓库上下文，然后生成 scripts/build-ado-wiki.js。脚本读取文档文件，移除文件开头的 YAML front matter，将 Mermaid 代码围栏转换为 ADO 语法，将 flowchart 改为 graph，清理 Mermaid 中的 <br> 和过长箭头，并把父级相对源代码链接转换为纯文本。它还可转换 VitePress tip、warning、danger 和 info 容器，输出到 dist/ado-wiki/，打印转换统计，并生成 index.md 与 .order 文件。
- 维护 VitePress 文档并需要将其发布到 Azure DevOps Wiki 的开发团队。
- 包含 Mermaid flowchart、YAML front matter 和源码链接的项目文档迁移负责人。
- 需要保留文件引用、图表和目录结构，同时避免修改原始 Markdown 的工程师。
- 希望用零外部依赖的 Node.js 脚本批量构建 ADO Wiki 副本的文档维护者。
优缺点一览
- 针对 Azure DevOps Wiki 的 Mermaid、front matter、链接和容器兼容性提供了具体规则。
- 使用 Node.js 内置模块，明确要求零外部依赖。
- 保留源文件，并将转换结果输出到独立目录。
- 包含统计信息、索引页和 .order 文件的构建与验证要求。
- 来源只提供技能说明，没有展示实际生成脚本或测试结果。
- 网络发布、Azure DevOps 身份验证和 Wiki 上传流程未涵盖。
- 部分 Mermaid 类型在 ADO 中不支持，且样式指令可能被忽略。
- 技能依赖代理具备 shell 和本地文件系统访问能力。
如何安装
该技能位于 Microsoft 的 skills 仓库 deep-wiki 插件中。可在 Copilot CLI 中执行：/plugin marketplace add microsoft/skills，然后执行 /plugin install deep-wiki@skills。仓库集合也支持 npx skills add microsoft/skills，随后从向导中选择所需技能；具体单技能选择流程未在来源中说明。
如何使用
在已安装 deep-wiki 插件的代理中请求将 VitePress/GFM 文档转换为 Azure DevOps Wiki 格式，例如：“为这个 VitePress 文档生成 ADO Wiki 构建脚本，保留引用和图片，并输出到 dist/ado-wiki/。”技能要求生成 scripts/build-ado-wiki.js，并按清单验证 Mermaid 围栏、flowchart、front matter、链接、目录结构和 index.md。