Copedal

文件与工作区

交付前核验

说「完成」前跑一遍:命名、尺寸、禁用词、空文件。

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

delivery-preflight 67 行 · 4 KB

背景描述

肉眼看不出 900×383 和 901×383 的差别,也记不住 INDEX 有没有更新。这一关交给脚本,它只做一件事:把「我以为交货了」变成 PASS/FAIL 表。

为什么这么做

900×383 与 901×383 肉眼分不出,INDEX 有没有更新也记不住,所以这一关交给脚本。它只产出一张表,逐项给 PASS、WARN、FAIL;退出码 1 就是有 FAIL,这时不许说完成。七个检查项覆盖命名、尺寸、交付说明、索引、空文件与重复投放,门禁的价值就是把「我以为交了」变成一行能引用的输出,返工时照着重跑。

尺寸判据来自文件名里的用途词,所以命名一错,尺寸这一项直接跳过。这就是命名失败要最先处理的原因,也是把类型设成通用等于没验的原因。修完之后必须重跑一遍,把通过那一行贴出来当证据,因为改名字可能顺手弄丢用途词,重新渲染又可能留下空图。重跑不能省。脚本查规格不查好看,好看的判断归 visual-quality-gate。

真实踩坑

  • 400×400 当成 500×500 交了 尺寸从文件名的用途词取期望值,词写错就整条跳过,次条封面用 400×400 交上去照样出 PASS。所以命名失败排最前面处理;改用通用类型更是把尺寸这条彻底关掉,等于没验。
  • 改完一处没有重跑 改文件名可能顺手删掉要用的用途词,重新渲染又可能留下 0 字节的空图。技能要求每次修完再跑一遍,把结果那一行贴进交付说明,口头说「改好了」不算证据。
  • 素材交了索引没动 文件已经发出去,INDEX.md 里还没有这一批的行,事后从索引里根本找不到。索引这条比的是 mtime,复制和解压都会改时间戳,因此规则额外要求人工扫一眼索引内容,别只信时间。
  • 一批素材两处各一份 同一批文件同时出现在 outputs/ 和平台目录,重复投放会报出来,之后两份都得维护。落位规则规定一批只能存一处;它给的是 WARN,属于发货前的提示,处理掉再交,没必要把整批推倒重来。

这个技能里有什么

  1. 什么时候用
  2. 一条命令
  3. 它查什么
  4. 硬规则
  5. 常见错误
  6. 验收

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

用法描述

交付前(尤其是说「完成」「发你」之前)用它跑一遍机器核验:文件名不合规、尺寸对不上、禁用词、缺交付说明、INDEX 没更新、0 字节、重复投放。用户抱怨「怎么又发错尺寸」「命名太乱」「说了完成却少文件」时也用。

怎么用

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

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