1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | wiki-vitepress-microsoft-skills |
| 作者/维护者 | Microsoft（deep-wiki 插件维护者 Govind Kamtamneni，GitHub: thegovind） |
| 来源链接 | https://github.com/microsoft/skills/tree/main/.github/plugins/deep-wiki/skills/wiki-vitepress |
| 许可证 | MIT（GitHub API 确认） |
| GitHub Stars / Forks | 仓库整体 2,838 ★ / 319 forks（GitHub API）；该数字属 microsoft/skills 整个合集（175 个技能共享），不代表本技能自身热度 |
| 最新版本 | SKILL.md 声明 version 1.0.0，所属 deep-wiki 插件版本 2.0.0 |
| 安装方式 | Claude Code 插件市场 / npx skills 安装向导 / 手动复制（详见第 10 章） |
2. 功能介绍与亮点
wiki-vitepress 是 Microsoft 官方 deep-wiki 插件套件中的一个独立技能：把已生成的 Wiki Markdown 文件打包成一个可直接浏览的 VitePress 静态网站。核心能力：
- 按固定目录结构搭建 VitePress 站点骨架并自动生成导航/侧边栏配置
- 内置暗色主题，针对 Mermaid 图表在暗色背景下的可读性给出三层修复方案
- 实现 Mermaid 图表点击放大的全屏查看交互
- 构建前自动修正 Markdown 中常见的 Vue 模板编译兼容性问题
- 明确列出已知坑点（如 SSR 阶段无
document、Mermaid 异步渲染需轮询），减少反复试错
亮点：官方 Microsoft 出品、SKILL.md 内容详尽到可直接照抄代码片段，且是同类“从 Markdown 到可发布站点”工具中少数以 Agent Skill 形式（而非独立部署应用）交付的实现。
3. 适用场景
固定分类：文档与办公自动化。
适合已经用 deep-wiki 插件（或其他方式）为代码仓库生成了 Wiki 文档草稿，但想要一个带交互式架构图、可直接托管发布的网站产出，而不是停留在 Markdown 文件层面的团队；尤其适合需要频繁生成、更新内部技术 Wiki 或对外文档站点的工程团队。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——
deep-wiki插件已注册进仓库的.claude-plugin/marketplace.json，可通过插件市场一步安装 - Codex / OpenClaw / Hermes Agent：✅ 均支持——仓库推荐的
npx skills安装器官方 README 的 Supported Agents 表格逐项列出三者专属安装路径
SKILL.md 正文是通用 Markdown 指令 + 标准 Node.js 构建命令，未绑定 Claude 专属交互工具，四个生态理论上均可执行。
5. 推荐理由
把“AI 生成的 Wiki 内容”变成“团队真正可以打开浏览、可发布上线的网站”这最后一步，往往需要单独学习 VitePress 配置、处理暗色模式下 Mermaid 图表显示错乱等琐碎问题——这个技能把这些坑点直接封装进了 SKILL.md，官方出品、文档质量高，值得需要产出可发布文档站点的团队直接使用。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 官方 Microsoft 出品；子目录本身提交记录不多，但同一功能范围内 2026 年 7 月有独立第三方用户报告过真实可复现的交互缺陷，另一位无雇佣关系的独立开发者随即提交了修复补丁 |
| 可用性 | 7 | SKILL.md 文档详尽、含可直接复用的代码片段与已知坑点清单，可通过插件市场一步安装；但完整构建流程依赖本地 Node.js/npm 环境，内容近半年无实质更新 |
| 安全性 | 8 | 唯一执行动作是本地标准前端构建命令（npm install && npm run docs:build），无网络外发、无需 API Key 或凭据；License 清晰；官方账号无造假迹象 |
综合 = 三项均值 = 7.33，达到收录标准（≥7.0）。
安全检查清单：① Shell 执行范围明确，仅限本地 npm 构建命令；② 不联网外发数据（npm install 属标准工具链行为）；③ 不要求 API Key/凭据；④ 全文为配置模板与代码片段，未见可疑指令；⑤ 作者为 Microsoft 官方账号，无造假迹象；⑥ License（MIT）明确；⑦ 所属仓库持续活跃，但本技能子目录内容已约半年未更新。
7. 跟同类 Skills 相比的优势
| 项目 | 形态 | 与本技能的差异 |
|---|---|---|
| wiki-vitepress（本技能） | Agent Skill，指令+构建脚本 | 无需独立部署服务，跟着 Agent 一次性生成静态站点产出 |
| AIDotNet/OpenDeepWiki（3,457★，MIT） | 独立全栈自托管应用（.NET） | 需要自行部署数据库与 Web 服务才能跑通完整“代码库→Wiki 网站”流程；deep-wiki 插件本身即受其启发 |
| AsyncFuncAI/deepwiki-open（17,482★，MIT，deepwiki.com 开源复刻） | 独立 React + FastAPI 全栈应用 | 同样需要自行搭建服务、配置向量数据库与 LLM API Key，部署门槛明显更高 |
deep-wiki 插件套件内还有负责撰写 Wiki 正文内容、深度调研代码库的其他模块，它们产出的是 Markdown 文本本身，并不负责把内容打包发布为可浏览的网站——这正是 wiki-vitepress 承担的“最后一公里”角色。
8. 用户评价
该技能目前尚无第三方平台具名评价，但 GitHub 仓库 issue 区可查到关于同一 VitePress 打包功能的真实使用反馈：开发者 Kyle-sandeman-mrdfood 于 2026 年 7 月报告了 Mermaid 图表点击放大后缩放/关闭控制按钮被图表本身遮挡、无法点击的可复现问题；另一位与 Microsoft 无雇佣关系的独立开发者 arimu1 随即提交了修复补丁（截至目前该补丁仍待官方合并）。
9. 其他补充
deep-wiki 插件的设计明确受 OpenDeepWiki 与 deepwiki-open 两个开源项目启发，目标是把类似的“代码库转 Wiki 网站”能力做成不需要额外部署服务的 Agent Skill 形态。
10. 安装使用方式
方式一（推荐）：Claude Code 插件市场，一次性获取整个 deep-wiki 插件套件：
/plugin marketplace add microsoft/skills
/plugin install deep-wiki@skills方式二：npx skills 安装向导：
npx skills add microsoft/skills从交互向导中勾选 wiki-vitepress（⚠️ 见下方注意事项，插件嵌套路径下的技能通过该命令直接按名安装目前存在已知问题）。
方式三：手动复制：
git clone https://github.com/microsoft/skills.git将 .github/plugins/deep-wiki/skills/wiki-vitepress 目录复制到目标 Agent 的技能目录下。
安装后注意：本地需已安装 Node.js/npm 才能执行生成的 VitePress 构建命令；该技能通常配合同一插件内的 /deep-wiki:build 命令一并触发，而非单独调用。
11. 注意事项
- 官方文档展示的
npx skills add microsoft/skills --skill <技能名>命令，对插件嵌套路径下的技能（含本技能在内的全部 deep-wiki 子技能）存在已知安装失败问题（仓库 issue #363，截至目前仍开放），建议优先用插件市场或手动复制方式安装 - 完整功能依赖本地 Node.js/npm 构建环境，纯提示词场景无法直接使用
- 子目录内容自 2026 年 2 月首次发布后，除一次跨插件批量元数据调整外未再更新
microsoft/skills整仓库仍标注“Work in Progress”，技能细节未来可能变化