跳转到主要内容

Knowledge 101

Knowledge 是在代码库层面(而非任务层面)向 Devin 提供上下文信息的最佳方式,能帮助 Devin 更好地在你的代码库中工作。适合写入 Devin Knowledge 的信息包括:代码规范实践、部署流程、PR 命名规范、测试流程、如何与专有工具交互等。 关于 Knowledge,有几件需要注意的事:
  • Devin 会基于已存在的 README、文件结构以及已连接代码库的内容自动生成仓库级 Knowledge(repo knowledge)。请注意,如果你没有给 Devin 访问该仓库的权限,它就不会生成任何关联的 Knowledge。
  • Knowledge 会根据你设置的 Trigger(触发条件)来检索。Trigger 越具体(例如适用的文件、仓库或任务类型),检索效果就越好。你可以在这里找到更多细节。
  • Devin 会在会话中告诉你它使用了哪些 Knowledge,你可以在会话聊天中的“Accessed Knowledge”下方查看。
  • Devin 会基于你代码库中的一些特殊文件(包括 .rules.mdc.cursorrules.windsurfCLAUDE.mdAGENTS.md)自动获取并更新 Knowledge。请注意,Devin 不会自动获取更通用的文件类型,比如 .md

Knowledge 入门最佳实践

前期花一点时间帮助 Devin 熟悉环境非常有价值。就像新入职的工程师一样,向 Devin 提供代码库和工程团队工作流的相关背景信息,将大幅提升 Devin 的工作效果。首次配置 Devin 的 Knowledge 时,建议按以下步骤进行:
  1. 检查所有自动生成的 Knowledge,核实其 (a) 完整性 和 (b) 准确性。
  2. 如果你希望 Devin 在处理任意会话时都能检索到这条 Knowledge 笔记,请务必将其固定到所有代码仓库。否则,如果信息只与某个特定仓库相关,你可以仅将其固定在该仓库。如果 Knowledge 未被固定,它只会在被触发时使用,因此请确保你的 Trigger Description 描述清晰。
  3. 如果你的代码库中尚未有集中存放的专用文档文件,我们强烈建议你创建一个,并使用专用的文件扩展名。
访问 Knowledge 产品指南 了解更多详情。