# 怎么让 AI 直接用某个文件或技能？

> Cube Agent 2.2.0 正式版（构建 2002007）使用说明。
> 分类：聊天。内容基准：2026-11-07。
> 网页：https://cubeagent.app/docs/chat_mention_files_skills/

## 功能说明

不用再描述「去读某某文件」「用某某技能」：在输入框里直接点名，内容会随这条消息一起交给 AI，省去 AI 先查找、再读取的往返，也不会选错名字相近的技能。

- **@ 引用文件**：本对话工作目录里生成或导入的文件，以及本对话选中的本地文件夹、网络存储里的文件。
- **@ 选择 SSH 服务器（Pro）**：已允许 AI 使用的 SSH 服务器，选中后作为这条消息的操作目标。
- **/ 指定技能**：当前助手已启用的技能。

## 怎么使用

- **引用文件**：在输入框末尾输入 **@**，列出可引用的文件（网络存储只列根目录），继续输入文件名可筛选，点选后输入框显示为「@文件名」。每条消息最多 8 个文件；单个文件超过约 2.4 万字只发送开头，一条消息合计约 6 万字。PDF、Word 等文档会先提取文字，图片等非文本文件不会附上。
- **选择 SSH 服务器（Pro）**：同样输入 **@**，按服务器名称或地址筛选后点选，输入框显示为「@服务器名」。发送前会重新确认服务器仍可用；AI 执行的命令仍按 SSH 审批规则询问或自动执行，网页端用法相同。
- **指定技能**：在输入框开头或空格后输入 **/**，再输入名称或描述里的词筛选、点选；也可以点 **＋ → 技能** 打开完整列表搜索和多选。工具栏也能加一个「技能」按钮，在工具栏设置中开启。每条消息最多 3 个，选中的技能显示在输入框上方，点 × 移除。列表只显示当前助手已启用的技能，去启用点列表底部的 **管理本助手的技能**。
- 发送后，消息下方显示「引用文件：…」或「使用技能：…」，点开可查看每一项是完整附上、只附了开头，还是沿用前文。

## 最佳实践

- 引用的文件和技能正文按发送时的样子保存在这条消息上，之后每轮原样带上，便于命中缓存；之后修改文件或技能不影响已发送的内容，需要新内容就重新引用。同一份内容前文已附过时，只提示 AI 沿用，不重复占用上下文。
- 只引用这一轮真正需要的文件；资料很长时，让 AI 按需分段读取更省上下文。
- 技能正文特别长时只发送开头，其余由 AI 按需读取。修改助手启用的技能后，下一次请求会重新建立一次提示词缓存。
- 无痕对话和管理会话不提供 @ 引用。引用和指定技能的效果仍取决于模型的指令遵循能力。