这个 Skill 能做什么，适合哪些场景？
该技能把生成的 Wiki Markdown 文件组织成 VitePress 静态网站。它会生成站点目录、VitePress 配置、主题文件和首页，并配置深色主题与 Mermaid 图表交互。它还会在构建前修复部分 Markdown 和 Vue 模板兼容性问题。适合已经拥有 Wiki 页面、希望发布可浏览 HTML 文档的开发者。
在 wiki-site/ 中生成 VitePress 站点结构，包括 .vitepress/config.mts、主题文件、public/、Markdown 页面、package.json 和 index.md；使用 vitepress-plugin-mermaid 配置深色 Mermaid 图表；通过 CSS 和客户端轮询修复 Mermaid 样式；为 Mermaid 图表添加点击放大弹窗；构建前处理 <br/>、裸露的 <T> 泛型和 YAML frontmatter；运行 npm install 和 npm run docs:build，产物写入 wiki-site/.vitepress/dist/。
- 负责技术文档的开发者，需要把已生成的 Wiki Markdown 发布为静态网站。
- 使用 /deep-wiki:build 命令、希望将深度 Wiki 输出打包成 VitePress 站点的用户。
- 需要深色主题 Mermaid 图表，并希望读者可以点击图表放大的文档维护者。
- 需要统一补充页面标题和描述、修复 Vue 模板兼容性问题的文档工程师。
如何安装这个 Skill？
- 该评估仅基于提供的源文件，未执行安装、脚本或 VitePress 构建；不要将示例片段视为已验证的完整实现。
- npm install 会引入外部依赖，但技能未声明版本、锁文件、网络需求或供应链审查；在受限网络或生产环境中应先审查并固定依赖。
- 点击放大代码直接复制 outerHTML 并绑定事件，未说明键盘可访问性、重复初始化、事件清理或大型/恶意 Markdown 的处理。
- 技能未说明输入目录约束、中文内容兼容性、失败恢复和清理策略，建议先在隔离目录中运行并保留原始 Markdown。
- Shell / 命令行
- 网络访问
- 本地文件系统
Node.jsnpmVitePressvitepress-plugin-mermaid
仓库 README 支持使用 npx skills add microsoft/skills 安装技能集合，然后在向导中选择需要的技能。该技能位于 .github/plugins/deep-wiki/skills/wiki-vitepress/SKILL.md；源材料未提供单独安装此技能的命令。
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-vitepress" ~/.claude/skills/
rm -rf "$tmp"根据源仓库地址和 Skill 路径自动生成，只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式，请优先按作者说明操作；想只在当前项目中使用，把 ~/.claude/skills 换成项目里的 .claude/skills。
如何使用这个 Skill？
安装后，把下面任意一句发给 Agent 即可触发：
- 把这些生成的 Wiki Markdown 打包成 VitePress 站点
- build a site
在已安装该技能的编码代理中提出“把这些生成的 Wiki Markdown 打包成 VitePress 站点”或“build a site”，也可以运行 /deep-wiki:build。技能会按要求生成 wiki-site/，然后执行：cd wiki-site && npm install && npm run docs:build。
这个 Skill 有哪些优点和局限？
- 覆盖从 VitePress 脚手架生成到生产构建的完整流程。
- 明确处理深色 Mermaid 的主题变量、CSS 覆盖和内联样式覆盖。
- 包含 Mermaid 点击放大、Markdown 预处理和 frontmatter 检查。
- MIT 许可，并由 Microsoft 发布。
- 依赖 Node.js/npm、VitePress 和 vitepress-plugin-mermaid，源材料未说明版本要求。
- 要求已有生成的 Wiki Markdown；不负责生成 Wiki 内容本身。
- 源材料没有提供该单项技能的独立测试结果或平台兼容性验证。
- README 将其作为包含约 190 个技能的单一仓库的一部分，单独分发方式未说明。
这个 Skill 与同类方案有什么区别？
与相关 Skills 并排比较；分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| Wiki VitePress 打包器 本页 ✓ Microsoft · 官方 | 51 · 谨慎使用 | ★ 2.7k | 3 个月前 | MIT |
| ADO Wiki 转换器 ✓ Microsoft · 官方 | 54 · 谨慎使用 | ★ 2.7k | 3 个月前 | MIT |
| Marmite 静态站点生成技能 | 55 · 谨慎使用 | ★ 886 | 26 天前 | AGPL-3.0 |
| LLM 文档索引生成器 ✓ Microsoft · 官方 | 54 · 谨慎使用 | ★ 2.7k | 3 个月前 | MIT |
| Playwright 组件测试 ✓ Microsoft · 官方 | 58 · 推荐 | ★ 98k | 11 天前 | Apache-2.0 |
FollowSkills 如何评估这个 Skill？
技能仅描述生成 VitePress 站点、写入 wiki-site 并运行 npm install/npm run docs:build，未显示凭据窃取、隐蔽外传或恶意行为；MIT 许可证、仓库安全政策和构建权限信息提供了一定治理依据。扣分在于没有最小权限说明、用户确认、数据流/网络访问披露、失败回滚、依赖锁定或依赖安全策略。
文档覆盖主要配置、Mermaid 修复、点击放大、预处理和构建路径，并说明 SSR 与异步渲染陷阱。扣分在于示例代码不是完整可运行实现，未给出输入校验、构建失败诊断、依赖版本、重复运行行为或异常 Mermaid/Markdown 的处理；静态评估且无针对该技能的提交测试证据，不能超过 10 分。
触发条件、目标用户场景和输出目录基本明确，适用于将已生成的 wiki Markdown 打包为 VitePress 网站。扣分在于未声明输入目录/目录结构、VitePress 与插件版本、非适用场景、平台要求或中文内容限制；npm 依赖和相关服务的网络可达性也未说明，因此环境适配证据有限。
SKILL.md 有 YAML 元数据、分层章节、配置示例、已知陷阱、MIT 许可证和版本号，阅读路径清晰。扣分在于缺少安装前提、完整 package.json 示例、参数契约、FAQ、变更日志、维护负责人/更新路径和版本兼容矩阵；仓库处于 Work in Progress，不能据此补足治理细节。
技能明确产出 wiki-site/.vitepress/dist，并覆盖暗色主题、Mermaid 可读性和前置 Markdown 修复，核心目标可理解且可能完成基本打包任务。扣分在于没有代表性最终输出、验证截图/构建日志或完整脚手架文件，示例仍需用户整合和审查；静态评估限制 effectiveness 不得超过 7。
证据包括目标 SKILL.md 的具体代码片段、README 的仓库说明、MIT LICENSE、安全政策、CI 工作流和提交测试文件，具备有限可审计性。扣分在于这些 CI/测试并未证明 wiki-vitepress 的关键路径，且本次未执行任何复现；没有该技能专属测试、构建产物或第三方交叉验证，静态评估不得超过 5。
点击维度查看打分理由
证据充分度：低 — 主要依赖静态检查、作者材料或有限演示；适合发现线索，不适合做高风险决策。
查看完整评分方法 →