技能介绍

要解决什么问题

设计交付里常见场景是：同一份 PSD 模板要按表格批量换字、出 PSD 和 PNG，还要在上线前确认图层映射、字体和文字是否会截断。手工在 Photoshop 里逐条改图层，既慢又难复现，也缺少可机器读取的验收依据。

技能如何工作

本技能面向生产级批量生成，路径一律相对 SKILL.md 所在目录解析，避免写死本机绝对路径。推荐走统一 CLI，而不是散落脚本。

典型流程：

diagnose --json：检查 Python 依赖、字体、模板、可选 OCR/LLM 配置是否就绪。
analyze：对 PSD 与可选 Excel/CSV 做图层与列映射分析，关注 mapping、capacity_risks、字体匹配及 warnings/errors。
preview：全量导出前先看 out/dryrun_preview/ 与 JSON 报告。
export：生成 out/psd/、out/png/ 与 out/verify_report/report.json；替换文案默认保留 PSD 文本图层原色，仅当用户明确要求统一色时才传 --color R G B。
verify：输出被移动或单独抽检时再次校验。

内置模板 ID（morning、tech、doodle）可代替直接传 PSD 路径。主命令均支持 --json / --json-out，报告字段含 status、layers、mapping、capacity_risks、fonts、outputs、warnings、errors、runtime_sec；退出码 0～4 语义稳定。生产批次可加 --strict：低置信度列匹配、容量溢出或缺字体会阻断导出。

适用边界与注意点

低置信度映射、文字超长、capacity_risks 在生产环境应视为硬风险，而非仅看 warnings。
兼容旧入口时仍可用 scripts/psd_batch.py，但新流程更依赖结构化报告与稳定退出码。
模板可编辑字段见 references/templates.json；不同 Agent 运行时校验方式见 references/runtime-compat.md。