1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | wiki-qa-microsoft-skills |
| 作者/维护者 | Microsoft（官方仓库 microsoft/skills，主要提交者 Govind Kamtamneni，另有 Larry Osterman、Scott Addie 等具名工程师参与维护迭代） |
| 来源链接 | https://github.com/microsoft/skills/tree/main/.github/plugins/deep-wiki/skills/wiki-qa |
| 许可证 | 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-qa 面向“针对代码库提一个具体问题、马上要一个有证据支撑的回答”这个场景：用户问“这个组件是怎么工作的”或“某个函数在哪里定义”，技能被要求先确认源码上下文（本地专属仓库，还是有可关联的远程地址），再实际读取相关源文件，最后给出带精确行号引用的答案，而不是凭变量名和常见套路猜测。
核心亮点：
- 强制“先定位源仓库上下文”：回答前必须先探测 git 远程地址与默认分支，据此决定引用格式——有远程地址时生成可点击的
文件:行号超链接，仅本地时退化为纯路径引用 - 语言自适应：检测提问所用语言，用同一语言作答
- 回答格式规范：涉及架构、数据流或组件关系类问题时，至少配一张 Mermaid 图；用表格列出“关键文件”及其角色；代码块统一带语言标签
- 铁律“只用源文件里的真实信息作答，不得编造或调用外部知识”——把答案的可信度锚定在实际代码而非模型的先验印象上
技能本身极其精简（单文件 SKILL.md），不依赖任何外部解析引擎、索引或数据库，只调用宿主 Agent 自身已有的文件检索与阅读能力；唯一执行的操作同样是两条只读 git 命令。
3. 适用场景
所属分类：内容创作与知识管理
- 刚接手陌生代码库、需要快速定位“某个函数/组件在哪里、怎么运作”的开发者
- Code Review 或调试过程中需要一个可追溯到具体代码行的解释，而非模型凭印象给出的笼统描述
- 团队新人在 Onboarding 阶段反复提问“这段代码是干嘛的”，需要即时且有据可查的回答
- 面向可能用非英语提问的国际化团队（技能按提问所用语言自动作答）
4. 跨 Agent 兼容性
- Claude Code：SKILL.md 遵循通用 Agent Skills 规范（YAML front matter + Markdown 指令），可直接复制安装；仓库的
.claude-plugin/marketplace.json声明了 deep-wiki 插件条目，此前用户反馈的 Claude Code 插件市场安装报错（issue #189，2026-03-12）已于 2026-03-27 通过 PR #223 合并修复——判定为原生支持。 - GitHub Copilot CLI：官方原生渠道，通过
/deep-wiki:ask命令直接调用。 - Codex / OpenClaw / Hermes Agent：未验证。README 与 SKILL.md 均未提及针对这三者的专门测试或安装说明。
5. 推荐理由
多数 Agent 被问“这段代码怎么工作”时，容易顺着变量名和常见套路给出一个听起来合理但没有真正核实过的答案。wiki-qa 把“先确认引用来源、再作答”变成强制步骤，还要求带精确到行号的可点击引用，并明令禁止使用源码之外的知识回答。对需要频繁回答“这是什么/在哪里/怎么运作”这类问题的开发团队来说，相当于把每一次代码问答都变成一次可核实的调查，而不是一次听起来专业的猜测。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 该子目录有多名独立第三方工程师参与实质迭代（Larry Osterman 提交的测试重构、Scott Addie 的字段规范化提交），显示真实的组织内协作与持续维护；出品方 Microsoft 是公认的一线科技厂商，组织信誉本身构成背书；该子技能的热度不能直接沿用母仓库的整体星数 |
| 可用性 | 8 | 单文件复制即用，零配置、无付费依赖；流程规范（源仓库解析 → 回答 → 引用格式）完整且可执行，但 SKILL.md 未附带具体问答示例，未满足“文档完整含示例”这一 9–10 档要求；该子目录 2026-04-20 仍有独立第三方提交，仓库整体持续活跃 |
| 安全性 | 9 | 见下方检查清单，全部指标良好，无一票否决因素 |
| 综合 | 8.0 | 三项均值 |
安全检查清单：① Shell 命令——仅执行两条只读 git 命令（获取远程地址、判断默认分支），无写入或系统级操作；② 联网外发——无，全部分析基于本地文件读取；③ API Key/凭据——不需要；④ 可疑指令——SKILL.md 正文未见越权指令或隐蔽外发迹象；⑤ 作者信誉——Microsoft 官方仓库，多名具名工程师参与维护；⑥ License——MIT，明确；⑦ 最近维护——该子目录 2026-04-20 有独立第三方提交，仓库整体持续活跃推送。
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与 wiki-qa 的差异 |
|---|---|---|
| wiki-researcher（同一 deep-wiki 插件的姊妹技能） | 五轮迭代的深度架构调查引擎，产出证据分级的系统性发现 | wiki-researcher 面向“系统性摸透一个复杂子系统”的长任务，篇幅长、投入高；wiki-qa 面向“马上要个准确答案”的单轮问答，响应更快更轻量，适合高频、零散的日常提问场景 |
| DeepWiki（deepwiki.com，第三方独立产品） | 输入任意公开 GitHub 仓库地址，自动生成可浏览的百科式 Wiki 网站供离线查阅 | 依赖预先生成的静态页面，仅覆盖已生成过的公开仓库；wiki-qa 实时读取当前对话上下文中的仓库代码作答，可处理私有仓库与刚提交的最新改动，无需等待页面生成 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。deep-wiki 插件所在仓库的 issue #367（2026-07-02，用户 Kyle-sandeman-mrdfood，截至本次运行仍为 open 状态）反馈的是插件通用图表渲染层的 Mermaid 缩放控件遮挡问题——wiki-qa 仅在回答涉及架构或数据流类问题时才会生成图表，因而只在部分场景下受此问题影响。
9. 其他补充
wiki-qa 所属的 deep-wiki 插件共 10 个子技能，其中 wiki-researcher、wiki-architect、wiki-page-writer、wiki-onboarding、wiki-vitepress 已作为独立技能收录，覆盖从“深度调查”到“文档产出”再到“静态站点打包”的完整链路；wiki-qa 补上了这条链路里最高频的“随手一问”场景。
10. 安装使用方式
GitHub Copilot CLI（官方原生渠道）：
/plugin marketplace add microsoft/skills
/plugin install deep-wiki@skills安装后可用 /deep-wiki:ask 直接提问，或在对话中直接提出代码相关问题自动触发。
其他兼容 Agent Skills 规范的工具（含 Claude Code 手动安装）：将以下文件另存为技能目录下的 SKILL.md 即可：
https://raw.githubusercontent.com/microsoft/skills/main/.github/plugins/deep-wiki/skills/wiki-qa/SKILL.md安装后无需重启 Agent；首次提问时会先询问目标仓库是本地专属还是有远程地址，用于决定引用链接格式。
11. 注意事项
- 通过 Copilot CLI 插件市场安装会连带装入整个 deep-wiki 插件（10 个技能 + 命令 + 自定义 agent）；只想用 wiki-qa 单个技能时需手动复制对应 SKILL.md 文件
- 回答质量完全依赖宿主 Agent 自身的代码检索与阅读能力，技能本身不含独立的静态分析引擎、索引或向量检索
- 铁律“只用源文件信息作答”意味着遇到源码之外的通用知识型问题（如“这个框架的最佳实践是什么”）时，技术上超出该技能设计范围，需改用其他通用问答方式
- 版本号固定为 SKILL.md 声明的 1.0.0，仓库未建立正式 GitHub Release，版本追踪需以提交历史为准