Copedal

文件与工作区

工作区清爽

过程文件与交付文件分开,发出去的文件夹就是那个。

免费 免费阅读,也可以邮件索要技能文件。

workspace-hygiene 150 行 · 11 KB

背景描述

一个文件该不该留,由「谁在什么时候打开它」决定,不由它有多难做决定。

给你自己复现用的,进 work/;给用户拿走用的,进 outputs/<日期>-<主题>/;两者不许混。

适用范围:Codex、Claude Code、dsh 等任何会在会话目录里产文件的智能体。应用自动生成的会话目录(如 new-chat-3)不要改名——路径是应用识别会话的依据;清爽发生在会话内部(work/ 与 outputs/)和文件交出去的那一刻。

为什么这么做

留不留由「谁在什么时候打开它」决定,所以先分区再命名:work/ 随会话失效,可以整体删掉;outputs/YYYYMMDD-主题/ 是用户长期持有的那一份。会话根目录只留配置文件,其余文件必须归入两区之一。四问按顺序问,四个「是」才准进 outputs,拿不准退回 work/。过程件丢了能重做,截图混进交付夹会长期拖累用户找文件。

命名公式三段必填、三个按需段,唯一性阶梯从上往下问、命中即停:日期、主题、类型之后,才按需加序号、渠道或画幅、-vN。验收靠两个动作:文件单独发到微信,只看名字能说出哪一期什么规格;同目录任取两个并排,不打开能分清。tidy_check.py 只读不改文件,复检退出码 0 才算收尾,报错就改到它归零。

真实踩坑

  • 微信里三条同名成片 多集或多平台只交一份同名文件,聊天窗口里并排三条成片.mp4,分不清哪条是哪条。阶梯要求在加渠道之前先加序号(EP01、P02),脱夹测试就是防它:文件离开文件夹后,名字还得说得出哪一期、什么规格。
  • outputs 根目录躺着散文件 实测某个会话 16 个文件全铺在 outputs 根目录,找主文件只能一条条翻。门禁规定根目录只留 INDEX.md,散文件逐条报出,报不完就收不了尾,找文件的人只能挨个打开看。
  • 会话叫 new-chat 就找不回 放任会话目录叫 new-chat,事后按名字找不到它。一次清点里 61 个会话有 33 个属于这一类,35 个交付夹只有 10 个带日期前缀。清爽做在会话内部,应用生成的目录名不动,路径是应用识别会话的依据。
  • 调试脚本混进交付夹 截图、调试脚本、日志、抽帧看着像产物,其实全是过程件。它们进了交付夹,用户就得在三十个文件里挑一个。第四道门禁把 work/ 挡在交付之外,四问里有一问答不上「是」,文件就退回 work/。

这个技能里有什么

  1. 0. 一句话原则
  2. 1. 三分区
  3. 2. 交付四问(判定闸门)
  4. 3. 命名公式(三段必填 + 三个按需段)
  5. 4. 一次交付的动作序列(3–5 分钟)
  6. 5. 硬门禁(五条)
  7. 6. 反模式(本机实测)
  8. 7. 与其他技能的分工
  9. 8. 需要细节时

目录就是技能文件自己的标题,顺序没有动过。

用法描述

会话工作区清爽:把过程文件(可随时删除)与交付文件(用户要拿走的)分开, 交付一律落在 outputs/YYYYMMDD-主题关键词/ 文件夹(公众号/小红书/抖音素材除外,走平台目录), 文件同口径命名,并维护 INDEX.md 与 00-交付说明.md。用于「文件太乱」「整理文件夹」「交付放哪」 「命名规范」「收尾清理」「outputs 里都是散的」「打包发给用户」; 不负责项目内版本堆积、成本账与授权账(那属于 asset-management)。

怎么用

  1. 用邮箱收这个文件,它就是一个 SKILL.md。
  2. 放进 agent 读取的技能目录,目录名用 workspace-hygiene。
  3. 用描述里的触发句开头,或直接点名这个技能。

技能文件改成邮件发送,不再给下载链接。已登录就发到账号邮箱,没登录就留一个地址。