Agent Skills
返回列表
工作区扁平输出

工作区扁平输出

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 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 工作区的平台工程师,需要强制约定文件落盘位置,减少递归扫描和路径漂移
  • 写脚本做数据汇总的分析师,希望输出文件按固定规则命名,同名时不覆盖已有结果