工作目录与工具范围
工作目录是文件路径和命令的默认起点；实际访问范围还取决于会话权限、运行环境与操作系统权限。
什么是工作目录
工作目录就是 Agent 的当前目录，和终端里的 cwd 是同一个概念。
文件读写和命令执行默认都从这个目录出发，所以当你让 Agent「读一下配置文件」或者「把测试跑起来」时，它都从这里开始，而不是别处。
对话进行期间随时可以更换工作目录，更换立即生效，之后执行的命令都会从新的位置开始运行，不必重开会话。
- 读取文件及其内容。
- 新建文件或覆盖已有文件。
- 用精确的文本替换修改文件。
- 按文件名查找、按内容搜索。
- 在该目录上下文里执行 shell 命令。
设置工作目录
单个会话的工作目录在输入区设置，通过输入区的文件夹标记进入。
文件夹标记显示当前目录名；如果该目录是 Git 仓库，还会显示当前分支。
点击标记即可打开目录选择器，在其中选择最近用过的文件夹、浏览其他文件夹，或者恢复到该会话的默认目录。
工作区默认目录决定新会话的起点，在「设置 → 工作区」中指定。新会话会自动带上这个目录，单个会话仍可以在输入区改到别处。
- 点击输入区的文件夹标记，从最近目录中选择一个文件夹。
- 也可以浏览其他文件夹，或者恢复到该会话的默认目录。
- 需要调整新会话的起点时，打开「设置 → 工作区」中的默认工作目录，选择目标文件夹。
- 确认文件夹标记已经更新；此后运行的命令都从新的位置开始。
可用工具
一组内置工具默认从工作目录出发，直接作用于运行工作台所在环境的文件系统。
它们不经过 MCP 中转，因此无论是否连接了来源，工具调用的方式都一样。
| 工具 | 用途 | 示例 |
|---|---|---|
| Read | 查看文件内容 | 读一份配置文件 |
| Write | 新建或覆盖文件 | 写一个新的组件 |
| Edit | 做精确的文本替换 | 修复已有代码里的缺陷 |
| Glob | 按文件名模式查找 | 找出所有 *.tsx 文件 |
| Grep | 按内容搜索 | 查找某个函数的调用处 |
| Bash | 执行 shell 命令 | 运行测试、执行 git 操作 |
项目上下文文件
如果工作目录里有项目上下文文件，它的内容会自动进入 Agent 的上下文。
ZeroWorks 可以识别 AGENTS.md 与 CLAUDE.md，仓库保留自己常用的那份即可，不必改名。
适合写进去的内容有四类：项目结构与约定、构建与测试命令。
另外两类是重要文件及其用途，以及团队约定的工作方式。
This is a Next.js application written in TypeScript. ## Commands - npm run dev - start the development server - npm test - run the tests - npm run build - production build ## Structure - src/components/ - React components - src/lib/ - utility functions - src/app/ - Next.js app router pages
命令与目录结构
命令默认从工作目录执行，同一句话在不同目录里含义不同；命令本身也可以通过绝对路径或 cd 访问其他位置。
任务涉及多个项目时，明确指出项目名称，并让 Agent 先说明自己所在的目录再动手。
目录结构帮助 Agent 定位材料与判断改动范围，但不会限制它读取其他可访问路径。
结构清晰时更容易定位具体模块并保持改动集中；把生成产物与源码分开，也能减少误改。
- 可能涉及多个项目时，在任务里点名项目与目录。
- 把常用命令写进项目上下文文件，避免每次重新交代。
- 在仓库中工作时，先让 Agent 查看当前分支与状态，再写入文件。
- 把生成产物与真实源码分开，避免 Agent 把派生文件当成修改目标。
工作目录与来源的区别
两者回答的问题不同：工作目录关心眼前这台机器上的本地文件、目录结构和命令执行。
来源关心工作台之外的系统与远端数据，例如问题跟踪平台、文档站点、内部接口以及其他服务。
| 维度 | 工作目录 | 来源 |
|---|---|---|
| 访问方式 | 直接使用内置工具（读取、写入、命令） | 通过来源提供的 MCP 工具调用外部服务 |
| 范围 | 默认从选定目录解析路径；不构成访问边界 | 多个服务与路径 |
| 认证 | 不需要额外凭据 | 按服务提供 OAuth、API Key 或令牌 |
| 权限控制 | 会话权限模式与操作系统权限；Guarded 另需启用决策层 | 按来源单独配置的规则 |
| 项目上下文 | 目录内的 AGENTS.md 或 CLAUDE.md | 来源自带的说明文件 |
| 典型用途 | 编码与本地文件 | 外部服务与远程数据 |
各自适用什么场景
- 工作目录适合：编写与修改代码、运行构建脚本和测试、commit/branch/diff 等 Git 操作、阅读项目文件与配置，以及一切涉及本地文件的任务。
- 来源适合：访问外部服务、读取远程接口的数据、对接其他系统中的资料，以及任何需要外部服务凭据的任务。
- 两者配合最常见：从问题跟踪平台取回 issue，再在工作目录里修复。
- 从文档接口读取说明，再在工作目录里写实现；从数据库取数，再在本地生成报告。
最佳实践
- 保持项目上下文文件是最新的：它是 Agent 最先读到的内容，也是解释结构与命令最省事的方式。
- 指向具体的项目目录，而不是主目录：Agent 的关注范围更集中，任务也更容易推进到完成。
- 用好 Git 上下文：在仓库中 Agent 能看到当前分支，写文件前让它先查看状态与差异。
- 与本地文件夹配合：主项目设为工作目录，偶尔要用的其他目录通过本地文件来源加入。