这个 Skill 能做什么，适合哪些场景？
这是 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 副本的文档维护者。
如何安装这个 Skill？
- 不要将该 SKILL.md 视为已验证的完整构建脚本；补齐并测试目录收集、索引页、.order、非 Markdown 文件复制和容器转换逻辑后再用于生产。
- 执行前确认 git remote、源目录和 dist/ado-wiki/ 的写入范围，避免覆盖已有输出；发布到 Azure DevOps 前另行确认凭据和权限。
- Mermaid 语法、ADO 版本兼容性、相对链接和中文内容渲染仍需在目标 Wiki 中抽样复核。
- Shell / 命令行
- 本地文件系统
Node.js
该技能位于 Microsoft 的 skills 仓库 deep-wiki 插件中。可在 Copilot CLI 中执行：/plugin marketplace add microsoft/skills，然后执行 /plugin install deep-wiki@skills。仓库集合也支持 npx skills add microsoft/skills，随后从向导中选择所需技能；具体单技能选择流程未在来源中说明。
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/microsoft/skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/.github/plugins/deep-wiki/skills/wiki-ado-convert" ~/.claude/skills/
rm -rf "$tmp"根据源仓库地址和 Skill 路径自动生成，只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式，请优先按作者说明操作；想只在当前项目中使用，把 ~/.claude/skills 换成项目里的 .claude/skills。
如何使用这个 Skill？
安装后，把下面任意一句发给 Agent 即可触发：
- 为这个 VitePress 文档生成 ADO Wiki 构建脚本，保留引用和图片，并输出到 dist/ado-wiki/。
在已安装 deep-wiki 插件的代理中请求将 VitePress/GFM 文档转换为 Azure DevOps Wiki 格式，例如：“为这个 VitePress 文档生成 ADO Wiki 构建脚本，保留引用和图片，并输出到 dist/ado-wiki/。”技能要求生成 scripts/build-ado-wiki.js，并按清单验证 Mermaid 围栏、flowchart、front matter、链接、目录结构和 index.md。
这个 Skill 有哪些优点和局限？
- 针对 Azure DevOps Wiki 的 Mermaid、front matter、链接和容器兼容性提供了具体规则。
- 使用 Node.js 内置模块，明确要求零外部依赖。
- 保留源文件，并将转换结果输出到独立目录。
- 包含统计信息、索引页和 .order 文件的构建与验证要求。
- 来源只提供技能说明，没有展示实际生成脚本或测试结果。
- 网络发布、Azure DevOps 身份验证和 Wiki 上传流程未涵盖。
- 部分 Mermaid 类型在 ADO 中不支持，且样式指令可能被忽略。
- 技能依赖代理具备 shell 和本地文件系统访问能力。
这个 Skill 与同类方案有什么区别？
与相关 Skills 并排比较；分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| ADO Wiki 转换器 本页 ✓ Microsoft · 官方 | 54 · 谨慎使用 | ★ 2.7k | 3 个月前 | MIT |
| Wiki VitePress 打包器 ✓ Microsoft · 官方 | 51 · 谨慎使用 | ★ 2.7k | 3 个月前 | MIT |
| LLM 文档索引生成器 ✓ Microsoft · 官方 | 54 · 谨慎使用 | ★ 2.7k | 3 个月前 | MIT |
| Azure Blob Storage TypeScript 技能 ✓ Microsoft · 官方 | 51 · 谨慎使用 | ★ 2.7k | 3 个月前 | MIT |
| Azure Application Insights 插桩指南 ✓ Microsoft · 官方 | 48 · 谨慎使用 | ★ 2.7k | 3 个月前 | MIT |
FollowSkills 如何评估这个 Skill？
技能要求先解析仓库来源并询问用户，明确源文件不修改、输出写入 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/测试材料并不覆盖此技能关键路径。
点击维度查看打分理由
证据充分度：低 — 主要依赖静态检查、作者材料或有限演示；适合发现线索，不适合做高风险决策。
查看完整评分方法 →