Agent Skills
返回列表
工作区只读文件浏览器

工作区只读文件浏览器

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @zcwl/file-browser-2。

技能介绍

要解决的问题

在 Agent 里让模型「看仓库」时,若直接放开 exec 或绝对路径,很容易出现路径逃逸、误读二进制大文件,或在错误目录里乱翻。你需要的是:固定根目录、相对路径、只读,并把结果收成结构化 JSON,便于在对话里继续推理。

技能如何工作

技能约定工作区根为 WORKSPACE(资料中的 OpenClaw / skill-platform workspace),所有路径都相对该根解析;输入会先清洗,拒绝绝对路径与越界访问。

  • 列目录:exec("scripts/list_files.sh", [rel_path]),返回 {success, data, error},data 为条目名数组。
  • 读文件:exec("scripts/read_file.sh", [rel_path]),data 为文本内容;非文本、过大或无法按文本读取时走 error。
  • 流程:从用户意图解析 list / read 与相对路径 → 调对应脚本 → 解析 JSON → 用自然语言反馈;空路径默认 "."(工作区根)。

安全上强制只读:不写、不删、不执行用户自定义命令;verbose 时可记录访问;超大文本(>10k 字符)可截断或摘要。

适用边界与注意点

  • 仅适用于 POSIX 风格 工作区内的 文本浏览;Windows / macOS / Linux 可用,但非 POSIX 文件系统可能有差异。
  • 不支持写入、删除或任意 shell;不适合替代 IDE 全文检索或 Git 历史分析。
  • 性能受单次脚本执行与文件大小限制影响,不适合高并发批量拉取超大目录树。

使用场景

  • 在 Cursor/Codex 会话里先列出 `src/` 下有哪些模块,再决定让模型读哪一个配置文件
  • 用户说「读一下 SKILL.md 前几段」时,用相对路径在工作区内取文本给模型总结
  • 排查 Agent 生成的补丁前,快速浏览 workspace 根目录结构,确认脚本与资源是否在预期位置
  • verbose 调试时按访问日志核对模型是否只在允许目录内 list/read

适合人员

  • 每天在 Agent 里改 monorepo、需要让模型先看目录再读单个文件的工程师
  • 编写 SKILL.md 指令、要在固定 workspace 里演示 list/read 工作流的技能作者
  • 运维用 OpenClaw 工作区跑自动化任务、要求路径不能越界的安全审查同学
  • 教新人用 CLI Agent 读项目文档、但不想开放任意 shell 的技术导师