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

扁平工作区输出

IT 运维与安全 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_4db871a2/workspace-flat-output。

技能介绍

问题:输出文件一旦进子目录,就容易失控

当 Agent 在工作目录里生成 analysis.txt、results.json、日志或导出文件时,很容易顺手创建 analysis/、temp/ 这类子目录。短期看只是多了几层路径,长期看会让后续定位文件、批量清理、回写结果变得麻烦:你不确定哪个文件已经落盘,也不确定同名产物到底藏在哪一层目录里。

这个技能要解决的不是“整理得好看”,而是把输出位置收敛到一个可预测的根路径:/home/node/.openclaw/workspace/。所有文件都作为扁平文件放在这里,不再依赖目录层级表达语义。

核心行为

  • 固定根路径:生成文件或保存输出时,目标路径始终以 /home/node/.openclaw/workspace/ 开头。
  • 禁止子目录:不要把 analysis/report.txt、temp/data.json 这类中间目录拼进目标路径。
  • 冲突可扩展:如果文件名冲突,在基础名称后追加 _1、_2 等后缀,而不是新建目录隔离同名文件。

关键步骤

  1. 写入前先构造完整目标路径,例如 /home/node/.openclaw/workspace/analysis.txt。
  2. 让文件名承载语义,例如 results.json 表示最终结果,debug.log 表示调试输出。
  3. 写入时检查根目录是否已有同名文件;冲突则改写为 analysis_1.txt、results_2.json。

适用边界与注意点

  • 它约束的是输出落点,不负责文件内容组织。如果数据本身需要层级,应该在内容结构里表达,而不是用目录树。
  • 文件名需要足够具体。data.json 在高频任务里很容易冲突,后续会不断长出 data_1.json、data_2.json。
  • 清理任务可以更直接地扫描根目录,但仍应避免误删不属于输出目录的文件。

使用场景

  • 在Linux服务器上部署自动化脚本,需要将运行日志、错误记录和最终结果全部平铺输出到 /home/node/.openclaw/workspace 下,方便通过单一路径快速检索。
  • 批量生成JSON格式的测试报告,要求所有报告文件直接存放在工作目录根路径下,禁止创建 subfolders,避免因多层目录导致文件路径过长或难以定位。
  • 在CI/CD流水线中执行数据导出任务,需确保每次构建的产物都以扁平结构存放于指定工作区,并通过追加 _1、_2 后缀解决同名文件覆盖问题。
  • 开发Agent工具时需要规范输出行为,确保所有临时文件、配置文件和结果文件都直接写入 /home/node/.openclaw/workspace,不产生任何中间子目录。

适合人员

  • 运维工程师:需要在多台Linux服务器上部署自动化脚本,确保输出文件路径统一且可预测。
  • 后端开发者:开发Agent或自动化工具时需要规范输出行为,避免因目录嵌套导致的文件管理混乱。
  • CI/CD流水线维护者:在持续集成环境中批量生成报告和日志,要求输出路径扁平化以简化后续归档。
  • 数据工程师:处理大量JSON格式输出时需要确保文件命名冲突自动解决,无需手动创建子目录。