DeepWiki代码库研究助手Skill researching-with-deepwiki

名称：使用DeepWiki进行研究描述： | 使用DeepWiki MCP服务器研究GitHub、GitLab和Bitbucket仓库。适用于探索不熟悉的代码库、理解项目架构或询问特定开源项目的工作原理。提供基于AI的仓库分析和基于RAG的源代码问答。不适用于获取库API文档（请改用fetching-library-docs）或本地文件。

使用DeepWiki进行研究

使用DeepWiki MCP服务器研究和理解代码库。

MCP服务器设置

添加到您的Claude Code设置中：

claude mcp add -s user -t http deepwiki https://mcp.deepwiki.com/mcp

或添加到settings.json：

{
  "mcpServers": {
    "deepwiki": {
      "type": "http",
      "url": "https://mcp.deepwiki.com/mcp"
    }
  }
}

私有仓库

对于私有仓库，使用带认证的Devin.ai端点：

{
  "mcpServers": {
    "deepwiki": {
      "type": "http",
      "url": "https://mcp.devin.ai/deepwiki/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_DEVIN_API_KEY"
      }
    }
  }
}

何时使用DeepWiki

场景	使用DeepWiki？
探索不熟悉的开源代码库	是
理解项目架构	是
查找功能如何实现	是
为仓库生成文档	是
处理本地代码	否 - 使用Glob/Grep
在已知结构中快速查找文件	否 - 使用Read工具

核心功能

1. 仓库分析

让DeepWiki分析任何公共仓库：

"分析github.com/vercel/next.js的架构"
"github.com/remix-run/react-router中的路由系统是如何实现的？"
"github.com/anthropics/anthropic-sdk-python中使用了哪些设计模式？"

2. 代码结构理解

获取项目组织的见解：

"解释github.com/langchain-ai/langchain的目录结构"
"github.com/fastapi/fastapi中的主要模块有哪些？"
"github.com/pytest-dev/pytest中的测试是如何组织的？"

3. 功能调查

了解特定功能的工作原理：

"github.com/openai/openai-python中的流式处理是如何工作的？"
"github.com/better-auth/better-auth中在哪里处理认证？"
"github.com/honojs/hono中如何实现中间件？"

4. 架构可视化

DeepWiki可以生成Mermaid图表：

"为github.com/prisma/prisma生成架构图"
"展示github.com/trpc/trpc中的数据流"

最佳实践

1. 问题要具体

# 好 - 具体问题
"github.com/vercel/swr中的缓存系统如何工作？"

# 效果较差 - 过于宽泛
"告诉我关于github.com/vercel/swr的信息"

2. 引用特定路径

# 好 - 有针对性的调查
"解释github.com/pmndrs/zustand中的src/core目录"

# 也好 - 功能导向
"github.com/pmndrs/zustand中如何实现中间件模式？"

3. 比较实现方式

"比较github.com/tanstack/query和github.com/vercel/swr如何处理缓存失效"

4. 从流行项目中学习

"对于我的组件库，应该遵循github.com/shadcn-ui/ui中的哪些模式？"

常见用例

学习新框架

1. "解释github.com/honojs/hono的核心概念"
2. "如何在github.com/honojs/hono中添加中间件？"
3. "展示github.com/honojs/hono中的示例路由处理程序"

调试集成问题

1. "github.com/drizzle-team/drizzle-orm如何处理连接池？"
2. "github.com/drizzle-team/drizzle-orm抛出哪些错误类型？"

准备贡献代码

1. "github.com/anthropics/claude-code的贡献流程是什么？"
2. "github.com/anthropics/claude-code中如何标记问题？"
3. "github.com/anthropics/claude-code中使用哪些测试模式？"

支持平台

平台	URL格式
GitHub	`github.com/所有者/仓库`
GitLab	`gitlab.com/所有者/仓库`
Bitbucket	`bitbucket.org/所有者/仓库`

限制

速率限制：公共端点有使用限制
私有仓库：需要Devin.ai API密钥
大型仓库：可能需要时间分析
实时变更：缓存的分析可能不反映最新提交

验证

运行：python3 scripts/verify.py

预期结果：✓ DeepWiki MCP服务器已配置

如果验证失败

检查：MCP服务器是否在设置中配置
测试：尝试简单查询如"分析github.com/anthropics/anthropic-sdk-python"
如果仍然失败，请停止并报告

参考

DeepWiki - 主要服务
MCP端点 - 公共MCP服务器