如何让 Agent 模式识别代码库和文档

了解如何让您的 Agent 模式访问代码库和文档,以获取更具上下文感知能力的辅助

当 Agent 模式了解项目上下文时,其表现最佳。本指南将向您展示如何让 Agent 模式访问代码库和文档,从而使其更高效、更准确。

让 Agent 模式感知您打开的代码库

当 Agent 模式了解您当前的代码库时,它可以提供更相关的建议和回答。

让 Agent 模式使用工具探索代码库

Agent 模式可以使用内置工具来导航和理解您的代码
  1. 文件探索工具:Agent 可以读取文件、搜索模式并理解项目结构
  2. 代码搜索:使用搜索来查找相关的代码片段
  3. Git 集成:访问提交历史记录并了解代码演变

创建规则以帮助 Agent 理解您的代码库

规则可以引导 Agent 模式的行为和理解能力。在项目的 .continue/rules 中放置 Markdown 文件,以提供上下文
# Project Architecture

This is a React application with:

- Components in `/src/components`
- API routes in `/src/api`
- State management using Redux in `/src/store`

## Coding Standards

- Use TypeScript for all new files
- Follow the existing naming conventions
- Write tests for all new features
在项目层级的不同位置放置规则文件,以设定其触发范围
了解更多关于 规则配置 的信息。

让 Agent 模式感知其他代码库

有时您需要 Agent 模式了解当前项目之外的代码。

公开代码库

对于开源项目和公共存储库,您有几种选择
创建指向外部代码库的规则
# External Dependencies

Our authentication system is based on:

- [Auth.js documentation](https://authjs.oauth.ac.cn/)
- [Example implementation](https://github.com/nextauthjs/next-auth-example)

When implementing auth features, reference these patterns.

GitHub 和 GitLab CLI

启用 ghglab CLI 访问,以便 Agent 模式与存储库进行交互。
添加规则以指导 CLI 的使用
# Repository Access

You can use the `gh` CLI to:

- Search for issues: `gh issue list --repo owner/repo`
- View pull requests: `gh pr list --repo owner/repo`
- Clone repositories: `gh repo clone owner/repo`

DeepWiki MCP

DeepWiki MCP 让 Agent 模式可以探索任何公共 GitHub 存储库。
配置完成后,Agent 模式可以探索如下存储库
  • “探索 React 存储库结构”
  • “查找 NextAuth.js 中是如何实现身份验证的”

内部代码库

对于私有和内部存储库,您需要额外的设置

自定义 MCP 服务器

创建一个可以访问您内部存储库的 MCP 服务器。

自定义代码 RAG

对于超大型内部代码库,若需更快的检索速度和更低的成本,请考虑实现 自定义代码 RAG 系统。这是一种高级方案,需要更多设置,但可以在大规模场景下提供性能优势。

让 Agent 模式感知相关文档

文档为 Agent 模式理解 API、框架和最佳实践提供了至关重要的上下文。

公开文档

引导 Agent 模式访问相关文档
# Documentation Resources

For framework-specific questions, refer to:

- React: https://reactjs.ac.cn/reference/react
- Next.js: https://nextjs.net.cn/docs
- Tailwind CSS: https://tailwind.org.cn/docs

Always cite documentation when explaining concepts.

Context7 MCP

Context7 MCP 使 Agent 模式能够搜索并检索公开文档中的信息
随后,Agent 模式可以回答以下问题
  • “如何使用 React Hooks?”
  • “Tailwind CSS 动画的语法是什么?”

内部文档

针对私有文档和维基
创建引用内部资源的规则
# Internal Documentation

Our team documentation is available at:

- API Documentation: https://internal.docs/api
- Architecture Guide: https://internal.docs/architecture
- Deployment Process: https://internal.docs/deployment

Always follow our internal standards when suggesting code.

用于文档的自定义 MCP 服务器

创建一个可以访问您内部文档的 MCP 服务器。

从已弃用的上下文提供程序迁移

如果您之前使用了 @Codebase@Docs 上下文提供程序,请按照以下方式迁移到新方案

从 @Codebase 迁移

@Codebase 上下文提供程序已被弃用。请改用:
  1. 使用内置工具:Agent 模式现在可以使用文件探索和搜索工具来理解您的代码库
  2. 添加规则:创建 .continue/rules 文件以提供关于项目结构的上下文
  3. 使用 MCP 服务器:对于外部代码库,使用 DeepWiki MCP 或自定义 MCP 服务器

从 @Docs 迁移

@Docs 上下文提供程序已被弃用。请改用:
  1. 使用 Context7 MCP:对于公开文档,Context7 MCP 提供了类似的功能
  2. 在规则中添加文档链接:创建引用文档 URL 的规则
  3. 使用自定义 MCP 服务器:对于内部文档,创建一个可以访问您文档的 MCP 服务器
新方案提供了与 Continue 的 Agent 模式功能的更好集成,以及更智能的上下文选择。

后续步骤