@ Mentions 与上下文
引用已知文件、终端、历史聊天、Git diff 和浏览器,让 Agent 聚焦相关证据。
在聊天输入框键入 @ 可添加上下文。知道相关文件时显式引用,不知道时让 Agent 先搜索;无需为了“完整”附上整个仓库。
可引用内容
| 内容 | 入口 |
|---|---|
| 文件与文件夹 | @auth.ts、@src/components/;选中文件夹后输入 / 可继续深入 |
| 终端输出 | @Terminals |
| 之前的聊天 | @Chats |
| 未提交改动 | @Commit (Diff of Working State) |
| 分支相对 main 的改动 | @Branch (Diff with Main) |
| 内置浏览器 | @Browser |
可以多次输入 @,加入多个对象。例如修改组件时同时引用对应测试,并说明每份材料与任务的关系。
选择上下文的顺序
先说明希望的结果,再加你已经知道的关键位置。若只是错误日志,附上终端输出和复现行为;若是回归问题,引用相关 diff 并指出预期行为。历史聊天可补充决策背景,但当前代码仍需重新核对。
文件内容是否可直接加入还受忽略规则影响。搜索和终端不是相同文件访问路径,应按实际工具理解其边界。