Wiki Page Writer 技术文档技能
为代码代理生成带证据引用和深度 Mermaid 图表的技术 Wiki 页面。
技能要求先解析仓库上下文、区分远程与本地引用，并要求每项非平凡声明有来源，体现了一定的数据流透明性和来源归因；但未规定敏感信息处理、凭据保护、用户确认边界、外部链接风险或回滚机制，因此扣分。
流程步骤和输出要求较清晰，包含路径校验、Mermaid 兼容性检查及缺失证据标记；但依赖 git 命令和用户交互，未说明命令失败、无远程、分支异常或 Mermaid 校验失败时的可诊断处理，静态评估不超过10分，故扣分。
激活条件覆盖组件文档、技术深潜和 wiki 页面生成，受众与主要场景明确；但未清楚声明不适用范围、输入输出边界、语义排除条件或中文内容支持，且固定要求远程仓库引用可能受网络环境影响，故扣分。
SKILL.md 具有清晰的元数据、MIT 许可、版本号、激活条件、分阶段流程、结构规范和限制性要求；但没有变更日志、维护责任、更新路径、安装说明、FAQ 或故障排查，故扣分。
对生成带引用、图表和渐进式结构的技术文档提供了较具体的模板，核心任务大概率可完成；但最低5个源文件、每页3至5个图表及严格仓库上下文门槛可能造成不必要成本，且没有代表性产出或结果验证证据，故扣分。
技能明确要求文件路径、函数/类名、行号引用，并要求验证路径和 Mermaid 渲染；但所给材料没有该技能专属的测试套件、示例输出或第三方执行证据，仓库测试证据也未覆盖 wiki-page-writer 关键路径，故扣分。
- 执行前必须确认仓库来源和默认分支；无远程仓库或 git 命令失败时，技能没有明确的恢复流程。
- 最低引用文件数和图表数可能导致小型文档过度设计。
- 固定使用 GitHub/Azure DevOps 等远程链接时，应确认用户可访问性，并避免将凭据或敏感路径写入引用。
- 本评估仅基于静态文件阅读，未执行命令、生成页面或验证 Mermaid 渲染。
它能做什么 & 适用场景
Wiki Page Writer 是 Microsoft Agent Skills 仓库中的一个文档生成技能，专注于技术文档、Wiki 页面和技术深潜内容。它要求先确认源代码仓库上下文，再分析相关文件并沿实际代码路径写作。输出应包含 VitePress frontmatter、多个深色模式 Mermaid 图表、文件级引用、结构化表格和交叉链接。该技能适合需要可追溯、结构化技术文档的工程团队，但其完整流程依赖源仓库上下文和本地文件分析。
它首先检查 Git 远程地址并获取当前分支，然后要求确认源代码仓库是否为本地仓库或提供远程 URL。随后规划文档范围，读取相关实现文件，分析依赖、数据流和代码路径，并生成包含 VitePress frontmatter、3–5 个 Mermaid 图表、源文件引用、表格、伪代码和 Related Pages 的 Markdown 页面。最后验证文件路径、类名和 Mermaid 语法。
- 需要为具体组件或系统创建可审查技术 Wiki 页面的工程团队。
- 需要通过实际实现代码追踪数据流并编写技术深潜文档的开发者。
- 需要在 VitePress 文档站点中加入 Mermaid 架构图和源代码引用的文档维护者。
- 需要为 Wiki 目录批量生成结构化页面的项目团队。
优缺点一览
- 明确要求先解析源仓库和默认分支，便于生成可追溯引用。
- 要求沿实际代码路径分析，降低仅凭文件名推测的风险。
- 内置 VitePress frontmatter、深色模式 Mermaid 图表、表格、伪代码和相关页面链接规范。
- 适合生成结构化、可渐进阅读的技术深潜页面。
- 未确认源仓库上下文前不会继续生成页面。
- 每页至少需要 5 个不同源文件的引用；小型或证据不足的项目可能难以满足。
- 要求每页包含 3–5 个 Mermaid 图表，简单文档任务可能显得过重。
- 提供的 SKILL.md 未列出专属脚本、测试套件或具体客户端兼容性验证。
- 整个仓库处于积极开发阶段，README 明确标注为 Work in Progress。
如何安装
仓库 README 提供的集合安装方式是：运行 npx skills add microsoft/skills，在向导中选择需要的技能。该技能位于 .github/plugins/deep-wiki/skills/wiki-page-writer/SKILL.md；README 还记录了 Copilot CLI 的插件安装方式：/plugin marketplace add microsoft/skills，然后运行 /plugin install deep-wiki@skills。具体客户端中的技能选择或加载步骤未在源材料中进一步说明。
如何使用
在已加载该技能的代理中提出类似“请为这个组件生成一篇带 Mermaid 图表、源代码引用和 VitePress frontmatter 的技术 Wiki 页面”的请求。技能会先要求确认源仓库上下文；若存在远程仓库，则使用链接式引用，若为本地仓库，则使用本地路径引用。