context7

## 触发场景

用户消息满足以下**任一条件**时触发：

1. **包含 GitHub URL**
   - 消息中包含 `github.com` 链接
   - 示例：`https://github.com/user/repo`

2. **提到公开库/开源仓库**
   - 关键词：「公开库」「开源仓库」「GitHub 仓库」「开源项目」「GitHub 项目」
   - 示例：「我想了解这个开源项目的实现」

3. **AI 判断需要参考 GitHub 代码**
   - 当前任务涉及理解或使用某个库的最新版本
   - 需要查看某个库的具体实现
   - 需要了解某个框架的最新 API

## 不触发的场景

- 仅是普通讨论 GitHub 概念，不涉及具体代码
- 用户明确表示不需要查看源码
- 任务已经很明确，不需要额外的文档参考

## 执行流程

### 阶段 1: 自动检测 GitHub 需求

**步骤 1.1: 识别触发条件**

检查用户消息是否满足以下任一条件:
- 包含 `github.com` URL (如: https://github.com/user/repo)
- 提到特定框架/库名称需要查看文档 (如: "Next.js 14 文档", "React hooks API")
- 询问开源项目实现方式
- 需要最新版本的 API 参考

**步骤 1.2: 评估 context7 必要性**

✅ 需要 context7:
- 涉及具体代码库的实现细节
- 需要特定版本的 API 文档
- 学习新框架或库
- 查看官方示例项目

❌ 不需要 context7:
- 通用编程概念讨论
- 已有足够上下文信息
- 简单问题不需要查源码
- 私有仓库 (context7 仅支持公开库)

### 阶段 2: 自动调用 context7 MCP

**步骤 2.1: 透明告知用户**

在调用 context7 前,简要告知用户:

```
💡 正在使用 context7 获取 [仓库名/框架名] 的最新文档...
```

**步骤 2.2: 调用 context7 MCP**

直接使用 context7 MCP 工具获取文档内容。无需等待用户明确许可。

**步骤 2.3: 基于最新文档回答**

使用 context7 返回的文档内容:
- 提供准确的 API 用法
- 引用最新的代码示例
- 说明版本特定的特性

### 阶段 3: 后续处理

**步骤 3.1: 如果 context7 失败**

如果 context7 调用失败 (如仓库不存在、网络问题):
- 告知用户 context7 不可用
- 基于现有知识回答
- 建议用户手动查看仓库

**步骤 3.2: 引用来源**

回答时明确说明信息来源:
```
根据 context7 获取的 [仓库名] 最新文档...
```

## context7 功能说明

### 核心功能

context7 是一个 MCP (Model Context Protocol) 服务器，用于解决 LLM 依赖过时或通用库信息的问题。

**它能做什么：**
- 拉取 GitHub 仓库的最新文档
- 获取特定版本的代码示例
- 提供准确的 API 参考
- 避免生成不存在或已废弃的 API

### 使用场景

**✅ 适合使用 context7 的场景：**
- 学习新框架或库的使用方法
- 查看某个开源项目的具体实现
- 需要最新版本的 API 文档
- 想了解某个库的设计模式
- 需要准确的代码示例而非通用建议

**❌ 不适合使用 context7 的场景：**
- 讨论编程概念，不涉及具体库
- 已经很熟悉的库，不需要查文档
- 私有仓库（context7 仅支持公开库）
- 简单的代码问题，不需要参考源码

### 配置检查

如果用户决定使用 context7，在提示之前先检查配置：

1. **检查 MCP 是否已配置**
   - `.mcp.json` 或 `.cursor/mcp.json` 中是否有 context7 配置
   - 如果没有，建议用户运行 `/sync:mcp` 命令

2. **配置文件示例**
   ```json
   {
     "mcpServers": {
       "context7": {
         "command": "npx",
         "args": ["-y", "@upstash/context7-mcp"],
         "env": {}
       }
     }
   }
   ```

## 提示风格

### 语气和态度