用途:为 AI 智能体提供文件系统操作能力,覆盖列表、搜索、批量复制与目录分析,适配 Clawdbot;在 OpenSquilla 中调用时应使用宿主提供的文件系统工具,不安装 clawdbot-filesystem、不调用 ClawHub,也不假设存在独立二进制。
主要能力:列表支持按类型、模式、大小、日期过滤,递归遍历并控制深度,可输出表格、树形或 JSON,支持按名称、大小、日期、类型排序;搜索支持 glob 与正则、全文内容检索、组合文件名与内容条件并显示上下文行;批量复制支持基于模式的安全复制、干运行预览、进度跟踪与错误恢复;目录分析提供 ASCII 树可视化、文件数量与类型统计、空间分布及最大文件识别。
使用方式:常用命令保持原样,如 filesystem list --path ./src --recursive --filter ".js"、filesystem search --pattern "TODO" --path ./src --content、filesystem copy --pattern ".log" --to ./backup/ --dry-run、filesystem tree --path ./ --depth 3、filesystem analyze --path ./logs --stats。安装可执行 cd ~/.clawdbot/skills 后 git clone <filesystem-skill-repo>,或 clawdhub install filesystem,再 chmod +x filesystem/filesystem。可通过 config.json 设置默认路径、最大深度、排除模式、输出格式等。
适用场景与限制:适合开发工作流中的源码查找与 TODO 检索、备份日志,以及系统管理中的大文件定位与临时文件清理。具备路径校验、权限检查、干运行、覆盖前备份提示等安全特性,并可与安全、Git、备份、日志分析等技能集成。限制方面,具体依赖环境与调用方式需遵循宿主约定;资料未提供完整性能基准与兼容范围。