Data Engineering Agent 任务目录与治理指南
Studio 任务树是数据工程任务的组织入口。随着任务数量增加，如果没有目录规范，任务会散落在默认目录或个人目录中，后续查找、发布、依赖配置、权限管理和测试清理都会变困难。
任务目录治理的目标是让任务从创建开始就可定位、可维护、可发布、可清理。
目录管理能力
Studio 任务树支持对目录进行以下管理：
- 新建目录
- 重命名目录
- 移动目录
- 删除目录
- 在指定目录下创建任务
任务也可以通过任务树菜单进行打开、复制名称、重命名、移动、复制、删除、添加到任务组等操作。删除前会出现确认提醒。
为什么要治理任务目录
任务目录不只是视觉分类，它会影响后续工程管理：
- 创建任务时能明确落点，避免找不到任务
- 多个任务可以按管道、项目或分层集中管理
- 发布前更容易检查同一链路的任务
- 测试任务可以集中清理，避免污染生产目录
- 生产任务和临时任务可以隔离
- 团队协作时更容易形成统一约定
如果任务一开始就创建在错误目录，后续虽然可以移动，但容易造成依赖、文档和沟通上的混乱。
推荐目录组织方式
| 组织方式 | 适用场景 | 示例 |
|---|---|---|
| 按业务域 | 多业务团队共用工作空间 | |
| 按项目 | 项目制开发或专项交付 | |
| 按数仓分层 | 数仓任务较多 | |
| 按环境 | 测试和生产共存 | |
| 按生命周期 | 临时取数或短期验证 | |
企业内部可以组合使用。例如：
或者：
创建任务前先确认目录
通过 Data Engineering Agent 创建任务时，应在提问中明确目标目录。
推荐提问：
不要只说：
这种提问没有目录信息，任务可能进入当前目录、默认目录或最近使用目录，后续查找和治理都会变困难。
测试任务目录
测试任务应集中放在可清理目录中，例如：
测试任务命名应能看出用途和日期，例如：
测试完成后应及时清理：如果任务已发布先取消发布，确认没有下游依赖，确认不再需要运行记录，再从 Studio UI 删除草稿任务。
生产任务目录
生产任务目录应更稳定，避免频繁重命名和移动。建议目录名称包含业务域或项目名、数仓分层或任务类型，任务命名清晰，必要的依赖关系和上线检查记录也应一并维护。生产任务不要和临时测试任务放在同一目录，否则发布、重跑、下线或批量清理时容易误操作。
目录变更注意事项
重命名目录
重命名前应确认是否有团队成员依赖原目录名称查找任务、是否有文档或工单引用原目录、是否会影响运维定位。
移动目录
移动目录前应确认目录下是否有生产任务、是否有任务组或上下游依赖、移动后是否仍符合业务域和环境规范。
删除目录
删除目录前应确认目录是否为空、是否包含已发布任务、是否包含仍需保留的测试记录、是否有下游任务依赖。删除类操作应在界面中仔细确认，不要把目录清理当成普通整理动作。