1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | wiki-researcher-microsoft-skills |
| 作者/维护者 | Microsoft（官方仓库 microsoft/skills，主要提交者 thegovind，另有 Scott Addie 等具名工程师参与维护） |
| 来源链接 | https://github.com/microsoft/skills/tree/main/.github/plugins/deep-wiki/skills/wiki-researcher |
| 许可证 | MIT（数据来自 GitHub API 与 SKILL.md 声明） |
| GitHub Stars | 合集仓库整体 2,863（数据来自 GitHub API，2026-08-06）；该数字属整个 microsoft/skills 仓库，不代表本技能自身热度 |
| Forks | 合集仓库整体 323（数据来自 GitHub API） |
| 最新版本 | 1.0.0（SKILL.md metadata 声明；仓库未创建对应 GitHub Release） |
| 安装方式 | GitHub Copilot CLI 插件市场一条命令安装；其他兼容 Agent Skills 规范的工具（含 Claude Code）可直接复制 SKILL.md 文件 |
2. 功能介绍与亮点
wiki-researcher 面向“就代码库里的某个具体主题做一次不糊弄的深挖”这个任务：用户提出一个想深入理解的问题或系统（例如某个模块的数据流、某套架构决策的来龙去脉），技能不满足于凭文件名或常见套路猜测答案，而是要求真的去读实现代码、逐跳追踪调用链，并在每条结论旁边标注证据等级——HIGH（亲自读过代码）、MEDIUM（读了一部分、推断了其余）、LOW（仅从结构推断）。
核心亮点是一套五轮迭代的研究流程：第一轮画出整体架构与关键组件，第二轮追踪数据流与状态管理，第三轮梳理外部依赖与接口契约，第四轮盘点设计模式与技术债风险，第五轮综合全部发现给出可执行建议；每一轮都要求至少一张 Mermaid 图和一张结构化表格，且明确禁止“氛围感”图表——图上每一个节点和箭头都必须对应亲自读过的真实代码。技能同时要求主动标注“哪些地方还没探查过”，把认知边界摊开给用户看，而不是用自信的语气掩盖没读过的部分。
技能纯粹依托宿主 Agent 自身的代码检索与阅读能力运作，唯一执行的操作是两条只读 git 命令（获取远程地址、判断默认分支），用于生成可点击的源码引用链接；不依赖任何外部解析引擎、数据库或第三方服务，开箱即可对当前打开的任意代码库发起调查。
3. 适用场景
所属分类：内容创作与知识管理
- 接手陌生代码库、需要在短时间内把某个具体子系统摸透的工程师
- 排查跨多个文件、多层调用的复杂问题（如“这段数据到底是怎么流转到那里的”），需要一份可复核证据链的开发者
- 技术负责人在做架构评审或技术选型前，想先拿到一份基于真实代码而非印象的现状分析
- 需要为团队沉淀“这套系统到底是怎么运作的”知识、且要求每条结论都能追溯到具体文件行号的场景
4. 跨 Agent 兼容性
- Claude Code：SKILL.md 遵循通用 Agent Skills 规范（YAML front matter + Markdown 指令），可直接复制安装；仓库的
.claude-plugin/marketplace.json明确声明了 deep-wiki 插件条目，此前曾有用户反馈插件市场安装报错（issue #189，2026-03-12），对应修复已于 2026-03-27 通过 PR #223 合并关闭——判定为原生支持。 - GitHub Copilot CLI：官方原生渠道，README 直接给出安装命令。
- Codex / OpenClaw / Hermes Agent：未验证。README 与 SKILL.md 均未提及针对这三者的专门测试或安装说明。
5. 推荐理由
大多数 Agent 在被问“这段代码是怎么工作的”时，容易顺着变量名和常见架构套路给出一个听起来合理但没有真正验证过的答案。wiki-researcher 把这个过程变成一套有验收标准的流程：每个结论都要有文件行号支撑，每轮迭代必须包含真实图表与证据评级，还强制要求诚实标注“这部分我还没查过”。对需要频繁在陌生代码库里排障或做架构评审的开发者来说，相当于免费获得一位不会不懂装懂的资深同事。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | deep-wiki 插件所在仓库有多名独立第三方用户的真实互动记录（外部用户提交的界面渲染问题、安装问题报告），显示真实社区触达；该子目录自身历经数次功能性提交迭代；母仓库整体星数体现的是 microsoft/skills 全库热度，不代表该子目录本身 |
| 可用性 | 8 | 单文件复制即用，无需任何配置或付费依赖；SKILL.md 对研究流程、证据等级、图表规格给出了详尽且可执行的规范；该子目录最近一次改动在 2026-04-02，仓库整体在 2026-08-04 仍有推送 |
| 安全性 | 9 | 见下方检查清单，全部指标良好，无一票否决因素 |
| 综合 | 8.0 | 三项均值 |
安全检查清单：① Shell 命令——仅执行两条只读 git 命令（获取远程地址、判断默认分支），无写入或系统级操作；② 联网外发——无，全部分析基于本地文件读取；③ API Key/凭据——不需要；④ 可疑指令——SKILL.md 正文未见越权指令或隐蔽外发迹象；⑤ 作者信誉——Microsoft 官方仓库，多名具名工程师参与维护；⑥ License——MIT，明确；⑦ 最近维护——该子目录 2026-04-02 有改动，仓库整体 2026-08-04 有推送。
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与 wiki-researcher 的差异 |
|---|---|---|
| Understand-Anything | 把整个代码库一次性解析成可视化知识图谱，供新人反复浏览探索 | 产出一份静态、面向“整体架构速览”的图谱；wiki-researcher 是针对用户当次提出的具体问题做定向深挖，逐轮迭代收窄范围，每条结论都标注证据等级，更适合“追查某个具体机制”而非“通读全貌” |
| DeepWiki（deepwiki.com，第三方独立产品） | 输入任意公开 GitHub 仓库地址，自动生成一个可浏览的百科式 Wiki 网站 | 依赖把仓库地址提交给第三方托管服务生成公开页面；wiki-researcher 运行在用户自己的 Agent 会话内，可直接处理私有代码库，且不产出持久化网页，而是针对当前对话中的具体问题给出带证据链的即时调查结果 |
8. 用户评价
deep-wiki 插件所在仓库的 issue #367（2026-07-02，用户 Kyle-sandeman-mrdfood，截至 2026-08-06 仍为 open 状态）具体指出插件生成的 Mermaid 图表存在 CSS 层级问题，缩放或拖动图表时会遮挡缩放控件，并附有截图与具体代码行定位——这条反馈针对的是 deep-wiki 插件通用的图表渲染层，wiki-researcher 每轮迭代强制产出的 Mermaid 图同样会受此问题影响。目前尚未见到聚焦 wiki-researcher 研究质量本身的独立第三方评价。
9. 其他补充
wiki-researcher 所在的 deep-wiki 插件还包含 wiki-architect（产出文档目录蓝图）、wiki-page-writer（逐页撰写技术文档）、wiki-onboarding（生成多受众入职指南）、wiki-vitepress（打包成静态站点）等共 10 个子技能，组合安装可覆盖“探索问题→沉淀文档→打包发布”的完整知识管理链路；插件同时提供对应的 /deep-wiki:research 等 slash command 供 Copilot CLI 用户直接调用，功能等价。
10. 安装使用方式
GitHub Copilot CLI（官方原生渠道）：
/plugin marketplace add microsoft/skills
/plugin install deep-wiki@skills安装后可用 /deep-wiki:research 直接调用，或在对话中提出“帮我深入研究一下这个模块是怎么工作的”等请求自动触发。
其他兼容 Agent Skills 规范的工具（含 Claude Code 手动安装）：将以下文件另存为技能目录下的 SKILL.md 即可：
https://raw.githubusercontent.com/microsoft/skills/main/.github/plugins/deep-wiki/skills/wiki-researcher/SKILL.md安装后无需重启 Agent；首次运行会询问目标仓库是本地专属还是有远程地址，用于决定输出中引用链接的格式。
11. 注意事项
- 通过 Copilot CLI 插件市场安装会连带装入整个 deep-wiki 插件（10 个技能 + 命令 + 自定义 agent）；只想用 wiki-researcher 单个技能时需手动复制对应 SKILL.md 文件
- 研究深度与准确性高度依赖宿主 Agent 自身的代码检索与理解能力，技能本身不包含独立的静态分析引擎或调用图工具
- 五轮迭代流程篇幅较长，对于范围很小的简单问题（如单个函数的用途）可能显得“杀鸡用牛刀”，更适合真正复杂、跨文件的调查任务
- 版本号固定为 SKILL.md 声明的 1.0.0，仓库未建立正式 GitHub Release，版本追踪需以提交历史为准