#文件引用

#引用项目文件

Claude Code 会根据任务读取相关文件，无需把整个项目逐一粘贴到对话中。已有明确文件时，可通过 @ 路径引用，或直接在提示词中写明路径；同名文件较多时，应提供包含目录的完整相对路径，避免定位错误。

请阅读 @docs/requirements.md 和 @src/search.ts。

先核对“{按名称搜索}”的现有实现是否符合需求文档。
请列出一致项、差异项及对应位置。
本轮仅检查，不修改文件。

如果任务涉及多个目录，宜说明各目录的用途。需要访问当前工作目录以外的资料时，可通过 /add-dir 添加工作目录，并检查实际授予的范围。添加目录主要用于扩大文件访问范围，不代表其中所有项目配置都会自动加载。

处理大型项目时，不宜在任务开始时要求无差别阅读全部文件。可以先定位相关模块，再沿接口、调用关系和测试逐步展开。读取范围越明确，越容易保留与当前判断有关的信息。

#提供图片资料

截图适用于说明页面布局、显示异常、操作结果和预期效果。终端版支持通过剪贴板添加图片：Windows 与 WSL 可使用 Alt+V，macOS 与 Linux 通常使用 Ctrl+V，也可提供本地图片路径，要求读取后分析。粘贴后应确认输入区域出现图片标记，避免仅粘贴了文件名而未提供图片内容。

上传或引用多张图片时，应逐一说明用途，例如“第一张为当前效果，第二张为目标布局”。通过剪贴板添加时，可先粘贴第一张，再复制并粘贴第二张，确认图片顺序与用途说明一致后发送。尺寸、文字和交互条件宜同时用文字列明，避免将图片中无法确认的细节当作明确要求。

请比较所提供的两张截图。

图片用途：
{第一张为当前页面，第二张为目标布局参考}。

检查重点：
{标题层级、内容间距、卡片排列和小屏幕下的可读性}。

请先列出主要差异，并结合当前项目说明可能涉及的文件。
参考图中的文字仅作布局示意，实际文案以{docs/content.md}为准。
尚未确认的尺寸和交互，请单独列出，不自行补充。

截图分析与浏览器验证属于不同环节。识别截图中的问题，并不意味着已经打开页面或测试交互；若需要实际操作网页，应确认当前会话具备相应浏览器工具与运行条件。

#处理文档资料

文本、源代码、Markdown、日志和 CSV 便于围绕具体内容检索与分析，PDF、Word、Excel 和 PowerPoint 则应结合文件结构、读取工具及任务目标选择处理方式，不宜仅根据扩展名判断能够完整理解或原样编辑。

PDF 应检查是否提取到所需文字、表格与图片，扫描件还需要确认识别结果。Office 文件的处理可能涉及脚本、解析库或其他工具；能够读取部分内容，不等于能够保留全部公式、批注、动画、版式和其他应用特性。对于这些文件，宜先要求说明读取方法与实际可见内容，再开始修改。

请先检查项目目录中的{资料文件名称}能否被当前环境完整读取。

本次需要使用的内容：{指定章节、工作表或页面}。
处理目标：{提取信息／核对数据／修改指定内容}。

请说明：
1. 实际读取到的内容范围；
2. 是否存在未能识别的表格、图片、公式或其他元素；
3. 完成任务是否需要安装额外工具；
4. 修改后可采用哪些方法检查结果。

本轮先报告读取情况，暂不覆盖原文件。

对于需要保留的原始资料，应明确输出路径，并要求将处理结果另存为新文件。生成后仍需在相应应用中检查关键内容，尤其是公式引用、分页、字体和图表。