list-directory

list-directory 技能為代理程式提供了與本機或容器化檔案系統互動的基礎機制。它專為需要檢視工作空間的任務而設計，例如識別專案相依性、定位原始程式檔，或確認檔案建立與下載等前置作業是否執行成功。透過提供包含檔案名稱、類型、大小及最後修改時間的結構化元資料，此技能使代理程式能夠針對後續操作做出明智決策。

• 檔案與目錄探索：在代理程式沙盒環境中，對任何可存取的路徑進行目錄內容檢視。

• 元資料擷取：精確獲取檔案屬性，如大小與最後修改時間，協助代理程式追蹤變更或識別最新版本的檔案。

• 情境化工作空間導覽：對於多代理程式協作流程至關重要，代理程式可在執行建置自動化、批次處理或資料解析等複雜任務前，審核檔案系統狀態。

• 安全優先整合：在 OpenAkita 的多層沙盒框架內運作，確保目錄列出僅限於授權路徑，防止未經授權的系統全域遍歷。

• 使用說明：傳遞有效的字串路徑作為主要參數。使用 '.' 表示當前目錄，或提供絕對/相對路徑以探索其他區域。

• 最佳實踐：在嘗試執行 read-file 或 write-file 操作前，請務必先使用此技能驗證檔案是否存在，以避免執行時期錯誤。處理大型目錄時，請注意返回大量元資料可能會影響代理程式的記憶體使用量。此技能是檔案密集型任務的先決條件，並能與搜尋、讀取與寫入檔案等工具無縫整合，構成完整的檔案管理流水線。