如何让 Agent 模式识别代码库和文档
了解如何让您的 Agent 模式访问代码库和文档,以获取更具上下文感知能力的辅助
当 Agent 模式了解项目上下文时,其表现最佳。本指南将向您展示如何让 Agent 模式访问代码库和文档,从而使其更高效、更准确。
让 Agent 模式感知您打开的代码库
当 Agent 模式了解您当前的代码库时,它可以提供更相关的建议和回答。
让 Agent 模式使用工具探索代码库
Agent 模式可以使用内置工具来导航和理解您的代码
- 文件探索工具:Agent 可以读取文件、搜索模式并理解项目结构
- 代码搜索:使用搜索来查找相关的代码片段
- 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
启用
gh 或 glab 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 上下文提供程序已被弃用。请改用:- 使用内置工具:Agent 模式现在可以使用文件探索和搜索工具来理解您的代码库
- 添加规则:创建
.continue/rules文件以提供关于项目结构的上下文 - 使用 MCP 服务器:对于外部代码库,使用 DeepWiki MCP 或自定义 MCP 服务器
从 @Docs 迁移
@Docs 上下文提供程序已被弃用。请改用:- 使用 Context7 MCP:对于公开文档,Context7 MCP 提供了类似的功能
- 在规则中添加文档链接:创建引用文档 URL 的规则
- 使用自定义 MCP 服务器:对于内部文档,创建一个可以访问您文档的 MCP 服务器
新方案提供了与 Continue 的 Agent 模式功能的更好集成,以及更智能的上下文选择。