文件与工作区
工作区清爽
过程文件与交付文件分开,发出去的文件夹就是那个。
免费 免费阅读,也可以邮件索要技能文件。
背景描述
一个文件该不该留,由「谁在什么时候打开它」决定,不由它有多难做决定。
给你自己复现用的,进 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/。
这个技能里有什么
- 0. 一句话原则
- 1. 三分区
- 2. 交付四问(判定闸门)
- 3. 命名公式(三段必填 + 三个按需段)
- 4. 一次交付的动作序列(3–5 分钟)
- 5. 硬门禁(五条)
- 6. 反模式(本机实测)
- 7. 与其他技能的分工
- 8. 需要细节时
目录就是技能文件自己的标题,顺序没有动过。
用法描述
会话工作区清爽:把过程文件(可随时删除)与交付文件(用户要拿走的)分开, 交付一律落在 outputs/YYYYMMDD-主题关键词/ 文件夹(公众号/小红书/抖音素材除外,走平台目录), 文件同口径命名,并维护 INDEX.md 与 00-交付说明.md。用于「文件太乱」「整理文件夹」「交付放哪」 「命名规范」「收尾清理」「outputs 里都是散的」「打包发给用户」; 不负责项目内版本堆积、成本账与授权账(那属于 asset-management)。
怎么用
- 用邮箱收这个文件,它就是一个
SKILL.md。 - 放进 agent 读取的技能目录,目录名用
workspace-hygiene。 - 用描述里的触发句开头,或直接点名这个技能。
技能文件改成邮件发送,不再给下载链接。已登录就发到账号邮箱,没登录就留一个地址。