扁平工作区输出
将以下提示词粘贴到你的 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等后缀,而不是新建目录隔离同名文件。
关键步骤
- 写入前先构造完整目标路径,例如
/home/node/.openclaw/workspace/analysis.txt。 - 让文件名承载语义,例如
results.json表示最终结果,debug.log表示调试输出。 - 写入时检查根目录是否已有同名文件;冲突则改写为
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格式输出时需要确保文件命名冲突自动解决,无需手动创建子目录。