工作区扁平输出
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md 的安装指南,将 @user_4db871a2/workspace-flat-output-wqz 安装到你的 AI 助手中。
技能介绍
要解决的问题
当脚本、Agent 或自动化任务在工作目录下批量产出文件时,最常见的坏习惯是按功能或时间戳随手创建子目录。时间一长,workspace/ 里就会出现 analysis/report.txt、temp/data.json 这类散落目录。这带来三个实际痛点:一是上层工具做文件扫描时需要递归遍历,逻辑变重;二是部署或打包产物时子目录结构容易丢失或错位;三是排查问题时很难一眼看到根目录有哪些文件。
技能如何工作
该技能通过一条硬规则消除目录层级:所有生成的文件必须以扁平形式直接落在 /home/node/.openclaw/workspace 下。具体做法是:
- 固定目标路径:写入时始终使用完整路径
/home/node/.openclaw/workspace/作为前缀,而不是相对路径。 - 禁止中间目录:路径中
workspace与文件名之间不允许出现任何目录段。例如正确写法是/home/node/.openclaw/workspace/analysis.txt,而不是/home/node/.openclaw/workspace/analysis/report.txt。 - 冲突自动兜底:当目标文件名已存在时,在基础名称后追加
_1、_2等后缀,而不是覆盖或报错。
适用边界
- 该规则只约束
/home/node/.openclaw/workspace这一个根路径,其他目录不受限制。 - 由于不允许子目录,无法用目录做语义分组。如果文件数量很多,建议用文件名前缀区分用途。
- 冲突后缀是追加式的,不会做内容合并;同名文件可能产生多个副本,需要下游自行清理。
- 如果上游逻辑本身依赖目录结构(如批量图片、多语言资源),此技能不适用,应改用其他存储策略。
使用场景
- 编写批处理脚本时,需要把多个中间结果直接输出到工作区根目录,方便后续统一扫描
- Agent 工具链把分析结果写入固定路径,避免生成子目录导致部署打包时结构丢失
- 数据导出任务中同名文件冲突时,自动追加 _1/_2 后缀,防止覆盖已有结果
- 构建镜像或打包产物时,要求所有文件平铺在 workspace 下,保持目录结构简单
适合人员
- 维护自动化流水线的后端工程师,希望统一输出路径约定,避免因目录结构导致 CI 打包失败
- 开发命令行工具的个人开发者,希望所有生成文件都平铺在工作区,方便用户直接查看
- 管理 Agent 工作区的平台工程师,需要强制约定文件落盘位置,减少递归扫描和路径漂移
- 写脚本做数据汇总的分析师,希望输出文件按固定规则命名,同名时不覆盖已有结果