代理会读取你的代码和代码库中的指令文件。上下文会将那些记忆文件与项目笔记、生成的上下文及引用内容整合在一起。
关于此处内容的设定依据,可阅读项目上下文在“概念”板块中有相关介绍。本页面主要讲解如何管理它。
代码库记忆文件
打开设置 → 知识库 → 上下文并查看下方的代码库来源。Coroid会从已连接的代码库中读取这些文件:
AGENTS.md位于代码库根目录:通用代理指令CLAUDE.md位于代码库根目录:Claude指令GEMINI.md位于代码库根目录:Gemini指令.cursor/rules:受支持的Cursor规则文件
这类文件通常被称为记忆文件。启用后的内容会在代理开始工作前被纳入其项目上下文中。这些文件的名称并不限定于特定模型:启用的来源会被整合供Coroid的代理使用。
现有文件会显示“编辑”操作按钮、预估词数,以及一个用于控制代理是否读取这些内容的开关。除非你明确禁用,否则来源默认处于启用状态。如果多个文件内容重复或相互矛盾,只需保留你希望代理遵循的来源并禁用其余文件即可。
创建表示该文件在Coroid的代码库检出结果中不存在。如果读取失败,页面会提供重试;访问失败并不意味着文件确实缺失。请确认该文件已提交到已连接代码库的分支中。执行任务时,代理会读取任务的检出内容,因此对该分支中指令文件的修改会同步作用于任务。
已启用的内存文件可导入仓库中的Markdown文档,支持以下格式:@path、例如@AGENTS.md位于CLAUDE.md或@docs/conventions.md。路径是相对于包含引用的文件解析的。Coroid会处理嵌套导入、防止循环引用,且每个文件和相同的指令内容仅会被包含一次。代码示例和电子邮件地址中的导入内容不会被处理。仓库外的引用不会被加载,且导入操作无法绕过明确禁用的仓库源。
只有列出的根源文件会被自动识别。嵌套的AGENTS.md以及
单独的.cursor/rules/*.mdc文件可通过导入方式纳入;其目录范围不会自动推断出来。@导入;其目录范围不会自动推断出来。
应用上下文
在“应用上下文将指令和参考资料存储在 Coroid 中。手动笔记和生成的项目上下文可以独立于仓库文件启用或禁用。这些条目适用于存放 Git 之外的内容。
添加上下文
选择添加上下文然后添加一条条目。每条条目都包含标题和正文,后续可编辑或删除。
优质的条目应当简短、具体且稳定。架构决策、编码规范、API 契约、所有权边界以及明确的禁止性规定都属于此类内容。入职指引以及仓库中已明确说明的内容则无需纳入。
保持条目独立并命名清晰
每个主题对应一条条目,标题需明确说明其涵盖的内容。“错误处理规范”和“冻结模块”这类条目可被快速检索;而名为“备注”且同时包含两者的单一条目则无法实现高效检索。
这一点至关重要,因为上下文会根据当前工作内容选择性加载——详见渐进式技能划分清晰的条目能让对应任务加载到正确的上下文信息。
参考资料
除了文字记录外,你还可以附加参考资料——即指向其他位置存储内容的链接和文档。当权威副本存放在Wiki或设计工具中,且你不想保留一份容易过时的冗余副本时,便可选用这种方式。
单任务上下文
项目级别的上下文适用于项目内的所有内容。若某份资料仅与某项工作相关——比如工单、客户报告或设计文档——应将其附加到对应任务中。若把这类特定任务的备注放入项目上下文中,就会给后续所有任务带来干扰。
确保内容实时准确
过时的上下文比缺失的上下文危害更大,因为智能体往往会将其视为权威依据。一旦规范发生变化,务必在修改代码的同一变更中同步更新对应的上下文条目。
审核现有上下文内容
偶尔像新用户一样浏览你的上下文内容。条目会不断累积,一年前迁移过程中写入的内容如今可能已造成误导。