list-directory

list-directory 技能为代理程序提供了与本地或容器化文件系统交互的基础机制。它专为需要查看工作空间的任务而设计，例如识别项目依赖、定位源代码文件，或确认文件创建与下载等前置作业是否执行成功。通过提供包含文件名、类型、大小及最后修改时间等结构化元数据，此技能使代理程序能够针对后续操作做出明智决策。

• 文件与目录探索：在代理程序沙盒环境中，对任何可访问的路径进行目录内容查看。

• 元数据获取：精确获取文件属性，如大小与最后修改时间，协助代理程序追踪变更或识别最新版本的文件。

• 情境化工作空间导航：对于多代理程序协作流程至关重要，代理程序可在执行构建自动化、批处理或数据解析等复杂任务前，审计文件系统状态。

• 安全优先整合：在 OpenAkita 的多层沙盒框架内运作，确保目录列出仅限于授权路径，防止未经授权的系统全局遍历。

• 使用说明：传递有效的字符串路径作为主要参数。使用 '.' 表示当前目录，或提供绝对/相对路径以探索其他区域。

• 最佳实践：在尝试执行 read-file 或 write-file 操作前，请务必先使用此技能验证文件是否存在，以避免运行时错误。处理大型目录时，请注意返回大量元数据可能会影响代理程序的内存使用量。此技能是文件密集型任务的先决条件，并能与搜索、读取与写入文件等工具无缝集成，构成完整的文件管理流水线。