# ecommerce-visual-copywriting

Adopt this skill: https://proskills.md/skills/other/feichanggege-ecommerce-visual-copywriting-skill

Page: https://proskills.md/skills/other/feichanggege-ecommerce-visual-copywriting-skill
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: SKILL.md
size: 39141
sha: 8382fd620ac1ebbe033d497a9019140e53f708f5
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/SKILL.md
truncated: true

```text
---
name: ecommerce-visual-copywriting
description: 将商品资料、包装与资质、目标平台、目标人群和视觉参考转成可执行的电商视觉方案，包括转化策略、Campaign Style Lock、主图/详情页/Listing/A+ Storyboard、图内文案、设计说明、生图 Prompt、证据与合规审查。适用于淘宝、天猫、京东、拼多多、抖音小店、小红书、视频号/微信小店，以及 Amazon、Shopify、TikTok Shop、Temu、Shopee、Lazada；用户需要商品图、详情页、图内文案、设计师执行稿或跨境商品本地化时使用。不适用于纯短视频/直播话术、投放与店铺运营优化、需律师出具的最终法律结论（可做风险筛查）；不自动上架或发布。不得编造资质、数据、销量、评价、认证或功效；涉及当前平台规则或高风险合规结论时核验官方来源。
---

# 电商视觉策划与执行

把“原始商品资料”转成“可直接交给设计师或生图模型执行”的视觉方案。默认中文；用户要求英文或双语时切换语言，但不改变证据边界和合规边界。

## 运行原则

1. **自审过线才交付**：最终稿交付前必须完成 Step 6 的五维自审，五项**每项都要 ≥80 分**；任一项不到 80 就先重写，不得把未过线的稿当最终稿交出。自审在同一次回复内完成，不是暂停点，不能因“一次性”“不要中途确认”而省略；交付时附《自审记录》。
2. **证据与法律分别核对**：商品事实以用户提供的包装、参数、资质、检测、品牌资料为起点；适用法律的强制要求不可被资料或用户要求覆盖。事实有依据不等于允许用于广告，不能靠假设补齐产品事实。
3. **按任务路由**：只交付用户需要的层级，不强制走完整流程；不要为了“流程完整”重复追问已知信息。
4. **不把假设写成事实**：缺资料时标记“待确认”，不要补造销量、评价、证书、检测、专利、资质、功效、排名或平台规则。
5. **先统一视觉，再写细节**：同一套图必须先锁定产品身份、构图、色彩、光影、字体、背景和禁止漂移项。
6. **平台规则有时效性**：涉及当前尺寸、禁限词、类目政策、主图要求、资质或审核规则时，优先查官方最新来源；无法核验时明确标记“未核验”，不要凭旧规则下结论。
7. **高风险合规不做最终法律结论**：食品、保健品、医疗器械、健康护理、儿童用品等场景，按保守口径处理，并说明需要以目标市场法律、监管和平台最新规则为准。

## 执行模式

根据用户意图自动选择，不要机械暂停（自审不算暂停，任何模式都必须完成）。开工问卷（见 Step 0）不算检查点：偏好项选填、只发一轮，可按默认假设继续；商品名称缺失时仍须先解决命名，不把沉默或“跳过问卷”当成据图命名授权。

**统一格式**：任何模式输出完整方案或正式审查报告前，必须读取 `references/output-contracts.md`；标准模式的完整策略/分镜也适用。简短局部改词无需加载整份模板。

### A. 标准模式

适用于缺关键证据、方向不清，或用户明确要求“先策划/先分镜/确认后再做”。

1. 输出《视觉策略与证据账本》，一起列明缺口。
2. 再输出可支持的 Storyboard；缺资料的部分标为待定，不虚构分镜细节。
3. 商品名称的前置确认完成后，**只在 Storyboard 后停一次**，合并必要补证与方向确认；确认后直接进入执行稿和质量门，不再逐张确认。

### B. 一次性交付模式

商品名称已明确或用户已授权据图命名后，用户明确说“直接出完整方案”“一次性给我”“按你判断做完”“不用问”时，跳过开工问卷，直接完成策略、Storyboard、执行稿和质量门，仅展示层缺口用默认假设标注，产品事实不假设。仅因资料足够而判为本模式时，仍先走一次开工问卷（只问缺失维度），用户回复或跳过后一次完成，不做不必要的中途确认；自审仍必须完成。

### C. 审查/改稿模式

用户已经有主图、详情页、文案、Prompt 或设计稿时，不从零重做。先找出问题，再给最小必要修改：

- 转化逻辑问题
- 视觉层级问题
- 证据或合规问题
- 平台适配问题
- 文案与画面不一致
- 风格漂移

### D. 设计师交接模式

用户需要“给设计师开工”的执行稿时，直接使用 `references/output-contracts.md` 的结构化交付格式。

### 模式默认值（用户没有明确说时）

用户明确指定的模式、先后顺序与确认要求优先；未指定时按下列顺序判断，命中即停：

1. 已有待审/待改的主图、详情页、文案或 Prompt 成品 → **C 审查/改稿**；产品原图、包装图作为输入资料不自动触发审查。
2. 要交给设计师或运营直接使用的执行稿 → **D 设计师交接**。
3. 产品、平台/市场、人群、必要素材与证据足以支持本次范围 → **B 一次性交付**；不为凑数量强求三条卖点。
4. 缺关键证据、平台/人群不清或方向需确认 → **A 标准模式**，只在 Storyboard 后合并确认一次。

用一句话说明当前模式。明确要求一次性交付或交接但资料有缺口时，完成可支持部分并在稿外列阻断项；不伪造事实，也不把缺口包装成已完成。

开工问卷适用于 A、B、D；C 只问与改稿相关的维度（平台、风格、必须保留项）。用户说“不用问/直接做”，或相关维度已在消息和资料中明确时，跳过。

## Step 0：任务路由与最小输入

先判断用户要的是哪一类产出：

- 主图 / 商品图
- 详情页 / PDP
- Amazon Listing / A+ / Brand Story
- 广告素材 / 短视频封面
- 图内文案
- Storyboard / 图片规划
- 生图 Prompt
- 合规审查 / 改稿
- 跨境本地化

优先获取以下信息：产品是什么、目标平台/市场、目标人群、核心卖点与参数、可用证据、已有视觉资料/参考图。

### 开始前确认商品名称

- 用户已提供商品名或可直接使用的明确品类名称时，记录并沿用；不因缺品牌/系列名重复询问，不擅自替换原名。
- **未提供商品名称且未授权据图命名时，在策略/Storyboard前先询问**：“这款商品叫什么？你可以提供名称，也可以让我根据图片拟一个。”图像清楚时可同时给1–2个候选名，标明“据图拟名，待确认”；图像无法辨认品类时先问品类，不盲猜。
- 用户选择自行提供名称时等待其回复；选择由Agent据图命名时，按“可见款式/形态 + 通用品类”拟一个清楚名称，记录“据图拟名，非官方原名”后继续，不再强制第二次确认。用户一开始已明确授权据图命名时直接执行，无需重复问。拟名不添加未证实的材质、工艺、功能、产地或品牌；候选名不能写成已确认原名。
- 名称问题须得到回答或命名授权后再出正式策略/执行卡；等待期间可整理可见事实与资料缺口。该前置询问适用于所有模式，不占用标准模式在Storyboard后的方向/补证确认；不要把缺名问题拖到分镜后。

### 开工问卷（选填，不答也能做）

商品名称已提供或据图命名已获授权后，开工前先发**一次**偏好问卷，把做图的维度问全；缺名问题可与本轮合并，但须明确为必需回答或授权。回答越完整，方案越贴合；用户不答、只回“跳过/直接做”或直接补资料，就按“默认假设”继续做图，不再追问，也不因此放宽证据与合规边界。

- 只问消息和资料里**还没有**的维度，已知的不重复问；同一项目已有上下文时沿用。
- 一次发完，偏好项全部选填，每项写出默认假设；用户可以只回编号，如“1 淘宝　3 25–35岁女性　其余默认”。
- 环境有选项式提问工具时，平台、风格、范围等选择题用它；否则用编号文字。问卷模板见 `references/output-contracts.md`。
- 只发一轮。命名已解决后，用户回复无论完整与否都进入执行，不就同一偏好维度再追问；会阻断合规或产品身份的缺口（如缺资质原件、产品原图）在稿外列出，不再发第二轮问卷。
- 默认假设要在方案里显式标注。

| # | 维度 | 问什么 | 不答时的默认假设 |
|---|---|---|---|
| 1 | 平台/市场 | 淘宝/天猫、京东、拼多多、抖音小店、小红书、视频号、Amazon、Shopify…… | 资料能推断就用；否则按淘宝/天猫主图 |
| 2 | 产出范围 | 主图几张、详情页、Listing/A+，是否都要生图 Prompt | 主图约 5 张，每张含执行卡和 Prompt |
| 3 | 人群与场景 | 谁买、在哪用、什么时候用 | 从资料推断，标为假设 |
| 4 | 核心卖点 | 最想主打的 1–3 点，哪些有资质、检测或参数支撑 | 按资料提炼 Top 3 |
| 5 | 风格与调性 | 高级简约、种草生活感、促销直给、国风、科技感等；有无参考图或竞品 | 按品类和平台惯例选定 |
| 6 | 价格与促销 | 价格定位；有无活动、赠品、组合 | 不做价格和促销表达 |
| 7 | 必须保留/禁止 | 品牌色、Logo、不可改的结构、禁用词、不想出现的元素 | 以产品原图为准，用默认 Negative Constraints |
| 8 | 图内文字 | 后期叠字、完全不新增文字，还是让模型直接出短标题 | 留白排版，不让模型出字 |
| 9 | 参考资料 | 产品图、包装图、商机/竞品分析、品牌手册 | 只按文字描述，不臆造外观 |

用户口述的卖点按“用户口述”记入证据账本：没有原件或检测佐证的，状态仍是待补证，不因为被问到、被回答就升级为已确认。

### 参考资料先提炼成硬约束

用户给了商机分析、竞品参考、品牌资料或他人素材时，动笔前先提炼有依据的关键硬约束：目标人群、必须强调的差异、必须避开的做法、可借鉴的结构。通常3–5条，资料少则不凑数，并在方案里列出。学结构（句式、信息层级、模块分工），不学表皮（语言、装饰元素、配色）；不移植他人的事实、数据和承诺。读完资料却看不出哪里用上了，算失败。

上述不照抄的限制针对竞品/他人素材；用户明确要求保留的自有品牌色和授权视觉参考，仍按 Reference Fidelity 执行。

除名称前置确认、产品资料明显冲突的核对，以及标准模式在Storyboard后的补证/方向确认外，不再临时追问偏好。问卷后仍缺的展示层信息采用合理假设继续并显式标注；缺失内容会改变产品身份或合规边界时，在稿外列出缺口，不假设产品事实。

## Step 1：建立证据账本

任何会进入最终页面的事实型、数据型、效果型或资质型宣称，先放入证据账本。

| 宣称/卖点 | 来源 | 状态 | 最终处理 |
|---|---|---|---|
| 包装或资料直接支持，且已核对对象/适用范围 | 包装图、参数表等具体材料 | 已确认 | 可使用，保持原意；口述不等于检测/认证证明 |
| 可由参数直接推导 | 用户资料 | 有依据 | 可转成利益表达，但不扩大 |
| 需要检测/认证/平台规则支持 | 缺少证据 | 待补证 | 改中性表达，或整项删除并列入稿外待确认清单 |
| 涉及治疗、保证性效果、虚构背书 | 无合法依据 | 禁止 | 不进入最终稿 |

最终稿只能使用“已确认”或“有依据”的内容。“待补证”必须转为中性表达，或整项删除并列入稿外待确认清单。

来源写明文件/页码、图号或官方 URL，以及适用 SKU、市场、条件和必要日期。仅有示例成图时，能确认画面长什么样；不能据此确认图中的产地、认证、规格或商业宣称。缺口只写在稿外的待确认清单，不进入图内文案和执行卡的文案字段。

仅口述、未见原件时如实记录来源，不写成“已核对材料”。结构或材质的存在不直接证明性能：例如“有脚垫”不能扩成“稳固摆放”“防滑”，除非另有对应依据；称为“中性场景描述”也不能免除补证。

推断不等于事实。来源分四类：凭证（检测报告、证书、官方文件）、供应商口径、视觉观察、推测。只有凭证，以及已与参数或实物交叉验证的供应商口径，能进入成品；视觉观察和推测只写在稿外备注。商家卖点与实物冲突时，以实物为准并回问。材质、镀层、合成、处理等属性按资料写规范全称并保留限定词，不用更短的行业口语替代。规格区和参数表只放“已确认”的数据。

以上限制针对事实宣称，不取消Step 0的授权据图拟名：可见形态加品类组成的工作名称可用于KV1，内部仍标明“据图拟名，非官方原名”；名称不证明材质、工艺、性能或资质，不把观察升级为凭证。

## Step 2：判断成交驱动力

不要默认所有产品都用同一套“痛点文案”。从下列类型中选 1 个主驱动力 + 最多 1 个辅驱动力：

| 驱动力 | 典型场景 | 视觉重点 |
|---|---|---|
| 视觉/质感 | 美妆、饰品、家居、礼盒 | 材质、光影、比例、包装、氛围 |
| 痛点/效率 | 清洁、收纳、工具、生活用品 | 问题场景、使用前后、步骤缩短 |
| 理性/参数 | 3C、家电、设备、功能型商品 | 参数翻译、机制、规格、兼容性 |
| 信任/证据 | 食品、茶饮、母婴、高客单商品 | 产地、工艺、资质、检测、品牌证据 |
| 情绪/身份 | 香氛、服饰、礼赠、宠物、生活方式 | 场景、审美、仪式感、身份认同 |
| 价格/组合/促销 | 拼多多、Temu、抖音小店、套装与补充装 | 到手内容、单件/组合价、优惠条件、活动时间 |

然后把卖点做成：`Feature -> Advantage -> Benefit -> Evidence`。

只保留本次范围内最多 3 条有依据的购买理由（Top 3），不足三条不凑数。没有证据支撑的“猛卖点”不因为转化需要而放宽边界。

价格驱动需核对币种、SKU、数量、单价/组合总价、优惠门槛、适用人群、起止时间和运费；缺依据时只展示已知组合，不造原价、折扣、最低价、库存或倒计时。

## Step 3：锁定 Campaign Style Lock

至少明确：

- **产品身份**：包装文字、Logo、颜色、比例、结构、材质、关键细节必须保持什么不变。
- **构图体系**：主体占比、视角、留白、视线流向、是否允许人物/道具。
- **色彩体系**：主色、辅助色、强调色；避免无理由漂移。
- **光影体系**：自然光、棚拍、硬光、柔光、轮廓光等。
- **字体与信息密度**：标题、数字、说明层级；移动端优先可读。
- **背景与场景**：纯底、棚拍、真实场景、品牌氛围。
- **Reference Fidelity**：有参考图时，列出必须保留与允许变化的元素。
- **Negative Constraints**：禁止新增的 Logo、配件、纹理、人物特征、结构、功效符号或不真实细节。

如果用户上传了产品图或包装图，必须先以图中真实产品为准，不得为了“更好看”擅自改包装结构、Logo、口味、规格或配件。

## Step 4：规划 Storyboard

不要把“5 张主图”当成死规则。默认可用 5 张作为起点，但应根据平台、用户要求和信息量调整。

常见主图任务：

| 角色 | 任务 |
|---|---|
| Hero / KV1 | 首先认出是什么商品；购买理由放第二层，可省略 |
| Benefit | 把核心参数或功能翻译成用户收益 |
| Proof | 用真实证据建立信任 |
| Compare | 用客观维度降低选择成本，不虚构竞品数据 |
| Scene | 放入真实使用场景，强化代入 |
| Spec / CTA | 规格、组合、适用条件或下一步决策信息 |

### KV1商品识别：先说商品，再说特性

商品图首张的第一任务是回答“这是什么商品”，信息顺序为 **商品身份 → 识别性款式/形态 → 至多一个辅助购买理由**。先完成识别，再评价吸引力；不为了写卖点省掉商品名称。

- 使用Step 0确认的名称或用户授权的据图拟名，记录命名来源、通用品类与对应SKU。已知原名清楚且符合字数上限时直接用原名；不要擅自换名。原名过长时保留内部原名映射，图上短名保留品类与关键识别词，不添加材质、功效等未确认事实。
- 允许叠字的KV1，**主标题本身明确写商品名/品类词**，不能只在执行卡名称、证据备注或小字里出现；品牌名、隐喻、场景和特性不能代替“项链、收纳架”等商品词。卖点或情绪句放副文案；仅有商品名也可以，不强加第二个购买理由。
- 原名与据图拟名都先说清商品，隐喻或结构描述不能单独承担首图主标题；有依据时可降为副文案或后续特性图主题。具体品类只作示例，规则适用于所有商品；参见 `examples/README.md`。
- 商品主体的整体关系、关键形态与真实比例要清楚，模特、场景和装饰服务商品识别。颜色选项与套装件数分清，不把金色/银色外观写成材质或两件装。
- 用户要求无新增文字，或对应位置不允许叠字时，不强加标题：用真实商品主体与原包装建立识别，原名记录在执行卡；保留包装真实文字，不伪造标签。说明无字识别依据，实际成图另验。
- **KV1识别自检**：缩到移动端，遮住副文案，只看商品主体和允许出现的主标题，陌生用户能否说出商品品类？需要猜品类即Fail，先改主标题/主体呈现。此规则用于首张商品图；KV2及后续Benefit/细节图可直接讲特性，不要求每张重复原名。

详情页/PDP 常见叙事顺序：

`承接首屏 -> Top Benefits -> 机制/材质/工艺 -> 场景 -> 证据 -> 对比/选择 -> FAQ -> 规格/CTA`

根据商品和平台删减，不强行凑模块。

信息顺序按用户的决策过程排，不按产品构造排：是什么 → 和我有什么关系 → 为何选它 → 凭什么信 → 怎么买。详情页每个模块只解决一个决策问题，按用户疑虑出现的顺序排列。

涉及具体平台时，读取 `references/platform-playbooks.md` 的对应段落；抖音小店与 TikTok Shop 分开，小红书与视频号/微信小店各按对应场景处理。如果用户问的是当前具体审核规则、尺寸、禁词或类目要求，优先核验官方最新规则，并用 `references/source-notes.md` 定位出处。

## Step 5：执行输出

每张图/每个模块至少交付：

1. **视觉任务**：这张图负责解决什么决策问题。
2. **画面描述**：主体、构图、镜头、背景、材质、光影、信息层级。
3. **图内文案**：标题 + 必要副文案；短、具体、可证实，并按下方《图内文案规格》自检。
4. **设计说明**：第一视觉落点、阅读顺序、数字/证据如何突出、免责声明或注释放哪里。
5. **生图 Prompt**：主体 + 构图 + 场景 + 材质 + 光影 + Style Lock + 参考图约束 + 文字渲染方式。
6. **Negative Prompt / 禁止项**：避免包装变形、Logo 错误、文字乱码、结构新增、人物肢体异常、风格漂移等。
7. **证据备注**：如果该图含数据、资质、对比或效果表
```

## File: examples/README.md
size: 8155
sha: 9cdac7c3698a9cbae22a5aee4138cf18e30999e3
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/examples/README.md

````text
# 使用示例

[榴莲样稿教学复盘：一句话输入 → 证据账本 → 单张执行卡 → 成图参考](durian-worked-example.md)。它基于既有图片，不冒充真实运行记录或已核验的商品宣称。

## Example 1：标准模式 — 淘宝收纳用品

用户：

> 帮我给一款厨房台面伸缩收纳架做淘宝主图和详情页。产品是不锈钢材质，可伸缩，承重约 20kg，适合小厨房。先给视觉策划案和分镜，我确认后再继续。

期望行为：

- 识别痛点/效率 + 理性/参数驱动。
- 把“约 20kg”放入证据账本，确认来源后再做精确数字宣称。
- 输出 Campaign Style Lock。
- 先给策略和 Storyboard，不提前堆最终图内文案。

## Example 2：一次性交付 — Amazon 茶叶

用户：

> 这是产品包装、净含量、产地和冲泡资料。面向 Amazon US，直接一次性给我 7 张商品图 + A+ 视觉规划 + 英文图内文案 + 生图 Prompt，不用中途确认。

期望行为：

- 选择一次性交付模式，不强制暂停。
- 先建立证据账本，再做英文本地化。
- 读取平台 Playbook。
- 如果需要判断“Amazon 当前主图能否加字”等具体政策，优先核验官方当前规则；无法核验时标记未核验。
- 输出每张图的视觉任务、画面、英文文案、设计说明、Prompt、Negative Prompt 和证据备注。

## Example 3：普通食品高风险宣称

用户：

> 给一款普通黑芝麻食品做详情页，想写补肾、乌发、防脱发、调理气血，写猛一点。

期望行为：

- 识别普通食品与健康功效宣称风险。
- 不通过“加免责声明”来保留高风险功效。
- 转向原料、风味、配料、工艺、规格、食用场景等可验证价值。
- 明确哪些内容需要目标市场法律和平台最新规则核验。

## Example 4：审查模式 — 已有详情页

用户：

> 我已经有一套详情页，不要重做。帮我检查哪里影响转化、哪里有合规风险，并给最小修改版本。

期望行为：

- 进入审查/改稿模式。
- 先给硬性阻断和高优先级问题。
- 只改需要改的模块，不从零重写整套页面。
- 用五维自审（80 分线）复核并附自审记录。

## Example 5：参考图保真

用户：

> 参考我上传的包装图做一套主图。Logo、包装颜色、规格、罐型不能变，场景可以变化。

期望行为：

- 把包装结构、Logo、颜色、规格列入 Reference Fidelity 的“必须保留”。
- 场景、道具、镜头和光影列入“允许变化”。
- Prompt 和 Negative Prompt 明确禁止包装变形、文字乱码、Logo 改写和规格变化。

## Example 6：跨境本地化

用户：

> 把这套中文详情页改成 Shopify US 用的英文版，不要直译。

期望行为：

- 保留事实和证据边界。
- 重写购买理由、表达习惯和信息密度。
- 检查单位、文化语境、使用场景和目标市场合规差异。
- 不把中国市场的资质/批准范围自动移植到美国市场。

## Example 7：首图先说商品，保留原始名字

以下是文案层级教学示例，原始商品名由用户确认；不把示例当作材质、颜色选项或套装数量的证据。

| 已确认原名 | 只讲特性的旧主标题 | KV1新主标题 |
|---|---|---|
| 飘带裙摆项链 | 波浪贴着锁骨 | 飘带裙摆项链（6字） |
| 飘带流苏长项链 | 两条流苏，一条长链 | 飘带流苏长项链（7字） |

表中括号是内部字数备注，不上图。两张首图都可只放商品名；有依据的造型或卖点才放第二层，不为凑副文案补写贵金属材质、功效、颜色SKU或两件装。画面先清楚展示真实项链，模特和氛围服务商品识别。

执行卡记录原名、品类“项链”和对应SKU；允许叠字时，原名进入**图内主标题**，不能只写在卡片名称或证据备注里。实际成图按移动端缩略、遮住副文案检查；未看成图时只标“识别策略通过，实际成图待验收”。

用户明确要求无新增文字时保留无字，通过商品主体识别，不伪造包装标签。KV2及后续特性图可以直接讲特性，无需每张重复原名。厨房收纳架等其他品类同样先说清商品。

## Example 8：缺名先咨询，也可授权据图拟名

没有商品名称时，开始就询问：“这款商品叫什么？可以给我名称，也可以让我根据图片拟一个。”偏好问卷可跳过，命名问题须得到回答或授权后再开正式策略/执行卡。用户已给名称或明确要求据图命名时，不重复问。

授权后只用可见形态加品类拟名，并在内部标“据图拟名，非官方原名”；不从外观补造贵金属材质、工艺或功效。拟名是通用流程，不限于项链。

## 自动检查实际输出

`test-prompts.json` 覆盖标准模式、一次性交付、普通食品、最小改稿、保真、本地化、极少资料、竞品、母婴、保健食品、促销条件、明确要求模型出字、设计师交接/PDP三要点、单一卖点的一次性交付，以及国内最高级营销、谐音医疗暗示、引证条件、促销可见条件、法定广告审查和客观操作顺序，另有两个项链原名的KV1、无字首图、KV2特性图和非首饰商品识别，加上缺名开工、授权据图命名、选填问卷、跳过问卷和自审记录，以及无依据卖点不得保留占位的新场景，共31类场景。

- `expected_behavior`：人工审查目标，不由静态脚本冒充行为验证。
- `must_include`：在完整 `response` 中做大小写不敏感匹配；字符串为必含项，字符串数组为“至少命中其中一个”的同义标记组。
- `must_not_include`：只检查独立 `final_copy` 中不得出现的字串，分析/拒绝部分允许引用风险词。
- `must_include_final`（可选）：只在完整的 `final_copy` 中检查必要出处、适用条件或操作步骤；支持同 `must_include` 的同义标记组，不能用分析中的说明满足最终文字要求。
- `final_copy_required`：是否必须有可用的最终文字。资料阻断或仅策略的用例可为空，但必须交完整 response。

逐条将 prompt 交给加载了此 Skill 的 Agent；记录真实完整输出，并把所有可发布文案集中到一个最终稿段落，原样复制到 `final_copy`，不要只挑安全部分。格式如下（仅展示一条记录；实际文件须覆盖选定用例）：

```json
[
  {
    "name": "ordinary_food_claim_boundary",
    "response": "证据账本：功效待补证，不使用补肾、乌发等宣称。最终文字草案：黑芝麻食品",
    "final_copy": "黑芝麻食品"
  }
]
```

```text
python tools/evaluate-prompts.py --responses responses.json
```

默认要求全部31例；只测部分时用 `--cases subset-cases.json`，内容仍遵循同一用例结构。缺失、重复、未知用例，缺必含标记、最终稿含禁用宣称，或最终稿不是完整响应的连续摘录，均返回非零退出码。

国内6个新增用例的重点是：最高级营销、谐音医疗暗示、引证条件、促销可见条件、法定广告审查和正常操作顺序。引证用例中的机构、商品、报告和数据为虚构教学输入，不是真实商品证明。法定审查缺失的用例应不交可发布稿，须人工核对 `final_copy` 为空。

文字断言只能发现约定字串问题，不能证明语义、法律结论、字数排版、产品保真或模型实际出字正确。`final_copy` 是否完整也需人工点验；KV1还须人工检查商品名是否在主标题，而非只在副文案，无字用例的文字层必须为空，后续图不能被强制套用首图规则。工程回归测试使用合成响应验证检查器，不冒充31次真实模型测试。

文案长度可用 `python scripts/count-copy.py "最终标题" "最终要点"` 计算；英文加 `--language en`。该脚本按 Skill 的内部排版计数约定返回长度，不判断平台是否允许该文字，也不代替移动端预览。
````

## File: README.md
size: 19119
sha: d80013e1bf0f39c33907eadc03ea08451a8b0f21
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/README.md

````text
<div align="center">

# 🛒 E-commerce Visual Copywriting

### 电商视觉策划 · 主图 / 详情页 / Listing / A+ · 图内文案 · 生图 Prompt · 合规审查

**把零散商品资料，变成设计师和 AI 都能直接执行的电商视觉方案。**

[![Skill v3](https://img.shields.io/badge/Skill-v3.0-6f42c1)](SKILL.md)
[![Agent Skills](https://img.shields.io/badge/Agent%20Skills-compatible-0969da)](SKILL.md)
[![skills.sh](https://skills.sh/b/feichanggege/ecommerce-visual-copywriting-skill)](https://skills.sh/feichanggege/ecommerce-visual-copywriting-skill)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Verify](https://github.com/feichanggege/ecommerce-visual-copywriting-skill/actions/workflows/verify.yml/badge.svg)](https://github.com/feichanggege/ecommerce-visual-copywriting-skill/actions/workflows/verify.yml)

**中文** · [English](README.en.md)

[30 秒上手](#-30-秒上手) · [它解决什么](#-它解决什么) · [工作流](#-工作流) · [支持平台](#-支持平台) · [效果展示](#-效果展示) · [安全边界](#-安全边界)

</div>

<p align="center">
  <img src="assets/showcase-output.svg" alt="E-commerce Visual Copywriting structured output" width="900">
</p>

图中是基于既有榴莲样稿的教学复盘：一句话输入 → 证据账本 → 单张执行卡 → 成图参考。[查看完整输入、证据与执行卡](examples/durian-worked-example.md)。

它先确认商品身份、建立**证据账本**，再明确购买理由、锁定 **Style Lock**，交付逐图画面、文案、排版说明和 Prompt。

---

## ✨ 它解决什么

普通 AI 做电商视觉，常见问题不是“不会写”，而是：

| 常见问题 | 本 Skill 的处理方式 |
|---|---|
| 直接堆卖点，5 张图说同一件事 | 每张图只解决一个购买决策问题 |
| 参考图越改越不像原产品 | 锁定包装、Logo、结构、规格 |
| “写猛一点”后出现功效、绝对化、虚假证据风险 | 先建证据账本，再做宣称分级 |
| 用户只想改现有详情页，却被从零重做 | 自动进入审查/改稿模式，做最小必要修改 |
| 跨境页面只是中文直译 | 按市场、单位、场景、表达习惯做本地化重写 |
| 平台规则已经变化，AI 仍引用旧经验 | 当前规则需要时优先核验官方最新来源 |
| 输出只有文字，设计师还要二次猜 | 逐图交付画面 + 文案 + 设计说明 + Prompt + 禁止项 |

---

## 🚀 30 秒上手

### 1. 安装

```bash
npx skills add feichanggege/ecommerce-visual-copywriting-skill
```

也支持 [Codex / Claude Code 手动安装、Claude plugin marketplace 与 Claude.ai ZIP 上传](#手动安装)。

### 2. 直接说需求

```text
这是我的产品资料、包装图和竞品参考。
面向 Amazon US，直接给我 7 张商品图 + A+ 视觉规划：
每张包含画面、英文图内文案、设计说明、生图 Prompt 和 Negative Prompt。
不要中途确认，缺失信息请标注假设，不要编造。
```

也可以更简单：

```text
帮我把这个商品做成一套能直接交给设计师的主图和详情页方案。
```

---

## 🧭 工作流

先确认卖的是什么及证据边界，再明确购买理由、锁定画面风格，最后逐张图写出能直接开工的执行稿。首张图先完成商品识别。

| 步骤 | 做什么 | 产出 |
|---|---|---|
| 0 判断任务 | 判断是做主图、详情页还是改稿；缺商品名时先确认由用户给名或授权据图拟名；平台、风格、卖点等偏好只问一轮，可用默认假设 | 任务范围、已知资料、假设与缺口 |
| 1 核实卖点 | 把每条卖点和商品资料逐条对照，标明来源与适用范围 | 证据账本（已确认 / 有依据 / 待补证 / 禁止） |
| 2 找成交理由 | 选1个主驱动力和最多1个辅驱动力 | 成交驱动力、最多3条有依据的购买理由 |
| 3 锁定风格 | 固定产品外观、构图、色彩、光影、字体，避免一套图风格不统一 | Campaign Style Lock |
| 4 规划图片 | KV1先让人认出商品；其余图片各负责一个决策问题，按实际信息量增减 | Storyboard（5张只是起点） |
| 5 逐图出稿 | 写画面、图内文案、排版、生图 Prompt、禁止项与证据 | 逐图执行卡，含文字渲染方式与文案规格自检 |
| 6 交付前自审 | 先查硬性阻断项，再按5个维度以必要条件为锚点打分；任一维度不到80分就重写，最多2轮 | 通过自审的执行稿 + 自审记录；实际成图另行验收 |

> 步骤按本次范围取用：一次性交付不机械暂停；标准模式只在 Storyboard 后合并确认一次；偏好问卷只发一轮、全部选填，说“直接做”可跳过；缺名仍先咨询，已授权据图命名则不重复问；已有待审成品只做必要改稿。没有检查实际成图时，相关验收项标为“待验收”。

### 四种执行模式

| 模式 | 什么时候用 | 行为 |
|---|---|---|
| **标准模式** | 缺关键证据、方向不清、用户要求先确认 | 策略与证据缺口 → Storyboard 后合并确认一次 → 执行 |
| **一次性交付** | 用户明确“直接做完”或资料充分 | 不机械暂停，完整交付 |
| **审查 / 改稿** | 已有主图、详情页、文案、Prompt | 找问题 + 最小必要修改 |
| **设计师交接** | 需要直接开工的执行稿 | 使用固定结构输出逐图任务卡 |

未指定模式时按顺序判断：已有待审成品 → 审查；要给设计师/运营直接用 → 交接；本次范围的资料与必要证据齐全 → 一次性；缺证据或方向不清 → 标准模式。产品原图作为输入资料不自动触发审查，也不强制凑三条卖点。所有完整方案/策略/分镜与正式审查报告都读取同一份 [输出模板](references/output-contracts.md)。

### 新版 v3 核心能力

- **Evidence Ledger / 证据账本**：每条关键卖点标记“已确认 / 有依据 / 待补证 / 禁止”。
- **Reference Fidelity**：明确哪些元素必须保持、哪些可以变化。
- **Negative Prompt**：把包装变形、Logo 错误、规格变化、文字乱码、人物异常等提前写进禁止项。
- **动态图片数量**：5 张只是默认，不再为了凑数硬做 5 张。
- **KV1商品识别优先**：已给名称直接沿用，缺名先咨询用户给名或授权据图拟名；名称清楚且不超字数时直接作主标题，造型和卖点放第二层。遮住副文案仍应能认出商品；后续特性图可直接讲特性。用户要求无新增文字或平台位置不允许叠字时，靠真实商品主体识别。详见[两个原名示例](examples/README.md#example-7首图先说商品保留原始名字)。
- **多平台 Playbook**：国内电商 + Amazon / Shopify / TikTok Shop / Temu / Shopee / Lazada。
- **文字与排版规则**：主图1个标题 + 至多2条副文案 + 至多1个数字/证据标签；PDP模块1个标题 + 至多3条要点。标题≤12汉字/≤6英文词；主图副文案每条≤18汉字/≤10英文词，PDP要点每条≤18汉字/≤12英文词。均为默认建议值，不是平台规定；超限删减或拆图。
- **文字渲染二选一**：每卡选择“留白排版”（默认后期叠字）或“模型出字”（仅明确要求的短文字），并附文案规格自检、逐字验收与回退办法。声明底部可读，重要条件紧邻宣称。
- **六类成交驱动力**：视觉 / 痛点 / 参数 / 信任 / 情绪 / 价格与组合促销；价格需核对 SKU、数量、优惠门槛和活动时间。
- **跨境本地化**：不是直译，重写购买理由、单位、场景和信息密度。
- **硬性阻断 + 80 分自审线**：五维每项以必要条件为锚点，任一维度不到 80 分就重写（最多 2 轮），交付时附《自审记录》；不凭感觉打无锚点的“80/100”。
- **国内广告法文案规则**：主图/详情图先判断品类与允许宣称，再逐卡审查；最高级营销、医疗暗示默认不用。引证出处与必要条件进入可见文字层，不能藏在内部备注或小字中。

---

## 📦 能交付什么

### 视觉策略

- 成交驱动力：视觉 / 痛点 / 参数 / 信任 / 情绪 / 价格与组合促销
- 最多3条有依据的购买理由
- 证据账本
- `Feature → Advantage → Benefit → Evidence`
- Campaign Style Lock
- 缺失信息、假设与风险

### Storyboard

```text
KV1  Hero      → 先认出是什么商品；卖点放第二层，可省略
KV2  Benefit   → 把核心参数翻译成用户收益
KV3  Proof     → 用真实证据建立信任
KV4  Scene     → 让目标用户看到自己的使用场景
KV5  Spec/CTA  → 规格、组合、选择或行动信息
```

> 实际数量按平台和商品调整，不固定 5 张。

### 单张执行卡

每张图可直接交付：

- 视觉任务
- 原始商品名/品类与KV1识别自检（仅首图适用）
- 画面 / 构图 / 镜头 / 光影 / 背景
- 图内文案
- 文字渲染方式、文案规格自检与文字验收/回退办法
- 排版与声明位置
- 第一视觉落点
- 设计说明
- 生图 Prompt
- Negative Prompt / 禁止项
- 证据来源
- 合规 / 平台备注

---

## 🌍 支持平台

| 国内 | 跨境 / DTC |
|---|---|
| 淘宝 / 天猫 | Amazon Listing / A+ / Brand Story |
| 京东 | Shopify / DTC PDP |
| 拼多多 | TikTok Shop |
| 抖音小店 | Temu |
| 小红书商品图 / 笔记封面 | Shopee / Lazada |
| 视频号封面 / 微信小店商品图 | 其他商品详情页场景 |

平台相关内容分成两类处理：

1. **长期稳定的视觉策略**：使用 `references/platform-playbooks.md`。
2. **当前尺寸、主图限制、禁词、资质、审核规则**：需要时优先核验平台官方最新来源，不把旧经验写成现行规则。

抖音小店与 TikTok Shop 使用独立段落，跨境规则按国家/站点核验。[官方来源索引](references/source-notes.md) 区分法规文本、规则入口及登录/访问限制。

---

## 🧪 典型用法

### 先策划再执行

```text
帮我做一套淘宝主图和详情页。
先判断成交驱动力、风格锁和分镜，我确认后再做最终稿。
```

### 一次性完整交付

```text
资料已经齐了，直接一次性做完，不用中途确认。
输出主图、详情页、图内文案、设计说明和生图 Prompt。
```

### 审查已有页面

```text
不要重做。帮我检查这套详情页哪里影响转化、哪里有合规风险，
按优先级给最小修改方案和修正版。
```

### 参考图保真

```text
参考这张包装图做主图。
Logo、包装颜色、规格、罐型不能变，场景和光影可以变化。
```

### 跨境本地化

```text
把这套中文详情页改成 Shopify US 英文版。
不要直译，要按美国用户的购买逻辑重写。
```

更多示例见 [examples/README.md](examples/README.md)。

---

## 🖼 效果展示

<div align="center">
  <table>
    <tr>
      <td align="center" width="50%">
        <a href="assets/showcase/musang-king-durian-main.jpg">
          <img src="assets/showcase/thumbs/musang-king-durian-main-thumb.jpg" alt="榴莲竖图完整预览，保留顶部标题与底部画面" height="360">
        </a><br>
        <strong>高端食品 Hero / 主图</strong>
      </td>
      <td align="center" width="50%">
        <a href="assets/showcase/figure-multi-angle.jpg">
          <img src="assets/showcase/thumbs/figure-multi-angle-thumb.jpg" alt="手办多角度产品视图" width="360" height="360">
        </a><br>
        <strong>多角度产品表达</strong>
      </td>
    </tr>
    <tr>
      <td align="center" width="50%">
        <a href="assets/showcase/figure-desktop-scene.jpg">
          <img src="assets/showcase/thumbs/figure-desktop-scene-thumb.jpg" alt="桌面陈列场景图" width="360" height="360">
        </a><br>
        <strong>真实场景详情模块</strong>
      </td>
      <td align="center" width="50%">
        <a href="assets/showcase/lumina-pendant-lamp.jpg">
          <img src="assets/showcase/thumbs/lumina-pendant-lamp-thumb.jpg" alt="玻璃吊灯质感主图" width="360" height="360">
        </a><br>
        <strong>材质与光影表达</strong>
      </td>
    </tr>
  </table>
</div>

> 展示图用于说明视觉交付形态，不代表对应商品的法律意见、平台审核承诺或商业数据证明。

每张图均≤500KB，榴莲缩略图保留完整竖图比例。当前素材体积已缩减；历史大图仍在 Git 记录，快速获取可使用浅克隆或下载当前源码包。

---

## 🛡 安全边界

这个 Skill **不会**：

- 编造检测报告、认证、专利、批准文号、销量、评价、排名或用户证言。
- 把“待补证”的内容写成确定事实。
- 因为用户要求“更猛”就突破医疗、食品、健康或平台合规边界。
- 用一句免责声明去“洗白”本身不允许的功效宣称。
- 把历史平台经验当成当前平台硬规则。
- 为了视觉效果擅自改错产品包装、Logo、规格或结构。

合规框架见 [references/compliance-rules.md](references/compliance-rules.md)。

面向中国大陆的主图、详情图及局部改稿必读[国内文案执行规则](references/compliance-rules.md#10-国内主图详情图文案执行)。已按广告法、互联网广告办法及绝对化/引证内容指南补充类别限制、排名边界、可读条件与法定广告审查要求；潜在例外放在稿外人工复核，人工同意不能放行法律禁止内容。输出区分“最终文字层”和风险备注，不承诺“广告法认证”或保证过审。[官方出处与本次核验范围](references/source-notes.md)。

---

## 🗂 仓库结构

```text
SKILL.md                          # Canonical runtime entrypoint
SKILL.en.md                       # 完整英文规则，与中文章节对齐
agents/openai.yaml                # ChatGPT UI metadata
references/compliance-rules.md    # 证据与合规框架
references/platform-playbooks.md  # 多平台视觉策略
references/output-contracts.md    # 设计师交付 / 审查 / 本地化模板
references/copy-quality-rules.md  # 文案质量规则与正反例
references/category-notes.md      # 品类补充说明（目前含饰品）
references/source-notes.md        # 官方法规/平台入口与核验范围
examples/README.md                # 典型输入与期望行为
examples/durian-worked-example.md # 榴莲样稿教学复盘
scripts/count-copy.py             # 按最终字串计算文案长度
scripts/scan-final-copy.py        # 扫描终稿占位符与内部说明
assets/showcase/                  # 效果展示
assets/showcase-output.svg        # 结构化输出示意
tools/verify-skill.py             # 发布前结构与隐私检查
tools/evaluate-prompts.py         # 已保存模型输出的文本断言
tools/package-skill.py            # 最小 Skill ZIP
test-prompts.json                 # 31 类提示词与可检查期望
.github/workflows/verify.yml      # GitHub Actions
CHANGELOG.md                      # 已发布与未发布变更
```

---

## ✅ 验证

```bash
python tools/verify-skill.py
python -m unittest discover -s tests -v
```

CI 运行仓库检查、回归测试和最小 ZIP 打包。徽章链接真实 Actions 状态，首次推送工作流后才会产生远端结果；本地 Pass 不代表远端已变绿。

`test-prompts.json` 含 `must_include`、`must_not_include` 和可选的 `must_include_final`。保存 Agent 的实际输出后运行 `python tools/evaluate-prompts.py --responses responses.json`；禁用宣称及必要可见条件检查独立最终文案，允许分析部分引用风险词，但不能只在分析中交代条件。[响应格式与检查边界](examples/README.md#自动检查实际输出)。结构/文本检查不替代语义、合规与实际成图验收。

已存在 [v3.0.0 Release](https://github.com/feichanggege/ecommerce-visual-copywriting-skill/releases/tag/v3.0.0)；本次改动见 [CHANGELOG.md](CHANGELOG.md) 的 Unreleased，不重复创建旧 tag。

---

## 手动安装

macOS / Linux：

```bash
git clone --depth 1 https://github.com/feichanggege/ecommerce-visual-copywriting-skill.git
mkdir -p ~/.codex/skills/ecommerce-visual-copywriting
cp -r ecommerce-visual-copywriting-skill/SKILL.md \
      ecommerce-visual-copywriting-skill/SKILL.en.md \
      ecommerce-visual-copywriting-skill/LICENSE \
      ecommerce-visual-copywriting-skill/agents \
      ecommerce-visual-copywriting-skill/references \
      ecommerce-visual-copywriting-skill/examples \
      ecommerce-visual-copywriting-skill/scripts \
      ~/.codex/skills/ecommerce-visual-copywriting/
```

Windows PowerShell：

```powershell
$ErrorActionPreference = 'Stop'
git clone --depth 1 https://github.com/feichanggege/ecommerce-visual-copywriting-skill.git
New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex\skills\ecommerce-visual-copywriting" | Out-Null
Copy-Item -Recurse ecommerce-visual-copywriting-skill\SKILL.md,ecommerce-visual-copywriting-skill\SKILL.en.md,ecommerce-visual-copywriting-skill\LICENSE,ecommerce-visual-copywriting-skill\agents,ecommerce-visual-copywriting-skill\references,ecommerce-visual-copywriting-skill\examples,ecommerce-visual-copywriting-skill\scripts "$env:USERPROFILE\.codex\skills\ecommerce-visual-copywriting\"
```

### Claude Code

手动安装使用相同文件集合，把上面目标目录换成 `~/.claude/skills/ecommerce-visual-copywriting/`（个人），或项目内 `.claude/skills/ecommerce-visual-copywriting/`。Codex 项目安装可使用项目内 `.codex/skills/ecommerce-visual-copywriting/`。不要只复制 `SKILL.md` 而漏掉 references。

也可以在 Claude Code 中使用仓库自带的 marketplace：

```text
/plugin marketplace add feichanggege/ecommerce-visual-copywriting-skill
/plugin install ecommerce-visual-copywriting@ecommerce-visual-copywriting-skill
```

检查插件列表或重启会话确认加载；发布者可运行 `claude plugin validate .`。本仓库根目录的 `SKILL.md` 由根 Skill 插件机制加载，元数据在 `.claude-plugin/plugin.json`。[官方 Skill 路径](https://code.claude.com/docs/en/skills) · [marketplace 安装说明](https://code.claude.com/docs/en/plugin-marketplaces)。

### Claude.ai 上传 ZIP

在仓库目录生成轻量包：

```text
python tools/package-skill.py --output dist/ecommerce-visual-copywriting.zip
```

ZIP 内只有一层 `ecommerce-visual-copywriting/` Skill 文件夹，包含入口、英文版、agents、references、examples、计数脚本与许可证，不含 `.git`、工程测试或展示原图。按 Claude 当前界面的 **Customize → Skills → 创建/上传 Skill** 上传 ZIP 并启用；账号/组织须开放相应能力及代码执行。[官方上传说明](https://support.claude.com/en/articles/12512180-use-skills-in-claude)。

---

## License

[MIT](LICENSE)

<div align="center">

**首图先认出商品，再逐张讲清购买理由。**

</div>
````

## File: scripts/count-copy.py
size: 754
sha: 7141a6ae65c85131742974d3910e5736b4442809
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/scripts/count-copy.py

```text
#!/usr/bin/env python3
"""Count copy lengths using the skill's internal layout convention, not platform rules."""
import argparse
import json

def count(text: str, language: str) -> int:
    return len(text.split()) if language == "en" else sum(not char.isspace() for char in text)

def main() -> None:
    parser = argparse.ArgumentParser(description=__doc__)
    parser.add_argument("--language", choices=("zh", "en"), default="zh")
    parser.add_argument("texts", nargs="+")
    args = parser.parse_args()
    print(json.dumps([
        {"text": text, "count": count(text, args.language), "unit": "words" if args.language == "en" else "characters"}
        for text in args.texts
    ], ensure_ascii=False))

if __name__ == "__main__":
    main()
```

## File: scripts/scan-final-copy.py
size: 1381
sha: 5c4b3734c311c7336ad9cf00594feeae51577a80
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/scripts/scan-final-copy.py

```text
#!/usr/bin/env python3
"""Flag placeholders and internal notes left in final copy. A lexical check only, not a quality or legal review."""
import argparse
import json
import re
import sys

HARD = {
    "待补/待确认/待核": r"待(?:补证?|确认|定|核实?|核验)",
    "未提供类括注": r"[（(][^）)\n]*(?:未提供|未给出|缺失|待提供)[^）)\n]*[）)]",
    "TODO/TBD": r"\b(?:TODO|TBD|FIXME)\b",
    "空占位": r"【\s*】|\[\s*\]|X{3,}|\?{3,}|？{3,}",
}
SOFT = {
    "内部建议口吻": r"(?:^|[，。；\s])(?:建议|备注|注意)[:：]",
    "此处填写": r"此处(?:填|放|写|补)",
    "暂定/拟定": r"暂(?:定|无|不|未)|拟(?:定|用|补)",
    "含括注，请人工确认不是内部说明": r"[（(][^）)\n]{1,40}[）)]",
}

def scan(text: str) -> dict:
    return {
        "hard": [name for name, pattern in HARD.items() if re.search(pattern, text)],
        "soft": [name for name, pattern in SOFT.items() if re.search(pattern, text)],
    }

def main() -> int:
    parser = argparse.ArgumentParser(description=__doc__)
    parser.add_argument("texts", nargs="+")
    args = parser.parse_args()
    results = [{"text": text, **scan(text)} for text in args.texts]
    print(json.dumps(results, ensure_ascii=False))
    return 1 if any(item["hard"] for item in results) else 0

if __name__ == "__main__":
    sys.exit(main())
```

## File: references/category-notes.md
size: 1834
sha: 3f3e1c69c753bac3caf4b131b93298f382310683
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/references/category-notes.md

```text
# 品类补充说明

## 饰品（项链、手链、耳饰、戒指等）

### 材质与工艺

- 材质、镀层、合成、处理等属性按资料写**规范全称并保留限定词**，不用行业口语简称替代。资料写“镀”就写“镀”，不简化成只剩材质名；资料写明材料全称，就不换成更短的通称。
- 工艺名称（如编织、镶嵌、镂空类的说法）只认商家口径，不由图片纹理推断；商家的工艺说法也要对照实物图核对，冲突以实物为准并回问。

### 尺寸与适配

- 长度、周长、直径要转成佩戴位置或视觉结果，但只用资料里的数据和模特信息：能写“落在哪个位置”，要有资料里的长度和模特参数支撑，没有就回问，不自己编。
- 适配类内容给分档、上限和后果，不写“按自身颈围/手腕对照”。
- 不把别的款式的顾虑搬过来：短款不设只对长款成立的问题。

### 画面与文案

- KV1商品名和必要规格/条件优先保留；其余画面里能看到的结构（几条链、几个吊坠、流苏数量）不在文案里机械复述；文案补佩戴场合、动态、触感、搭配。
- 搭配展示图里，不属于本品的饰品要在可读注释区标明“不含”；影响到手内容理解时紧邻相关画面，不得隐藏；“本品为单条/单只”这类说明放规格区，不占卖点位。
- 名称缺失时先问用户给名或授权据图拟名；首图要让人一眼知道是什么品类（项链/耳饰/手链），意象句放副标题。

### 功效与耐用类说法

- “不掉色”“不易打结”“不过敏”等没有检测或资料依据的承诺，降级为结构描述或保养提示，不靠免责声明补救。
- 保养提示只写资料支持的内容，语句要完整通顺。
```

## File: references/compliance-rules.md
size: 17388
sha: 37dd0ff9ce85512563bb923ef52665adff3c2ca7
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/references/compliance-rules.md

```text
# 电商文案合规与证据框架

> 本文件用于保守执行和风险筛查，不是法律意见，也不能替代目标市场的现行法律、监管文件、平台规则或专业审核。平台规则和监管要求会变化；当用户询问具体当前规则时，应优先核验官方最新来源。

来源索引：[source-notes.md](source-notes.md)。下文的来源 ID 对应官方文本/入口与适用范围；仅有平台入口不代表具体规则已核验。字数/字号是本 Skill 的设计基线，不冒充法律或平台要求。

## 1. 先看“宣称类型”，不要只做敏感词替换

来源：CN-AD、CN-PRICE；美国场景另看 US-ADS、US-CLAIMS。

| 宣称类型 | 例子 | 处理原则 |
|---|---|---|
| 商品事实 | 材质、净含量、规格、产地、配料 | 以包装、参数表、合同、检测或用户确认资料为准 |
| 性能/效果 | 更耐用、更快、更静音、改善体验 | 需要可解释的参数、测试、机制或证据；不能把推测写成事实 |
| 数据 | 20kg、99%、3倍、未检出 | 必须能追溯到可信来源；来源不明时不要使用精确数字 |
| 认证/资质 | FDA、CE、有机、专利、非遗、获奖 | 只能基于真实有效且适用于该商品/主体/市场的材料表达 |
| 比较 | 比普通款更强、优于竞品 | 需要统一口径、可比条件和来源；避免虚构竞品数据或贬损性表达 |
| 价格/稀缺 | 最低价、全网最低、限量、仅剩 | 需要与当前真实销售条件一致，并核验目标平台最新规则 |
| 用户评价/销量 | 10万+好评、复购第一 | 只能引用真实可核验的数据，不可模拟消费者证言 |
| 健康/医疗/功效 | 治疗、修复、降血糖、增强免疫 | 高风险；必须先确认产品法律属性、批准/备案范围和目标市场规则 |

## 2. 证据状态

内部执行状态，不是监管分类；事实义务参考 CN-AD、US-ADS。材料需核对对象与范围，用户口述或示例成图不等于资质证明。

对每条关键宣称使用四种状态：

- **已确认**：用户材料或可靠来源直接支持。
- **有依据**：可由已确认事实合理翻译，但不能扩大含义。
- **待补证**：需要检测、认证、官方规则、批准范围或其他证据。
- **禁止**：明显要求编造、误导、越权功效、虚假背书或无法合法支持。

最终稿只使用“已确认”和“有依据”。“待补证”要改为中性表达，或整项删除并列入稿外待确认清单。

## 3. 高风险表达

来源：CN-AD、CN-WEB、CN-HEALTH；其他市场按当地规则，不能直接迁移中国禁限词表。

### 绝对化与保证性表达

“最好、第一、唯一、100%、绝对、彻底、永久、零风险、保证有效”等词通常具有较高风险，但是否违法或可用取决于具体语境、证据、司法辖区和平台规则。不要把一张静态禁词表当成最终法律判断。

国内商品主图/PDP按第10节更严格的默认策略执行：不用最高级营销口径和医疗功效承诺，潜在合法例外另作人工复核，不直接进入最终稿。真实的“第一步”“100g”等操作顺序/规格不能只因含某个字而判违法。参见 CN-AD、CN-AD-ABS、CN-CITE。

默认做法：

- 能用客观参数就不用空泛最高级。
- 能写“基于某测试/某条件”就不要写无条件保证。
- 无证据时删除或降级，而不是简单换成“更”“较”“有助于”就认为安全。

### 医疗、健康与身体功能

不要仅靠加“非医疗产品”“效果因人而异”等免责声明来修复本身不允许的宣称。先判断产品法律属性，再判断允许说什么。

高风险类别包括但不限于：

- 普通食品与饮料
- 保健食品 / 膳食补充剂
- 药品、医疗器械
- 健康护理、体态管理、按摩器材
- 儿童、孕产妇相关商品

## 4. 食品与健康类保守执行

来源：CN-FOOD、CN-HEALTH；美国对应 US-CLAIMS/US-ADS，禁止跨市场扩大批准范围。

### 普通食品/饮料

在未确认目标市场允许范围和产品身份前，默认不要把普通食品写成具有疾病预防、治疗、身体功能改善或特定健康功效。

优先使用：

- 原料与产地
- 配料与真实营养信息
- 口感、香气、风味
- 工艺、包装、规格
- 冲泡/食用方式
- 真实使用场景
- 可验证的品牌与供应链信息

### 保健食品 / 膳食补充剂

不同市场定义和可宣称范围差异很大。必须确认：

1. 目标国家/地区。
2. 商品法律属性。
3. 注册、备案、批准、标签或允许宣称的原文。
4. 平台当前类目政策。

没有上述信息时，不扩大功效，不把其他市场的批准范围直接移植过来。

### 医疗器械 / 健康设备 / 按摩器材

不要因商品与“疼痛、康复、矫正、治疗”场景相关，就默认可以使用医疗化表达。先确认产品是否为医疗器械、适应范围和注册/批准信息。

非医疗属性商品优先描述：

- 使用场景
- 材质与结构
- 档位、续航、噪音、便携性等真实参数
- 操作体验

### 母婴 / 儿童用品

先区分儿童日用品、婴幼儿食品、特医食品和儿童化妆品，并核对年龄、使用条件、警示与测试范围。没有对应证据，不写“新生儿适用”“食品级”“无敏”“绝对安全”，不虚构医生/妈妈评价。中国场景查 CN-AD/CN-FOOD/CN-HEALTH 及适用标准；海外场景重新核验。资料不全时先交证据缺口与可支持的外观/规格方向。

### 化妆品 / 个护

来源：CN-COS、CN-AD。先核对商品属性、注册/备案、标签和功效依据，不能把普通护肤写成治疗，也不能由某一成分推断整品功效。儿童化妆品还需专项规则；无法访问原文时标记待核验。

## 5. 数据、检测与认证

来源：CN-AD、CN-COS、CN-HEALTH、US-ADS；品牌/Logo 权利另查 CN-IP。没有实际授权或材料，不因图上存在某标志就认定已认证。

以下内容必须能追溯：

- 精确百分比、倍数、测试结果
- “未检出”“零添加”“无某成分”等可验证声明
- 认证、证书、批准、注册、专利、奖项
- 产地、年份、等级、稀缺性
- 销量、排名、复购、好评率

引用时尽量保留：来源名称、适用产品、适用时间、检测条件或证书范围。不要把“企业有证”自动等同于“该 SKU 可使用该宣称”。

## 6. 对比与竞品

来源：CN-AD、CN-IP、US-ADS。

可以做“帮助用户选择”的客观对比，但必须：

- 使用一致口径和同一比较条件。
- 不虚构对手参数。
- 不把主观评价写成事实。
- 不用贬损性表达替代证据。
- 如果使用具体竞品品牌，确认目标市场和平台是否允许这种呈现。

更稳妥的做法是比较“本品规格/结构/使用条件”与“常见选择维度”。

### 价格 / 组合 / 促销

来源：CN-PRICE、CN-AD 及对应平台当前活动规则。核对币种、SKU、件数、单位价/总价、优惠门槛、人群、有效期、运费和对比价依据。限制条件紧邻价格，不能只在底部藏小字。未提供价目和活动证据时，只写已知组合，不编造划线价、最低价、限量或倒计时。

## 7. 平台规则的时效性

来源：[平台官方入口及访问限制](source-notes.md#平台官方入口)。结论须记录实际读取的文档标题、版本/生效日期和条款，不能只贴首页。

不要把历史经验写成“平台现在明确规定”。以下内容通常需要实时核验：

- 主图是否允许文字、徽章、边框、道具、人物或场景
- 图片尺寸、比例、文件格式
- 类目资质与禁售规则
- 价格、促销、对比、功效、评价相关限制
- A+、Brand Story、详情页或视频素材规则

如果可以联网，优先查询官方帮助中心、政策中心或卖家后台官方文档。无法核验时明确写：

> 当前平台规则未实时核验，以下仅按保守视觉与文案原则执行，上线前需以平台最新官方规则复核。

## 8. 上线前检查

- [ ] 每个关键事实是否有来源？
- [ ] 每个精确数字是否可追溯？
- [ ] 是否把“待补证”写成了确定事实？
- [ ] 是否存在医疗、健康、功效或保证性暗示？
- [ ] 是否存在虚构认证、销量、评价、排名或竞品数据？
- [ ] 免责声明是否被错误地当成“免责通行证”？
- [ ] 当前平台规则是否需要实时核验？
- [ ] 跨境场景是否按目标市场重新判断，而非直接套用中国规则？

## 9. 来源索引（供核验，非法律意见）

形成宣称或规则结论前先查对应官方材料，不等写完最终稿才补来源。[详细来源、市场、版本与访问限制](source-notes.md) 集中维护，避免两处索引互相漂移。

| 类型 | 核验文件/机构 | 官方入口与范围 |
|---|---|---|
| 中国广告与消费者保护 | 《广告法》《消费者权益保护法》《电子商务法》《反不正当竞争法》及互联网广告规章 | [国家法律法规数据库](https://flk.npc.gov.cn/)、[市场监管总局](https://www.samr.gov.cn/)；具体文本与版本见详细索引 |
| 中国食品与保健食品 | 《食品安全法》、实施条例、保健食品标签与广告审查材料 | [市场监管总局](https://www.samr.gov.cn/)；按实际法律属性与批准范围核验 |
| 中国药品/医疗器械/化妆品 | 注册/备案、标签、功效依据、广告与专项要求 | [国家药监局](https://www.nmpa.gov.cn/)；本次入口返回412，未当作已读具体条款 |
| 国内平台 | 淘宝/天猫、京东、拼多多、抖音小店、小红书、视频号/微信小店 | [各平台官方入口与访问结果](source-notes.md#平台官方入口)；按展示位置和当前类目文档复核 |
| Amazon / Shopify / 其他跨境平台 | 对应站点图片、A+、类目、宣称与促销条款 | [卖家中心/帮助中心索引](source-notes.md#平台官方入口)；入口可访问不等于具体规则已核验 |
| 美国市场 | 广告真实性、评价/代言披露、食品/补充剂宣称与标签 | [FTC](https://www.ftc.gov/)、[FDA](https://www.fda.gov/)；对应文件见详细索引 |
| 其他市场 | 当地广告、食品、化妆品、儿童用品等要求 | 先定位目标国家/地区监管机构；不能移植其他市场的批准范围 |

本轮已逐个尝试访问列明入口；可读正文、仅导航/JavaScript、需要登录及网络/权限阻塞分别记录。无法读取具体文档时标记“未核验”，不能把访问入口或历史日期写成现行条款已确认。引用结论需附来源名称、版本/生效日期（可得时）与核验日期。

## 10. 国内主图/详情图文案执行

适用：面向中国大陆推广的商品主图、详情图、商品卡及其文案改稿，包括淘宝/天猫、京东、拼多多、抖音小店、小红书、视频号/微信小店。先按实际市场、产品类别和内容性质判断；不能靠改名为“详情说明”“用户体验”规避商业宣传责任，也不能声称所有商品信息都在法律上自动属于广告。无论是否构成广告，均不编造、误导商品信息。

### 法律底线与本 Skill 的保守默认

来源均在 [官方索引](source-notes.md)。下表是执行摘要，不替代原文，也不把内部设计建议写成法条。

| 检查项 | 依据 | 执行动作 |
|---|---|---|
| 宣称真实、明确且不误导 | CN-AD 第4、8、28条 | 材质、规格、产地、功能、价格、荣誉和承诺逐项对应资料，不把成分/结构推成整品功效；资料有问题也不能照抄 |
| 绝对化、优越性营销 | CN-AD 第9条第3项；CN-AD-ABS 第2、5–7项 | 默认改写“国家级、最高级、最佳、全网第一、唯一、顶级”等营销口径；有材料仍先核对语境、例外和误导风险，疑难原句不入最终文字层 |
| 排名、销量与比较 | CN-AD 第11、13、28条；CN-CITE 第12–13项 | 不贬损竞品，不移植竞品证据；不得只补时间/地域就认定“第一”可用。小于省级地域、过窄行业、无专有国/行标等情形须按2026引证指南核对 |
| 引证数据与文摘 | CN-AD 第11条；CN-CITE 第4–11、14–15项 | 查机构资质、方法、原始结论和可查询来源；消费者可见处标明出处、实验条件、样品限定、适用范围和期限，不把实验室结果扩大成日常保证 |
| 价格、赠品及允诺 | CN-AD 第8条；CN-PRICE；CN-CITE 第11项 | 价格对应SKU/件数/币种；券、人群、拼单、运费、活动期等影响理解的条件紧邻价格；赠品写清品种、规格、数量、期限和方式，信息不全则不写赠品承诺 |
| 普通商品与健康、药械 | CN-AD 第16–20条 | 普通商品不宣传疾病治疗或混淆药械身份；保健食品不宣传疾病预防/治疗、替代药物或保证性效果。普通食品不因成分与养生联想就写保健功能 |
| 专利、官方背书、证言 | CN-AD 第9、12、33、38条 | 不借国家机关名义/形象背书；专利核对有效权利、种类和专利号；认证不得扩大对象与范围；他人名义/形象和评价不伪造、不超授权 |
| 其他禁止内容与特殊受众 | CN-AD 第9–10、20、23、38、40条；CN-WEB 第12条 | 排查国家标识、歧视、迷信等禁止内容，按类别核对婴儿食品替代母乳宣传、酒类、未成年人定向媒介与代言限制；不因商品资料真实而免检 |
| 禁限广告 | CN-AD 第15、22条；CN-WEB 第6条 | 烟草/电子烟、特殊药品和处方药先查禁止、媒介限制与适用例外，不默认可做普通电商广告 |
| 法定广告审查 | CN-AD 第46条；CN-WEB 第7–9条 | 药械、保健食品等须审查广告缺批准材料时停止生成待发布广告，只列补证清单和非发布结构。已审内容不得任意剪改；法定审查不能由店铺或平台审核代替 |

**保守默认**：国内主图/详情图的营销层不用极限词和医疗功效词；不提供谐音、拼音、拆字、表情、字体藏字或画面隐喻版本。纯操作顺序、真实规格或依法必须出现的声明按含义处理，不能机械删除“最”“第一”“药物”等字串。确需保留的潜在合法表达先交替换稿，原句、材料及法规依据放稿外待人工复核；法律禁止的内容即使人工同意仍不能发布。不予处罚、减轻处罚等裁量不等于发布许可。

**引证与自证**：外部报告、受托检测/统计属于引证；按 CN-CITE 第8–10项公开出处及必要条件。广告主自行测试等自证依第17–18项处理，法律允许情形可不标出处，但仍需真实可举证并明确适用条件；本 Skill 保守建议标“企业自测”，不得包装成独立第三方认证。AI生成的数字、论文或测试图不能凭生成结果当作已验证证据。

### 文案与版式联审

1. 先写一个有材料支撑的购买理由，用材质、结构、容量、外观、真实使用方式等表达价值；不为增强转化编造效果、好评、销量、价格或稀缺。
2. 每张执行卡列“国内广告合规自检”：产品类别、允许宣称、事实来源、禁止/高风险口径、可见出处与条件、法定审查/人工复核缺口。结果分“通过 / 阻断 / 待人工复核”；通过仅表示本次方案检查，不能保证执法或平台审核结论。
3. “最终文字层”完整汇总标题、副文案、数据标签、出处和声明，单独给设计师；删除的风险原句、推理和待补证事项只在稿外备注。超限或仍有补证/审查阻断的文字先实际改完，不能列为最终稿再建议未来修改。中性场景描述也不能补造未提供的属性、比较或使用效果。
4. 引证出处和适用条件必须能正常辨认；不可用更小字号、近似背景色隐藏限制。关键条件靠近宣称，长出处/说明用独立可读区域，放不下就拆模块或删除该宣称。适用的法定声明保留原文，不受营销副文案字数上限挤压。
5. 主图、详情图、SKU选项与价格信息一起核对；文案、包装、示意图、徽章、人物和前后对比画面形成的整体暗示同样审查。原包装疑似问题不能靠保真要求免检，也不能擅改包装冒充真实商品。
6. 完成方案检查后才交可用文字；法定审查或关键证据未齐时完成其余支持部分，明确阻断。实际成图的逐字、保真和移动端可读性另验，不冒称已验收。

### 改写示意（非商品事实）

| 风险诉求 | 已有材料 | 可采用的方向 |
|---|---|---|
| “收纳架全网最强承重” | 仅不锈钢、可伸缩 | “不锈钢材质”“按需伸缩”，不造承重数字 |
| “普通黑芝麻食品乌发防脱” | 只有食品名称 | 只写“黑芝麻食品”；风味、配料和工艺未提供也不补造 |
| “检测35dB，日常始终静音” | 特定型号、档位、距离与样品检测 | 仅在可用且能清楚展示出处/条件时给限定结果，否则删数字，不升级为日常承诺 |
```

## File: references/copy-quality-rules.md
size: 6359
sha: 8c779a99cd532b7e0d2fd5798583be18352e5f2a
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/references/copy-quality-rules.md

```text
# 文案质量规则（细则与正反例）

## 优先级

| 层级 | 规则 | 违反后果 |
|---|---|---|
| 阻断项 | 交付即终态；推断不写成事实；Prompt 自包含 | 不能交付，先改 |
| 质量项 | 跟我有什么关系、信息增量、数字有感知、消费者语言、问答三关、澄清归位 | 文案平庸但可用，交付前应修掉 |
| 前置 | 按决策顺序排信息；参考资料先提炼成硬约束 | 写文案之前完成 |
| 场景开关 | `references/category-notes.md` 中对应品类的补充 | 命中品类才启用 |

## 阻断项

### 1. 交付即终态

成品文案会直接进入出图、排版、上架。交付前扫描“待补”“待确认”“待核”“（xx未提供）”和内部建议口吻，缺失项**整行删除**，不留空标注，商品数量等已确认事实可进入规格/可读注释，不能把内部待确认说明印到图上。

- 反例：数字标签「承重（待补）」。
- 正例：整条数字标签删除；缺的资料写进稿外的待确认清单。

### 2. 推断不写成事实

来源分凭证、供应商口径、视觉观察、推测四类。只有凭证和已交叉验证的供应商口径能进成品；视觉观察和推测只写在稿外备注。与实物冲突时以实物为准并回问。

事实宣称遵守上述证据边界；用户授权的据图拟名仍按 `SKILL.md` Step 0执行，名称不证明材质、工艺或性能，内部保留拟名来源。

- 反例：资料只写“不锈钢”，看图上的抛光纹理就写成“镜面拉丝工艺”。
- 反例：商家写“一体成型”，图上明显有拼接缝，仍照抄。
- 正例：只写资料口径“不锈钢”；冲突时回问商家，在稿外列为待确认。

### 3. Prompt 自包含

默认下游是 AI 生图模型。每条 Prompt 单独复制到新会话也能出图。

- 反例：“风格同上一张，换个俯视角度。”
- 正例：写全产品结构（部件数量、形状、比例）、材质与表面、光线方向与软硬、构图与产品占比、留白位置、背景、禁止项（不新增配件、不改结构、不出现文字），并重复 Style Lock。
- 同一套图的 Style Lock 在每条 Prompt 里重复写，不写“同上”。

## 质量项

### 4. 卖点语体，不是说明语体

首图商品名先完成识别，不因缺少营销语气而删除；其余营销句逐句问“这句能让用户更想买吗”。解释产品怎么构成的句子，要么改成“为什么值得买”，要么删。

- 反例：「三层隔板，可调节高度」（说明构造）。
- 正例：「隔板高度可调，大小物品都能分层放」（讲用户得到什么；以资料确认隔板可调为前提）。

### 5. 信息增量，不复述画面

首图名称/品类与必要规格、条件是例外；其余信息不机械复述画面。文字补画面说不出的：动态、场合、触感、规格、搭配。

- 反例：图上能看到三层格，文案又写「三层收纳格」；标题与副文案说同一件事。
- 正例：副文案写使用场合或规格信息（前提是资料支持）。

### 6. 数字有感知，适配给判断

KV1名称中用于识别规格的数字可保留；其余营销标题避免只列参数。数字要配位置、体感或对照物；适配类内容给分档、结论和后果。体感与阈值只用资料里已有的数据，没有就回问。

- 反例：标题只写「500ml」就当作购买理由。正例：准确容量放规格区；有经过核对的容量对照图时再补直观对照，没有就保留准确参数，不虚构“标准瓶”容量或体感。
- 反例：「按自身身高选尺码」。正例：照资料里的尺码表写分档，如“身高 160cm 以下选 S”；资料没有尺码表就回问，不自己编阈值。

### 7. 消费者语言

术语只在规格区出现，宣传区转成日常表达。

- 反例：「视觉聚焦，信息层级清晰」。
- 正例：「一眼看到重点」。

### 8. 句子完整可读

写完朗读一遍；宁可删一条要点，不留残句。

- 反例：「沾水汗液后及时擦拭收好」。
- 正例：「沾到水或汗后，及时擦干再收好」。

### 9. 问答三关

FAQ 的每个问题同时过三关：

- 有依据可答。反例：问「会褪色吗？」答「不做不褪色承诺」。答不了就不设。
- 给明确判断。反例：「视个体差异而定」。正例：给分档阈值和选错的后果。
- 只回应本品用户真实存在的顾虑。反例：无盖款商品设「盖子会不会漏」。

### 10. 澄清归位

套装、搭配、规格的澄清放规格表或可读注释区，不占卖点位；影响到手内容或价格理解的条件仍紧邻相关画面/宣称，不得藏在小字中。搭配展示图里，不属于本品的搭配物要标明“不含”。

- 反例：卖点区写「本品为单条」。
- 正例：规格表写“数量：1 条”；搭配图底部小字写“图中其余饰品/配件不含”。

## 前置

### 11. 按决策顺序排信息

是什么 → 和我有什么关系 → 为何选它 → 凭什么信 → 怎么买。首图让人一眼知道品类，意象句放副标题；详情页每个模块只解决一个决策问题。

- 反例：首图标题讲产品结构怎么分，用户看不出这是什么品类。
- 正例：首图标题使用已确认名称或授权据图拟名，明确品类；卖点第二层且可省，结构细节放后面的图。

### 12. 参考资料先提炼成硬约束

用户给了商机分析、竞品参考、品牌资料时，先列 3–5 条硬约束再动笔。

| 提炼项 | 写法示例 |
|---|---|
| 目标人群 | 资料指向的人群和使用场合 |
| 必须强调的差异 | 资料里被验证的差异点 |
| 必须避开的做法 | 资料里指出的误区或平台限制 |
| 可借鉴的结构 | 句式、信息层级、模块分工 |

学结构，不学表皮；不移植他人的事实、数据、承诺和品牌元素。

用户自己的品牌色或明确授权保留的视觉参考按 Reference Fidelity 执行，不因这条规则被删除。

## 交付前三问

1. 成品里还有没有占位符或内部说明？
2. 每个工艺、材质、性能说法，资料里有吗，和实物一致吗？
3. 每条 Prompt 单独复制出去，能不能出图？
```

## File: references/output-contracts.md
size: 11191
sha: d732b0ffdac9e62be12249f1f7d3edcf32cb445c
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/references/output-contracts.md

````text
# 输出结构模板

> 所有模式输出完整方案（包括标准模式的完整策略/分镜）、设计师交接或正式审查报告前必须加载。局部改词可按需读取；正式方案交付末尾必须附第 9 节《自审记录》，单纯命名咨询不必附整套评分；完整单张执行卡必须保留任务、画面、文案、排版、Prompt、禁止项和证据。

## 0. 开工问卷模板（选填，只发一轮）

先核对名称：原始商品名/可用的品类名已提供就沿用；缺名且未授权据图命名时，先问“请提供商品名，或授权我根据图片拟名”。可与本轮合并，但名称不是选填项，未回复不视为授权。

以下偏好维度只保留消息和资料里**还没有**的内容，已有的删掉。括号里是不回答时的默认处理。

```markdown
开工前可以补充下面的信息，**都是选填**：回答越完整，方案越贴合；不想答直接说“跳过”或“直接做”，我按括号里的默认处理。可以只回编号。

1. 平台/市场：（默认：淘宝/天猫主图）
2. 产出范围：主图几张？要不要详情页？（默认：主图约 5 张，每张含执行卡和生图 Prompt）
3. 目标人群与使用场景：（默认：按资料推断，标为假设）
4. 最想主打的 1–3 个卖点，以及哪些有资质/检测/参数支撑：（默认：按资料提炼）
5. 风格与调性（如高级简约、种草生活感、促销直给、国风、科技感；有参考图更好）：（默认：按品类和平台惯例）
6. 价格定位与促销（有活动、赠品、组合吗）：（默认：不做价格和促销表达）
7. 必须保留或禁止出现的（品牌色、Logo、结构、禁用词）：（默认：以产品原图为准）
8. 图内文字：后期叠字、完全不新增文字，还是让模型直接出短标题？（默认：留白排版，后期叠字）
9. 其他资料：产品图、包装图、商机/竞品分析、品牌手册，直接发我即可。
```

用户回复后不再发第二轮问卷。用户口述的卖点按“用户口述”记入证据账本，没有原件佐证仍是待补证。

## 1. 视觉策略与证据账本

```markdown
# 电商视觉策略

## 1. 任务定义
- 平台 / 市场：
- 产品名称/品类与命名来源：用户原始商品名 / 用户授权据图拟名（非官方原名）；缺名先询问
- 目标人群：
- 本次产出：
- 执行模式：标准 / 一次性 / 审查 / 设计师交接
- 文字渲染方式：留白排版（默认）/ 模型出字（例外；须明确要求且文字很短）

## 2. 成交驱动力
- 主驱动力（视觉 / 痛点 / 参数 / 信任 / 情绪 / 价格组合）：
- 辅驱动力：
- Top 3 购买理由：

## 3. 证据账本
| 宣称/卖点 | 来源类型（凭证/供应商口径/视觉观察/推测）及来源/图号/URL | SKU/市场/条件/日期 | 状态 | 最终处理 |
|---|---|---|---|---|

## 4. Feature -> Advantage -> Benefit -> Evidence
| Feature | Advantage | Benefit | Evidence |
|---|---|---|---|

## 5. Campaign Style Lock
- 产品身份：
- 构图：
- 色彩：
- 光影：
- 字体/信息密度：
- 文字渲染/留白区域：
- 背景/场景：
- 必须保留：
- 允许变化：
- 禁止项：

## 6. 当前假设与待确认
```

## 2. Storyboard

```markdown
# 图片规划 / Storyboard

| 编号 | 视觉任务 | 要解决的决策问题 | 核心卖点 | 构图/第一落点 | 证据 | 风险 |
|---|---|---|---|---|---|---|
| KV1 | Hero | 这是什么商品？ | 先商品名/品类；卖点第二层、可省 | 商品整体与识别性形态 | 已确认原名/原图/SKU | 只有氛围或特性、缺商品词 |
| KV2 | Benefit | | | | | |
| KV3 | Proof | | | | | |
| KV4 | Scene | | | | | |
| KV5 | Spec/CTA | | | | | |
```

数量按平台与实际信息量调整，不必固定 5 张。

## 3. 单张图执行卡

```markdown
### KV1 — [任务名称]
- 原始商品名/据图拟名/已确认品类：记录命名来源；原名合适则直接使用，需短名时记录对应关系；未经授权不替换原名
- 视觉任务：
- 目标用户此刻的疑问：
- 画面：
- 第一视觉落点：
- KV1识别自检（首图适用）：允许叠字时主标题本身说清商品；遮住副文案仍能识别品类。无字图列主体/原包装识别依据，成图待验收；后续特性图无需重复商品名
- 图内文案：
- 最终文字层：集中列出全部消费者可见文字，含必要引证出处、条件和声明；风险分析不混入
- 国内广告合规自检：中国大陆适用时列产品类别、宣称依据/限制、可见出处/条件、人工复核或法定审查缺口；通过 / 阻断 / 待人工复核
- 文字渲染方式：留白排版（默认）/ 模型出字（例外，须明确要求且文字很短）；实际交付只选一个
- 文案规格自检：用计数器按最终字符串计算标题与每条副文案长度；列副文案条数、至多1个数字/证据标签及其账本来源
- 文字验收与回退：未生成时写“文字渲染待验收”；明确模型出字时列精确字串、位置、字号与逐字核验办法，出错改用后期叠字
- 排版：留白位置、标题/副文案/声明字号、底部声明与紧邻宣称的条件
- 设计说明：
- 生图 Prompt（自包含：产品结构/材质/光线/构图/留白/禁止项，单独复制可用）：
- Negative Prompt / 禁止项：
- 证据来源：
- 合规/平台备注：
```

## 4. 详情页 / PDP 模块执行卡

```markdown
### M1 — [模块名称]
- 叙事功能：承接 / 利益 / 机制 / 证据 / 场景 / 对比 / FAQ / CTA
- 用户疑问：
- 画面：
- 图内文案：
- 最终文字层：集中列出全部消费者可见文字，含必要引证出处、条件和声明；风险分析不混入
- 国内广告合规自检：中国大陆适用时列产品类别、宣称依据/限制、可见出处/条件、人工复核或法定审查缺口；通过 / 阻断 / 待人工复核
- 文字渲染方式：留白排版（默认）/ 模型出字（例外，须明确要求且文字很短）；实际交付只选一个
- 文案规格自检：1个标题 + 至多3条要点；用计数器按最终字符串计算标题与每条要点长度，核对数字来源，超限删减或拆模块
- 排版：文字安全区、字号、底部声明；重要条件紧邻对应宣称
- 文字验收与回退：模型出字须逐字检查；未见成图标记待验收，错误回退后期排版
- 设计说明：
- 生图 Prompt（自包含：产品结构/材质/光线/构图/留白/禁止项，单独复制可用）：
- Negative Prompt / 禁止项：
- 证据来源：
```

## 5. 审查/改稿报告

```markdown
# 电商视觉与文案审查

## 结论
- 是否存在硬性阻断：是 / 否
- 最大转化问题：
- 最大合规/证据问题：
- 最大视觉问题：

## 问题清单
| 优先级 | 位置 | 问题 | 为什么 | 最小修改方案 |
|---|---|---|---|---|

## 修正版
[只重写需要修改的部分；用户要求完整替换稿时再输出全稿]

## 国内广告合规自检（适用时）
| 原表述/位置 | 法律或保守策略依据 | 安全替换/删除 | 可见出处与条件 | 处理结果/阻断 |
|---|---|---|---|---|

## 最终文字层
[完整汇总修改后的消费者可见文字；需补证、待人工复核、法定审查未完成的内容不放入]

## 五维质量门（80 分合格线，附依据；完整格式见第 9 节）
- 证据与合规：__ 分｜依据：
- 转化逻辑：__ 分｜依据：
- 视觉层级：__ 分｜依据：
- 一致性：__ 分｜依据：
- 可执行性：__ 分｜依据：
```

## 6. 跨境本地化交付

```markdown
## 本地化说明
- 原始卖点：
- 目标市场理解：
- 保留的事实：
- 重写后的购买理由：
- 单位/规格本地化：
- 文化语境调整：
- 合规待核验项：

## 英文/当地语言图内文案
- Headline：
- Support：主图最多2条；PDP模块最多3条要点；按对应字数上限自检
- Evidence note：来源与适用条件单列；不强制塞入营销文案
```

单张执行卡与详情模块均遵守 `SKILL.md` 的默认建议值和移动端字号基线；这些是内部排版建议，不是平台规定，必要声明不靠缩字隐藏。每卡必须二选一文字渲染方式，并交文案规格自检；模型出字默认限≤8汉字或≤6词的一个英文标题，超长交留白排版。价格卡另附币种、SKU/数量、优惠门槛、有效期、运费与来源；缺条件不得写成无条件到手价。缺失项从文案字段整项删除，写入稿外待确认清单，不在图内文案或执行卡文案字段保留占位符。

## 7. 量化评分（仅用户明确要求时）

仅在用户明确要求对外展示量化评分时使用本节：用 1–5 分，不给无锚点的 80/100。交付前的内部自审用第 9 节的 80 分线，它以必要条件为锚点，与本节不同。

1–5 分含义：

- **1**：存在致命问题，不能交付。
- **2**：主要逻辑不成立，需要重做。
- **3**：基本可用，但有明确缺口。
- **4**：可直接执行，只有局部优化空间。
- **5**：证据、转化、视觉、一致性和执行细节都完整。

每个分数必须附具体依据。

## 8. 交付前终态扫描

交付完整方案或最终文字层前逐项过一遍：

- [ ] 成品文案里没有“待补”“待确认”“待核”“（xx未提供）”和内部建议口吻；缺失项已整行删除。有执行工具时运行 `python scripts/scan-final-copy.py "文案1" "文案2"`。
- [ ] 澄清类信息（如“本品为单条”“图中配件不含”）在规格区或可读注释区，不占卖点位；影响到手内容/价格理解的条件仍紧邻相关画面或宣称。
- [ ] 工艺、材质、性能说法只来自资料口径，且已对照产品图；与实物冲突的已回问。
- [ ] 每条生图 Prompt 不依赖其他卡片；需要原产品图时已明确图号/素材要求，连同指定图可单独交接，并重复了 Style Lock 和禁止项。
- [ ] 文案已过《文案质量自检》，数字有对照或体感，适配类内容给了结论。

## 9. 自审记录（正式方案交付必带）

最终稿之后附这一段；缺失视为没有完成自审。分数以 `SKILL.md` Step 6 的必要条件为锚点：必要条件有任一条不满足，该维度封顶 79 分，必须重写，最多 2 轮。

```markdown
### 自审记录
| 维度 | 分数 | 依据（一句话，写明满足了哪些必要条件） | 重写了什么 |
|---|---|---|---|
| 证据与合规 |  |  |  |
| 转化逻辑 |  |  |  |
| 视觉层级 |  |  |  |
| 一致性 |  |  |  |
| 可执行性 |  |  |  |
- 机械检查：scan-final-copy 通过 / count-copy 已核对 / 无执行工具，未运行
- 重写轮次：0 / 1 / 2
- 未达标项：无（或写明维度、原因、需要的资料）
```

标准模式分阶段交付时，每个阶段各附一份；该阶段不适用的维度写“本阶段不适用”并说明原因。2 轮后仍不到 80 分，交付已达标部分，把未达标项写在稿外，不标成最终稿。
````

## File: references/platform-playbooks.md
size: 11416
sha: b916e2a36a88c7a881b21f02c140e299a698e5eb
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/references/platform-playbooks.md

```text
# 电商平台视觉 Playbooks

> 这里是设计策略建议，不是平台硬规则。尺寸、主图叠字、类目资质、促销和禁限词需查 [官方来源索引](source-notes.md)。先确认平台、市场、类目和展示位置，只读对应段落；默认留白后期排版，平台不允许文字的图交无字版本。

商品图首张共同遵循“先认出商品，再讲购买理由”：缺名称先问用户提供或授权据图拟名；允许叠字时，KV1主标题使用已确认名称、授权拟名或清楚的品类短名，特性/氛围居第二层；无字首图靠真实商品整体和原包装识别。该要求是本 Skill 的交付策略，不是新增的平台规定，后续特性图可直接讲卖点。

## Amazon

**目标**：搜索结果识别 → 理解产品 → 比较规格 → 建立信任。

- Hero：准确展示商品身份、形态、包装和数量；主图与附图分别规划，不能把附图的文字策略直接套到主图。
- Benefit：把核心参数转为有依据的利益，一图一任务。
- Proof：只用适用于该 SKU/市场的产地、检测、材质与认证。
- How to use：步骤、安装、冲泡、兼容关系图示化。
- Selection/Lifestyle：真实比例、规格与使用条件，避免道具被误认作随包赠品。
- A+/Brand Story：品牌、工艺、系列和信任叙事，不能假设所有卖家/商品都具备使用资格。
- 待核验：站点/类目主图背景、叠字、数量尺寸、A+ 资格与内容政策。来源：[Amazon Seller Central](source-notes.md#平台官方入口)。

## Shopify / DTC 独立站

**目标**：首屏价值清楚，页面节奏连贯，结账前异议得到回答。

- 首屏：商品 + 单一价值主张 + 已核实价格/规格 + CTA；社会证明只能用真实材料。
- Top Benefits：最多 3 个购买理由，每项关联事实。
- Mechanism/Proof：解释机制、材料、工艺和证据，不只堆“高级感”。
- Variants：规格、尺寸、适配与组合，选项应和实际销售一致。
- FAQ：使用、配送、售后、退换货，只采用店铺真实政策。
- 移动端：先清楚展示商品，再用正文承担长解释，避免把全部信息烙在图片里。
- 待核验：目标市场广告/消费者规则、隐私、支付/广告渠道与类目限制；独立站不豁免合规。来源：[Shopify Help Center](source-notes.md#平台官方入口)。

## 淘宝 / 天猫

国内平台共同执行：无论平台是否拦截，主图、详情图文案均先走 [国内广告法执行规则](compliance-rules.md#10-国内主图详情图文案执行)，覆盖京东、拼多多、抖音小店、小红书、视频号/微信小店。平台审核通过不等于法律合规。

### 视觉目标

搜索/推荐中识别商品，详情页回答“为何选这款”。

### 任务分工

- Hero：先商品身份与对应SKU；主标题明确商品名/品类，购买理由放副文案、可省；用字体/留白建立主次。
- 利益图：材质/结构/工艺 → 使用收益，避免 5 图重复同一口号。
- 证据图：参数表、包装标签、报告适用范围，不造官方背书。
- 选择图：尺码、规格、型号/适用边界；活动图明确优惠门槛和有效时间。
- 详情叙事：承接首屏 → 利益 → 证据 → 场景 → 规格 → FAQ。
- 旗舰店/系列：继承品牌色、光影和商品比例，不随模块换风格。

### 常见坑

- 主图、详情页、SKU 的规格、数量或赠品不一致。
- 促销信息占满主图，挤掉商品本身；照搬同行的功效或绝对化宣称。
- 把旧详情图的价格、销量、评价自动沿用到新稿，或混用淘宝/天猫不同展示位置的规则。

### 需核验

对应类目的当前主图/活动图要求、宣传、价格、资质和禁限售规范。来源：[淘宝/天猫规则入口](source-notes.md#平台官方入口)。

## 京东

### 视觉目标

让参数可信、规格易选，降低理性决策成本。

### 任务分工

- Hero：真实型号和套装内容；包装/详情/SKU 名称一致。
- 参数图：每个参数带单位与条件，再解释可支持的使用收益。
- 适配图：尺寸、接口、兼容型号、安装空间和使用限制。
- 机制图：分解结构/工作方式，不把示意图误当实测效果。
- 对比图：同口径系列选择表，区分实测、厂商参数和缺失项。
- 场景图：保留真实比例，不能通过道具误导尺寸或功能。
- 售后/服务图：只有真实承诺才写质保、配送、安装或退换。

### 常见坑

- 参数只抄说明书，缺少使用条件与利益解释。
- 参数表、包装、SKU、详情页的型号/规格不一致。
- 检测与认证不对应实际 SKU，把结构示意图当作实测证据；无实际政策却承诺质保、安装或退换。

### 需核验

开放平台当前类目资质、商品发布、参数披露、主图、价格/活动、对比和服务承诺规范。来源：[京东规则入口](source-notes.md#平台官方入口)。

## 拼多多

### 视觉目标

迅速理解买到什么、多少、什么条件下多少钱。

### 任务分工

- Hero：清楚区分主商品、件数、尺寸和不包含的道具。
- 组合图：逐项列到手清单；不同 SKU 不共用一个误导性的“大份量”画面。
- 价格图：币种/数量/单位价格一致，券、拼单、首购或门槛紧邻价格。
- 规格图：用实物比例/尺寸和选项对应，避免“低价 SKU 引流、高配图展示”。
- 场景/品质图：展示可核实材料与工艺，不能只靠低价代替商品解释。
- 详情页短模块推进，不用缩小文字塞满卖点。

### 常见坑

- 组合数量、赠品与实际发货不一致，或低价 SKU 配高配商品图。
- 无依据写最低价、仅剩、热销第一、虚构原价/折扣，或隐藏新客/拼单/券门槛。
- 信息过密、数字标签堆叠导致主体和购买条件看不清。

### 需核验

当前类目、图片、促销、价格、对比、极限用语和平台活动要求。来源：[拼多多帮助/商家规则](source-notes.md#平台官方入口)。

## 抖音小店

**目标**：移动端迅速识别，与商品卡、短视频/直播中的事实口径衔接。

- 图组：商品身份 → 单一利益 → 真实使用 → 到手组合/规格 → 证据。
- 商品卡/详情/直播口径核对同一 SKU、件数、价格和赠品，不能相互冲突。
- 原生场景可以有动作与过程；效果对比必须有同条件依据，不能伪造前后效果。
- 促销场景核对活动时间、券与人群门槛；写清价格适用条件。
- 食品/美妆/母婴等先判断中国市场产品属性与资质，不借用海外 TikTok Shop 规则。
- 本 Skill 只规划商品视觉及必要图文口径，不扩成整场直播话术或投放优化。
- 待核验：中国抖音电商学习中心当前商品发布/营销、类目与价格规则。来源：[抖音电商官方入口](source-notes.md#平台官方入口)。

## TikTok Shop

**目标**：目标国家的移动购物用户能理解商品和本地购买条件。

- 先定国家/站点、卖家类型和类目，再规划图组；US、UK、东南亚等不能互套审核结论。
- Hero：用简短本地语言先说清商品身份；Benefits另讲有依据的特性。单位/插头/电压/尺码按真实SKU核对。
- Usage/Bundle：当地使用场景、到手内容和选项，不搬中国活动价格。
- 食品、补充剂、美妆、儿童等按该市场与站点类目政策重新核验。
- 图片、视频和商品卡中相同宣称需一致，不能凭视频夸张表达给静态图背书。
- 待核验：对应地区 Seller Academy 的图片、受限类目、认证、健康宣称、促销政策；不要将抖音资质直接当成 TikTok 许可。来源：[TikTok Shop US 示例入口](source-notes.md#平台官方入口)。

## 小红书

**目标**：商品图准确解释产品；笔记/封面用真实使用语境帮助理解。

- 先区分商品主图、详情模块与笔记封面，封面做法不自动适用于商品主图。
- 场景图：展示实际外观、比例、用法与限制，不能编造“亲测”、用户日记、素人评价。
- 材质/细节图：近景与简短说明，关键宣称关联自有证据。
- 选择图：规格、色差、适配人群与到手清单；不给未经确认的购买/站外引流指令。
- 商业合作、体验表达、类目功效和价格须按实际身份/发布位置核验，不能把营销稿伪装为真实消费体验。
- 待核验：电商学习中心当前商品发布规范、笔记/商业内容与类目要求；旧页可能标注失效。来源：[小红书官方入口](source-notes.md#平台官方入口)。

## 视频号 / 微信小店

**目标**：商品卡与内容承接清楚，用户能理解实际商品、规格和条件。

- 分开规划视频号内容封面、商品卡和微信小店详情图；不要用一张拥挤图片承担全部任务。
- 场景图以真实使用、产品比例和关键细节为主，避免靠字幕堆满画面。
- 详情图回答材质/规格/用法/证据/选择，和商品卡、短视频挂载商品保持一致。
- 价格、套装、赠品、售后仅写可核实条件，不默认添加加微信、到店或站外购买指引。
- 食品/健康类不编造病例、用户见证或身体变化；按中国市场与当前平台政策核验。
- 不把历史“视频号小店”文档名当成当前规则版本。后台资料需记录标题、版本/生效日期和适用类目。
- 待核验：微信小店商家后台/成长中心的当前商品与营销规范；未取得具体条款前只给保守策略。来源：[微信小店官方入口与访问限制](source-notes.md#平台官方入口)。

## Temu

**目标**：移动端清晰展示商品差异、数量、组合和规格。

- Hero：真实商品本体与到手数量，区分装饰道具。
- 参数/组合图：尺寸和件数图示化，按市场本地化语言/单位。
- 价格驱动不等于可以推算“全网最低”或虚构折扣；采用后台已确认的实际销售条件。
- 颜色/选项图与 SKU 一致，不拼成实际不存在的多件装。
- 待核验：目标站点/卖家模式下的类目、图片与促销条款。来源：[Temu 官方卖家入口](source-notes.md#平台官方入口)。

## Shopee / Lazada

**目标**：本地移动购物中看懂规格、适配和场景。

- 两平台分别确认站点，不互套促销、物流、类目或图片规则。
- Hero/Specs：商品身份、件数、尺寸与适配关系尽量图示化。
- Local scenes：按当地生活方式与语言重写，不能凭当地节日编造商品事实。
- Selection：选项和当前 SKU 一致；翻译长度不得破坏移动端字号。
- 待核验：所在国家的卖家中心/大学、类目政策、促销和物流要求。来源：[Shopee / Lazada 官方入口](source-notes.md#平台官方入口)。

## 跨境本地化通用规则

核对目标消费者是否理解卖点、单位与换算精度、实际使用/送礼场景、品牌/产地名一致性、语言长度和商品事实。文化语境可改，净含量、功效、资质或电压不能为“本地化”改造。中国资质不自动适用于海外；事实缺口单列，规则无法核验就标记未核验。
```

## File: references/source-notes.md
size: 11133
sha: 3937ceb86088f93c9336fb51b3f2d2ed6b4fb569
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/references/source-notes.md

```text
# 官方来源与核验边界

初次访问/检索日期：**2026-10-28**；国内广告专项复核：**2026-10-29**（CN-AD、CN-WEB、CN-AD-ABS、CN-CITE）。其他入口的访问记录仍为10月28日，不因本次改稿自动刷新。以下是官方公开文本或官方入口索引，不构成“所有条款均为最新有效”的保证。页面可能保留旧版；执行具体任务时还要核对修订状态、生效日期、市场、SKU 和类目。

记录具体结论时写明：`规则/条款 -> 官方 URL/文档 -> 市场与类目 -> 版本/生效时间 -> 核验日期 -> 对本图的影响`。搜索摘要、平台首页和可登录入口不能单独证明某条现行要求。

## 法律与品类来源

| ID / 框架覆盖 | 官方来源与定位 | 范围和本次核验状态 |
|---|---|---|
| CN-AD：真实性、绝对化、数据、比较、评价、品类与审查 | [市场监管总局《广告法》](https://www.samr.gov.cn/zw/zfxxgk/fdzdgknr/fgs/art/2023/art_5474cf75173c45d6a0379730fb4e8d97.html)，重点第4、8–18、20、22、28、33、38、40、44、46条 | 中国；2026-10-29重新读取，所载2021-04-29第二次修正文本；事实有依据不等于宣称依法可用，具体任务仍查版本与语境 |
| CN-AD-ABS：绝对化语义与适用边界 | [市场监管总局《广告绝对化用语执法指南》](https://www.samr.gov.cn/ggjgs/tzgg/art/2023/art_183b5cb48d9e4f0dba67f9f912a913ba.html)，重点第2、5–11项 | 2023年第6号，2023-02-24通过、02-25落款、03-29网页发布；2026-10-29已读。非误导客观说明与最高级营销分开，例外仍需真实证明；处罚裁量不是发布许可 |
| CN-CITE：引证、自证与限制条件可读性 | [市场监管总局《广告引证内容执法指南》](https://www.samr.gov.cn/zw/zfxxgk/fdzdgknr/ggjgs/art/2026/art_8962fc1e4eb44a87b93d265af43b6940.html)，重点第4–15、17–18、20项 | 2026年第20号，06-03成文、06-12网页发布；2026-10-29实际读取。核对出处、样品/实验条件、范围/期限、可读性及排名豁免限制；自证可不标出处不等于可以免证或虚构 |
| CN-CONS：消费者知情与真实商品信息 | [市场监管总局《消费者权益保护法》](https://www.samr.gov.cn/zfjcj/tzgg/art/2023/art_615af9ed6bcd4974bf853dd2e02bc663.html) | 中国；本轮实际打开并读到2013第二次修正文本，不将首页可读代替具体文本核验 |
| CN-EC：电子商务商品信息与经营义务 | [市场监管总局《电子商务法》](https://www.samr.gov.cn/zfjcj/tzgg/art/2023/art_d337c3291e8b40459ca03dea54395856.html) | 中国；本轮读到2018-08-31通过的公开文本；具体适用仍核对后续修订与相关法律 |
| CN-FAIR：商业宣传与公平竞争 | [市场监管总局《反不正当竞争法》](https://www.samr.gov.cn/zw/zfxxgk/fdzdgknr/fgs/art/2023/art_3737890d856a4e44a8ea07c50c90c116.html) | 中国；本轮读到2025-06-27第二次修订文本，载明2025-10-15施行，不能误用旧版 |
| CN-WEB：互联网商业内容与审查 | [《互联网广告管理办法》](https://www.samr.gov.cn/zw/zfxxgk/fdzdgknr/fgs/art/2023/art_d93a579afd45413e8576e4623fab348f.html)，重点第2、6–9、13–14条 | 中国；2026-10-29重新读取，所载2023-05-01施行文本；禁止变相广告、审查前置与已审内容不得随意剪改分别核对 |
| CN-FOOD：食品标签/广告、特殊食品 | [市场监管总局数据库所载全国人大常委会公报2025·5](https://sjfg.samr.gov.cn/law/file/pdf/3238901/1763351546670.pdf)、[广州市场监管局转国家法律法规数据库文本](https://scjgj.gz.gov.cn/ztzl/ygaflfgzczl/spaqjgl/gd/content/post_10762434.html)，重点第71、73、78–83条 | 中国；已读2025第三次修正文本，修改决定自2025-12-01施行；普通食品与特殊食品须分开 |
| CN-FOOD-REG：食品经营与标签配套规则 | [市场监管总局《食品安全法实施条例》](https://www.samr.gov.cn/tssps/zcwj/art/2023/art_8b8b119f412a4fa5bd4aceb3ecf8d364.html) | 中国；本轮已读所载2019修订文本，不把2009历史版当现行依据 |
| CN-HEALTH：药械/保健食品/特医广告 | [《药品、医疗器械、保健食品、特殊医学用途配方食品广告审查管理暂行办法》](https://www.samr.gov.cn/zw/zfxxgk/fdzdgknr/fgs/art/2023/art_4ca076ac0eeb4a9e9204e0cee26e359b.html)，重点第2、5–8条 | 中国；已读，页面载2020-03-01施行文本；核对注册/备案、说明书、广告审查与必需声明 |
| CN-COS：化妆品与功效证据 | [《化妆品监督管理条例》](https://www.samr.gov.cn/zw/zfxxgk/fdzdgknr/bgt/art/2023/art_9f8b70e79a2242df96c6c290a0ac425b.html)，重点第22、37、43条 | 中国；已读官方文本；功效证据与禁止医疗暗示按具体产品核验 |
| CN-PRICE：价格/折扣/比较价/促销条件 | [《明码标价和禁止价格欺诈规定》](https://www.samr.gov.cn/zw/zfxxgk/fdzdgknr/fgs/art/2023/art_9a1f82a007964950a1a0f6c056f2fedf.html)，重点第5、6、16–19条 | 中国；已读，2022-07-01施行；不引用已废止旧价格规章作为现行依据 |
| CN-IP：品牌/Logo/权利核验 | [国家知识产权局法律法规栏目](https://www.cnipa.gov.cn/col/col3684/)；另见下方拼多多官方知识产权入口 | 中国；官方索引，不在此断言具体商标法版本或条号；须核对授权与素材权利 |
| US-CLAIMS：食品/膳食补充剂宣称分类 | [FDA Label Claims](https://www.fda.gov/food/nutrition-food-labeling-and-critical-foods/label-claims-conventional-foods-and-dietary-supplements)、[FDA Structure/Function Claims](https://www.fda.gov/food/nutrition-food-labeling-and-critical-foods/structurefunction-claims) | 美国；已核验官方页面摘要；区分健康、营养含量、结构/功能和疾病宣称，不套用中国批准范围 |
| US-ADS：广告证据、健康产品 | [FTC Advertising Substantiation](https://www.ftc.gov/legal-library/browse/ftc-policy-statement-regarding-advertising-substantiation)、[Health Products Compliance Guidance](https://www.ftc.gov/business-guidance/resources/health-products-compliance-guidance) | 美国；已核验官方摘要；具体证据强度需阅读适用指引，不把一项研究扩大成所有功效 |

母婴不是统一法规类别：儿童日用品参考 CN-AD、适用产品标准与平台类目；婴配/特医参考 CN-FOOD/CN-HEALTH；儿童化妆品还需 NMPA 专项规定。本次 NMPA 深链返回访问限制，未将其具体条款标为已核验。缺年龄、产品属性或安全测试时，不能推定“新生儿适用”“食品级”“无敏”。

版本提示：2026年10月公开的《食品安全法》修订草案征求意见稿仍是征求意见材料，不在此作为已生效规则引用。不要只因官方旧页可访问，就忽略后续修正或把草案当法律。

### 监管机构入口点验

本轮逐个实际访问：[国家法律法规数据库](https://flk.npc.gov.cn/) 的首页可经本地浏览路径读取（搜索浏览路径返回403）；[市场监管总局](https://www.samr.gov.cn/) 首页可读；[国家药监局](https://www.nmpa.gov.cn/) 返回412，未读取正文；[FTC](https://www.ftc.gov/) 与 [FDA](https://www.fda.gov/) 首页经搜索浏览工具可读，本地TLS路径失败。访问结果因工具路径而异，不能据一次失败断言整个网站失效，也不能以首页可读替代具体法律版本或条款核验。

## 平台官方入口

此表均为**查找路径**，不是具体尺寸、叠字、类目或促销规则的验证结果。动态/登录页应进入正确卖家账号后读取相关文档；不要绕过访问控制。

| 平台/市场 | 官方入口 | 本次可访问范围与后续核验 |
|---|---|---|
| 淘宝 / 天猫（中国） | [天猫规则导航](https://www.tmall.com/wow/seller/act/rule-detail)，含淘宝规则链接 | 已见官方导航；具体发布、主图、活动和类目条款另查，旧链接可能迁移 |
| 京东（中国） | [京东规则中心](https://rule.jd.com/) → [商家帮助规则页](https://learn-jdm.jd.com/knowledge/rule) | 本轮实际打开并跟随重定向，帮助正文可读；未登录，具体类目条款另查 |
| 拼多多（中国） | [帮助中心](https://www.yangkeduo.com/home/help/) → 商家规则 / 知识产权保护规则 | 已见官方导航和两个子入口；具体条款不由导航页推出 |
| 抖音电商（中国） | [电商学习中心](https://school.jinritemai.com/)，搜索“商品信息发布”“营销”“类目” | 本轮重定向到/doudian/web/home，学习中心正文与规则入口可读；未登录，旧公示不是自动生效证据 |
| TikTok Shop（US 示例） | [US Seller Academy](https://seller-us.tiktok.com/university/home?identity=1&role=seller) | 官方页面依赖 JavaScript；仅确认入口，具体政策未在本次页面读取；其他国家使用本站入口 |
| 小红书（中国） | [电商官网](https://ec.xiaohongshu.com/)、[电商学习中心规则列表](https://school.xiaohongshu.com/rule/list/134) | 本轮官网重定向到/ecommerce/home，规则列表加jumpFrom参数后可读；页面提示登录但未登录，具体条款状态另查 |
| 微信小店 / 视频号（中国） | [微信小店](https://store.weixin.qq.com/) → 商家后台/成长中心 | 本轮动态浏览可读，页面显示扫码进入小店；未登录、未读后台规则。此前静态抓取失败不代表当前入口不可用 |
| Amazon（US 示例） | [Seller Central](https://sellercentral.amazon.com/)、[Seller Code of Conduct](https://sellercentral.amazon.com/help/hub/reference/external/1801?locale=en-EN) | 本轮卖家入口可读，显示登录/注册；具体主图/附图、A+ 和类目帮助仍须按站点核验 |
| Shopify / DTC | [Shopify Help Center](https://help.shopify.com/) | 本轮重定向至/zh-CN/，帮助首页正文可读；另查目标市场法律与支付/广告渠道条款 |
| Temu | [Seller Center](https://seller.temu.com/)、[Shopify 官方 Temu 渠道帮助](https://help.shopify.com/en/manual/online-sales-channels/marketplaces/temu/setup) | 本轮Temu重定向/no-auth.html并显示“没有网络连接”，未读到规则；不能因HTTP 200算核验通过。具体条款待账号/站点核验 |
| Shopee | [卖家登录入口](https://account.seller.shopee.com/signin/) | 本轮动态浏览ERR_CONNECTION_CLOSED，未读到页面；具体国家/类目规则待核验 |
| Lazada（MY 示例） | [Lazada University MY](https://university.lazada.com.my/)、[Seller Center MY](https://sellercenter.lazada.com.my/apps/seller/login) | 本轮大学正文可读，Seller Center跳转注册页并提供登录入口；未登录，不外推到其他站点 |

## 如何维护

法规条款、平台规则、保守执行策略、内部排版基线分别标注。新增硬规则应有具体官方条文与适用范围；仅有登录入口时保留“未核验”，不要补猜。若发现来源已失效/修订，先调整结论与适用范围，再更新访问日期；仅改日期不算复核。
```

## File: assets/showcase-output.svg
size: 65703
sha: ae2b3743aef9a69c0e5cd3753e56feaf4f393fa1
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/assets/showcase-output.svg

Content is not inlined in the catalog. Read the upstream file: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/assets/showcase-output.svg

## File: assets/showcase/figure-desktop-scene.jpg
size: 224428
sha: 6e0b692b0244e4c14aadb61612f53c131c2bebe2
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/assets/showcase/figure-desktop-scene.jpg

Content is not inlined in the catalog. Read the upstream file: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/assets/showcase/figure-desktop-scene.jpg

## File: assets/showcase/figure-multi-angle.jpg
size: 186725
sha: 61d226915a11e984ca835a8a5c6189f625684ab8
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/assets/showcase/figure-multi-angle.jpg

Content is not inlined in the catalog. Read the upstream file: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/assets/showcase/figure-multi-angle.jpg

## File: assets/showcase/lumina-pendant-lamp.jpg
size: 267290
sha: b597c8aa58cb00a5c73207c106442b88ea298831
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/assets/showcase/lumina-pendant-lamp.jpg

Content is not inlined in the catalog. Read the upstream file: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/assets/showcase/lumina-pendant-lamp.jpg

## File: assets/showcase/musang-king-durian-main.jpg
size: 179017
sha: c9d185e7343aae7133f793fac40e32518d0f55fb
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/assets/showcase/musang-king-durian-main.jpg

Content is not inlined in the catalog. Read the upstream file: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/assets/showcase/musang-king-durian-main.jpg

## File: assets/showcase/thumbs/figure-desktop-scene-thumb.jpg
size: 90273
sha: d040267222dde06f40d62ef26484419ca8e6a08a
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/assets/showcase/thumbs/figure-desktop-scene-thumb.jpg

Content is not inlined in the catalog. Read the upstream file: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/assets/showcase/thumbs/figure-desktop-scene-thumb.jpg

## File: assets/showcase/thumbs/figure-multi-angle-thumb.jpg
size: 69325
sha: bc96b1c27832b8a32966944e2cf94ce2c8d972e5
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/assets/showcase/thumbs/figure-multi-angle-thumb.jpg

Content is not inlined in the catalog. Read the upstream file: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/assets/showcase/thumbs/figure-multi-angle-thumb.jpg

## File: assets/showcase/thumbs/lumina-pendant-lamp-thumb.jpg
size: 44046
sha: 033793e24b69dcb60b6e9cdaa92b9004dc55e1a1
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/assets/showcase/thumbs/lumina-pendant-lamp-thumb.jpg

Content is not inlined in the catalog. Read the upstream file: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/assets/showcase/thumbs/lumina-pendant-lamp-thumb.jpg

## File: assets/showcase/thumbs/musang-king-durian-main-thumb.jpg
size: 46979
sha: 759ad03c51190bb877c6311a85ad48c271cf9921
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/assets/showcase/thumbs/musang-king-durian-main-thumb.jpg

Content is not inlined in the catalog. Read the upstream file: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/assets/showcase/thumbs/musang-king-durian-main-thumb.jpg

## File: .claude-plugin/marketplace.json
size: 849
sha: 620aedef1468bb6e2014e96b35739792a4460c88
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/.claude-plugin/marketplace.json

```text
{
  "name": "ecommerce-visual-copywriting-skill",
  "owner": {
    "name": "feichanggege",
    "url": "https://github.com/feichanggege"
  },
  "metadata": {
    "description": "E-commerce visual planning, storyboard, copy, evidence review, localization, and image-prompt workflow."
  },
  "plugins": [
    {
      "name": "ecommerce-visual-copywriting",
      "description": "电商视觉策划与执行 v3：支持主图、详情页、Amazon Listing/A+、跨境本地化、证据账本、Reference Fidelity、设计师交接、生图 Prompt 与合规审查。",
      "version": "3.0.0",
      "author": {
        "name": "feichanggege",
        "url": "https://github.com/feichanggege"
      },
      "source": "./",
      "category": "marketing",
      "homepage": "https://github.com/feichanggege/ecommerce-visual-copywriting-skill"
    }
  ]
}
```

## File: .claude-plugin/plugin.json
size: 366
sha: 08cdf92cf81b2aaaffb1d968cd74261b395020d8
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/.claude-plugin/plugin.json

```text
{
  "name": "ecommerce-visual-copywriting",
  "version": "3.0.0",
  "description": "Evidence-based e-commerce visual planning, copy, storyboards and designer handoff.",
  "author": {
    "name": "feichanggege",
    "url": "https://github.com/feichanggege"
  },
  "homepage": "https://github.com/feichanggege/ecommerce-visual-copywriting-skill",
  "license": "MIT"
}
```

## File: .github/ISSUE_TEMPLATE/bug_report.md
size: 406
sha: e4ea4990c5d6e2e05e7ee1db4dfaadb46a32ff98
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/.github/ISSUE_TEMPLATE/bug_report.md

```text
---
name: Bug report
about: Reproducible skill, documentation, or verification problem
title: "[Bug] "
labels: ""
assignees: ""
---

### Trigger
Runtime/model, platform/market, category, and redacted input.

### Actual and expected behavior
Include the relevant output or error and file/section.

### Reproduce and verify
Commands or request, expected observable result, and source materials if permitted.
```

## File: .github/ISSUE_TEMPLATE/example_request.md
size: 411
sha: ddc559d31b1894be95af3e5eac6b1f21bdb72da6
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/.github/ISSUE_TEMPLATE/example_request.md

```text
---
name: Example request
about: Request a useful evidence-bounded worked example
title: "[Example] "
labels: ""
assignees: ""
---

### Use case
Category, market/platform, target audience, requested output and mode.

### Available evidence
Permitted product materials, images and claim sources. Do not upload private customer data.

### Acceptance
What a designer/operator should be able to do with the result.
```

## File: .github/ISSUE_TEMPLATE/rule_update.md
size: 578
sha: 12a8140826da6b57ae4f7f2dc28c7a736601d8b7
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/.github/ISSUE_TEMPLATE/rule_update.md

```text
---
name: Rule or source update
about: Suggest a sourced compliance or platform correction
title: "[Rule] "
labels: ""
assignees: ""
---

### Scope
Market, platform, category, affected section, and whether this is law, policy, conservative practice, or style guidance.

### Official source
URL, title, applicable provision, effective date if available, and access date.
If login is required, include a permitted excerpt or redacted screenshot and mark the access limit.

### Proposed change
Explain the current error and safer wording. Include an affected input/output example.
```

## File: .github/PULL_REQUEST_TEMPLATE.md
size: 734
sha: df9f43d610b53742e17873b7b694429c99222444
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/.github/PULL_REQUEST_TEMPLATE.md

```text
## Problem and resulting behavior

Describe the concrete trigger and what changes for the user.

## Evidence and scope

- Affected category/platform/market:
- Official sources and applicable provisions (for rule changes):
- Chinese/English decision-rule updates:

## Validation

- [ ] `python tools/verify-skill.py`
- [ ] `python -m unittest discover -s tests -v`
- [ ] Minimal upload ZIP inspected if packaging changed
- [ ] Representative agent output reviewed if behavior changed
- [ ] Actual images/mobile preview checked if visual output changed

Record actual results and pending checks. Static checks do not establish model behavior or legal compliance.

## Remaining limits

List missing evidence or acceptance items, if any.
```

## File: .github/workflows/verify.yml
size: 576
sha: ebb42e3a28ab4801b7312d3bd4f325573ab29897
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/.github/workflows/verify.yml

```text
name: Verify

on:
  push:
  pull_request:
  workflow_dispatch:

permissions:
  contents: read

jobs:
  verify:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: '3.11'
      - name: Verify repository
        run: python tools/verify-skill.py
      - name: Test validation and response evaluator
        run: python -m unittest discover -s tests -v
      - name: Build minimal skill ZIP
        run: python tools/package-skill.py --output dist/ecommerce-visual-copywriting.zip
```

## File: .gitignore
size: 29
sha: df7e995c145c3f0f8edd26cdcbbe9bd4094915d3
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/.gitignore

```text
__pycache__/
*.py[cod]
dist/
```

## File: agents/openai.yaml
size: 187
sha: 1546333f3cb8bf34788bc58208f8783a039cb1e5
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/agents/openai.yaml

```text
interface:
  display_name: "E-commerce Visual Copywriting"
  short_description: "Turn product data into conversion-focused e-commerce visual plans, storyboards, copy, and image prompts."
```

## File: CHANGELOG.md
size: 5581
sha: 345a3c96911a992e51a5ae18758731fe744e380c
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/CHANGELOG.md

```text
# Changelog

## Unreleased

### Changed

- Stop instructing the model to keep placeholders for unproven claims: Needs-proof items are rewritten neutrally or deleted and listed in a pending-confirmation list outside the copy.
- Evidence ledger gains source types (documentary proof, supplier claim, visual observation, guesswork); only proof and cross-checked supplier claims enter finished copy, and specification areas hold Verified data only.
- Add listing/first-screen/cover rules, a five-step decision order, a three-part check for FAQ questions and an explicit list of content the image model must not generate; drop the annotation column from the kickoff questionnaire table.
- Make KV1 identify the product before secondary features: use a clear confirmed original name in the headline, retain original-to-short-name mappings where needed, and check recognition without support copy. Preserve no-added-text placements and allow later images to lead with features.
- Synchronize Chinese/English guidance, output contracts, platform playbooks and README examples; keep the universal naming rule in the runtime and retain only as examples the confirmed names “飘带裙摆项链” and “飘带流苏长项链” without inferred renaming or material/bundle claims.
- Restore the 80-point self-review as an anchored gate: five dimensions scored 0–100 against required conditions, any dimension below 80 rewritten (max two rounds) before delivery, and a self-review record attached to every delivery. Missing record or an under-80 final draft is a hard blocker. Self-review is stated as the first core principle and is not a pause in one-shot mode.
- Replace the Chinese and English README workflow diagrams with step/action/output tables. Align the summaries and deliverable lists with the current routing, evidence, text-rendering and acceptance rules.

### Fixed

- Make release text checks case-insensitive; cover bilingual section drift, broken local links, oversized/unreferenced showcase assets, prompt schemas and packaging.
- Replace the obsolete v1 overview and archive its internal polishing report.
- Compress showcase files and restore the complete durian thumbnail framing.
- Prevent unsupported performance inferences from product structure and require copy counts to match final strings.

### Added

- Seven behavioral scenarios for the two original necklace names, no-added-text KV1, later feature images non-jewelry recognition, missing-name kickoff and authorized image-based naming; lexical markers require manual headline/visual review.
- Kickoff questionnaire: one optional round (platform, scope, audience, selling points, style, price/promotion, must-keep/avoid, on-image text, references) with stated defaults; preferences may use defaults, while missing product names require user input or naming authorization, and verbal selling points stay Needs proof.
- Universal copy-quality rules: delivery-ready final copy, inference-is-not-fact, self-contained image prompts, selling-point voice, information gain, numbers with perception, consumer language, answerable questions, clarifications in place, decision-order information and distilling reference material into hard constraints. Detailed rules in `references/copy-quality-rules.md`; jewelry notes in `references/category-notes.md`.
- `scripts/scan-final-copy.py` to flag placeholders and internal notes in final copy, with regression tests and three new prompt cases.
- Mandatory mainland China main-image/PDP copy review, separate final text and per-card advertising checks, with conservative wording defaults and statutory-approval blockers.
- Refreshed PRC Advertising Law/internet-ad references plus the 2023 absolute-language and 2026 citation guidance; distinguish external citations from self-substantiation and keep required conditions visible.
- Six China advertising scenarios and final-copy-only required-marker checks, so analysis cannot stand in for visible sources or promotion conditions.
- Ordered default routing (Audit → Handoff → One-shot → Standard), one Standard checkpoint after Storyboard, shared output-contract loading, and price/bundle/promotion constraints.
- Separate main-image/PDP copy ceilings, one optional number/evidence tag, a ten-line rack example, one text-rendering method per card, copy-spec self-checks and post-production typography by default.
- A dependency-free copy-length counter included in the install ZIP, with punctuation and whitespace regression coverage.
- Separate Douyin Shop/TikTok Shop playbooks; expanded China-market guidance, Xiaohongshu and WeChat Channels/WeChat Shop.
- Official source index with jurisdiction, access status and verification boundaries.
- Full English skill companion, a traced teaching example, Claude installation paths and minimal upload ZIP packaging.
- GitHub Actions verification, issue/PR templates, machine-checkable prompt expectations and a response evaluator with regression tests.

These changes are not included in the v3.0.0 release. This section does not imply a new release or successful remote CI run.

## 3.0.0 — 2026-09-17

Existing [release](https://github.com/feichanggege/ecommerce-visual-copywriting-skill/releases/tag/v3.0.0), commit `4a5a639`:

- Four execution modes and an evidence ledger.
- Campaign Style Lock, Reference Fidelity and Negative Constraints.
- Dynamic image counts, multi-platform playbooks and localization.
- Hard blockers and five Pass/Fail gates replacing unanchored scoring.
- OpenAI UI metadata, bilingual README, output templates and six prompt scenarios.
```

## File: CONTRIBUTING.md
size: 3192
sha: 9cd2bbc7183e0c0e088843ae7f7e99357a7104c4
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/CONTRIBUTING.md

````text
# Contributing

Help improve a practical skill for evidence-based e-commerce visual plans, on-image copy, designer handoff, and localization.

## Report a problem

Use the issue templates for bugs, rule/source updates, or example requests. Include the runtime/model if known, category/market/platform, redacted inputs, actual output, expected behavior, and the location of the problem. Remove private customer information, credentials and non-public business data.

For rule suggestions, include an official URL, title, relevant provision, applicable market/category, effective date if available, and access date. Distinguish a legal requirement, platform policy, conservative practice, and style preference. A policy-center landing page does not prove a specific restriction.

## Make a focused change

- Read `SKILL.md`, the relevant reference, and `references/output-contracts.md` when changing output.
- Preserve the v3 workflow: evidence ledger, six drivers, Campaign Style Lock, Storyboard, execution cards, hard blockers and the five-dimension 80-point self-review with its record.
- Keep Chinese and English decision rules and sections aligned, including failure modes.
- Preserve explicit user mode choices. Missing evidence must not be invented; default model prompts reserve whitespace for later typography.
- Update applicable source notes, examples, prompt expectations and the Unreleased changelog.
- Keep each raster showcase asset at or below 500,000 bytes. Preserve product identity and complete image framing; link every public asset from documentation.
- Do not add new dependencies when the standard library suffices.

## Validate

```text
python tools/verify-skill.py
python -m unittest discover -s tests -v
python tools/package-skill.py --output dist/ecommerce-visual-copywriting.zip
```

If Claude Code is installed, also run `claude plugin validate .` after plugin metadata changes.

For behavior changes, run representative requests with the revised skill. Save the full response plus a separate `final_copy` field containing only publishable copy, then evaluate:

```text
python tools/evaluate-prompts.py --responses path/to/responses.json
```

The response format and matching rules are in [examples/README.md](examples/README.md). An evaluator Pass means specified text expectations passed; it does not prove legal compliance, visual quality, or all model behavior. Review claims, source scope, text rendering, mobile legibility, and product fidelity manually where relevant.

GitHub Actions runs static verification, evaluator regression tests, and packaging. Remote CI is confirmed only by the run result after a push/PR.

## Review and release

Use the PR template to explain the trigger, resulting behavior, sources, validation and any pending acceptance. Substantive rules require human maintainer review. Keep unreleased changes under Unreleased in [CHANGELOG.md](CHANGELOG.md). Existing release tags are immutable project history; publish a new version only after review, and keep marketplace/plugin versions aligned.

This project does not provide legal advice or guarantee platform approval. Contributions are released under the repository's MIT License.
````

## File: docs/archive/skill-polishing-report-v1.md
size: 5501
sha: 9a7d93d9695f23ef223c1a91d4e7b53282dbe9eb
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/docs/archive/skill-polishing-report-v1.md

```text
# 鲁班打磨报告

> 历史归档：本报告记录 v1 基线的内部打磨过程，仅供追溯，不参与当前安装包或 v3 执行规则。旧评分、确认门、竞品链接和当时统计均不代表当前状态。当前以仓库根目录 `SKILL.md`、`CHANGELOG.md` 和现行 references 为准。

目标仓库：`feichanggege/ecommerce-visual-copywriting-skill`
打磨日期：2026-06-13
基线提交：`f237dc3 Add usage examples`

## 1. 验料结果

挑战 1 - 真实问题：成立。电商视觉文案经常卡在“能写但不能落图”“卖点强但有合规风险”“设计师拿到仍要二次翻译”。

挑战 2 - 独特角度：唯一性来自工作流和合规规则库。它不是泛 copywriting，而是把主图、详情页、品类合规和设计执行说明合成一条 SOP。

挑战 3 - 安装理由：成立。用户安装它，是为了让 Agent 在电商图文案任务里稳定遵守确认门、行数限制、免责声明和分品类红线，而不是每次临时解释规则。

挑战 4 - 公共传播性：原仓库有 312 stars，说明题材已有传播信号；短板是首屏展示、安装路径、验证门和 marketplace 元数据不足。

验料结论：好料，继续打磨。优先补“公共 Skill 出生证”：首屏钩子、可见产物、一行安装、验证脚本、安全边界和发布元数据。

## 2. 访行记录

| 同类项目 | 链接 | 类型 | 一句话定位 | 可学的手艺 | 不能照搬的点 |
|---|---|---|---|---|---|
| dtc-copywriting-skills | https://github.com/coleschaffer/dtc-copywriting-skills | 直接/间接 | DTC marketing copywriting skills collection | 把营销任务拆成多个可安装技能 | 它偏 DTC 文案框架，不解决中国电商平台合规 |
| claude-copy | https://github.com/igoroliveirg/claude-copy | 间接 | Direct-response copywriting skills for Claude Code | 强调具体文案场景和技能包组合 | 偏英文直效营销，不适合作为合规规则来源 |
| copywriting-mastery-skill | https://github.com/Zzzeen2552/copywriting-mastery-skill | 手艺 | Master-level copywriting skill | 用“方法论来源”增强记忆点 | 大师背书型叙事不适合硬套到电商合规 |
| Sales-Page-Copywriting-Skill | https://github.com/yashaiguy-dev/Sales-Page-Copywriting-Skill | 间接 | Sales page copy generation with validation | 强调验证和反脆弱审稿 | 销售页结构不同于主图和详情页 |
| claude-code-copywriting-skills | https://github.com/robpalmer99/claude-code-copywriting-skills | 手艺 | Free Claude Code copywriting skills | README 直接说明安装后能做什么 | 不覆盖中文电商平台审核语境 |
| agent-skills-marketing | https://github.com/whyashthakker/agent-skills-marketing | 手艺 | Marketing skills collection for agents | 用技能合集定位降低理解成本 | 合集型仓库，不适合作为单一 Skill 首屏结构 |

## 3. 生态位判断

纵向结论：这个 Skill 从“私用的电商图文案 SOP”走向“公开可安装的电商视觉文案与合规工作流”。下一阶段方向不是堆更多平台口号，而是补可验证、可安装、可展示的公共资产。

横向结论：同类项目多强调 copywriting 框架、营销模板或英文直效文案；缺少“设计师可落图 + 中国电商平台合规 + 用户确认门”的组合。

交叉洞察：真正该抢的生态位不是泛营销文案，而是“电商视觉稿交付前的合规文案导演”。

一句话新定位：把产品资料和资质边界，转成设计师能直接上图的平台安全版主图和详情页文案。

## 4. 过尺结果

| 维度 | 权重 | 基线得分 | 打磨后目标 | 主要证据 | 优先级 |
|---|---:|---:|---:|---|---|
| Frontmatter 与触发条件 | 7 | 5 | 7 | 原描述有用途，但缺负触发和发布属性 | P1 |
| 工作流清晰度 | 12 | 10 | 12 | 已有 6 步 SOP 和确认门 | P1 |
| 失败模式编码 | 12 | 7 | 11 | 原有合规红线，缺关键失败模式清单 | P1 |
| 检查点设计 | 6 | 5 | 6 | 自审评分存在，发布验证缺失 | P1 |
| 可执行具体性 | 17 | 14 | 16 | 图 1-5 和模块清晰，安装说明可更短 | P1 |
| 资源整合度 | 4 | 3 | 4 | references/examples 存在，缺首页展示卡 | P2 |
| 整体架构 | 12 | 9 | 11 | 文件少而清楚，缺 marketplace 元数据 | P1 |
| 实测表现 | 23 | 12 | 20 | 缺自动验证脚本，示例可手动对账 | P0 |
| 反例与黑名单 | 7 | 5 | 7 | 合规词表已有，Skill 内需编码不要用于哪些场景 | P1 |
| 总分 | 100 | 70 | 94 | 以本次新增验证脚本和 README/SKILL 改写为目标 | P0 |

## 5. 慢刨改动

- 重写 `README.md`：首屏钩子、徽章、展示卡、效果示例、一行安装、触发方式、交付物、安全边界、验证说明。
- 重写 `SKILL.md`：强化 frontmatter、负触发、资质边界、用户确认门、失败模式和输出格式。
- 新增 `assets/showcase-output.svg`：GitHub 首屏可直接展示的输出卡。
- 新增 `tools/verify-skill.py`：零依赖发布检查和泄露扫描。
- 新增 `.claude-plugin/marketplace.json`：补 Claude plugin marketplace 元数据。

## 6. 回炉清单

- 发布后用 GitHub 页面检查 README 渲染，重点看 SVG、徽章、相对链接和代码块。
- 两周后查看 GitHub traffic，如果有浏览但 clone 少，优先补 demo GIF 或真实运行录屏。
- 下一轮可补 `README.en.md`，扩大英文 Agent Skill 生态传播面。
```

## File: examples/durian-worked-example.md
size: 5356
sha: 297b33af43179b7cb545ccc662f9e5cddc0a1f81
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/examples/durian-worked-example.md

```text
# 榴莲样稿：从一句话到执行卡

这是基于仓库既有展示图制作的**教学复盘**，不是历史真实对话或本次模型生图记录。只有成图，没有原商品资料，不能反过来把图片里的文字当作商品事实。

## 用户一句话输入

> 按这张榴莲样稿，给淘宝做一张场景图执行卡；商品的通用品类名确认用“榴莲礼盒”。保留奶油白和橄榄绿的视觉，别从图里补造产地、D197、认证、规格或价格。

## 原始材料与证据账本

E0为上述教学输入中用户确认的通用品类名，不等于品牌/原始SKU名已核验。E1 为[仓库既有榴莲样稿](https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/main/assets/showcase/musang-king-durian-main.jpg)。除此之外没有产品档案、标签原件、检测、产地或 SKU 资料。

| 项目 | 来源/范围 | 状态 | 处理 |
|---|---|---|---|
| 通用品类名“榴莲礼盒” | E0：教学用户输入 | 已确认（仅称呼/品类） | 可用于本次标题；不扩成品牌或产地证明 |
| 奶油白/橄榄绿、礼盒与果肉的画面关系 | E1：只能确认样稿外观 | 已确认（仅视觉） | 可作为视觉参考 |
| 猫山王、马来西亚、D197 | E1 里有字，缺原始商品证据 | 待补证 | 不作为新文案的事实依据 |
| 认证、重量、到手价、销量 | 未提供 | 待补证 | 不写，不补造 |
| 图片证明品质/味道/产地 | 图像不能证明 | 禁止这样推断 | 不进入宣称 |

**模式**：标准模式，先完成可支持的视觉规划；真实商品身份与证据是发布前缺口。主驱动力是视觉/质感，不凭图片升级成产地/认证驱动。

## Storyboard 与唯一确认点

| 编号 | 任务 | 画面方向 | 证据与缺口 |
|---|---|---|---|
| KV1 | 识别礼盒外观 | 原产品图、暖浅色台面、上方留白 | E1仅支持视觉参考；真实商品身份与宣称待补证 |

标准模式到这里合并提出必要补证与方向确认，只停一次。下面展示后续执行卡的结构，供教学审阅；不表示用户确认或补证已经发生。

## 单张执行卡

### KV1 — 礼盒外观识别

- 视觉任务：让用户辨认商品与礼盒场景，一张图只承担一个决策问题。
- 画面：参照 E1 的暖浅色背景、橄榄绿点缀和台面层次；正式生产时用经确认的原产品图，保留准确包装、件数与结构。示意图不能代替实拍证据。
- 图内文案：使用用户给出的通用品类名“榴莲礼盒”作主标题；原始SKU/品牌名仍待资料确认。不新增副文案、产地、价格或认证。
- 文字渲染方式：留白排版；上方预留干净文字区，后期叠字。1080px 宽时标题至少72px；必要注释至少36px、底部独立留白，并在约360px宽预览。
- 文案规格自检：标题“榴莲礼盒”4字，副文案0条，数字/证据标签0个；正式名称仍待核对。
- Campaign Style Lock：奶油白 + 橄榄绿、柔和棚光、真实产品比例；包装和 Logo 以正式原产品图为准，光影/道具可变，商品身份不可改。
- 生图 Prompt：以已确认的原产品图为主体，暖浅色台面、柔和棚光、橄榄绿细节点缀，上部保留干净留白供后期标题排版；不生成新的宣传字、价格、认证、产地或水印；包装保真失败时使用原产品图合成。
- Negative Prompt：包装结构/颜色/Logo/规格漂移、伪造 D197 或原产地、额外赠品、认证徽章、价格、宣传文字、水印。
- 证据/平台备注：E1 仅提供视觉参考。淘宝当前商品主图/场景图规则、真实商品名称、包装与资质尚待核验；不得把该执行草案标为可直接发布。

## 成图示意与差异

[查看完整既有样稿](https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/main/assets/showcase/musang-king-durian-main.jpg)。首屏把该图放在流程旁，便于看清视觉方向。**它不是上述新执行卡已完成的成图**：原图的产地/D197文字仍待补证；正式成图需采用确认后的产品资料，删除不支持的宣传文字，并完成逐字、包装与移动端验收。

## 自审记录

该稿缺原产品资料，证据与合规未过线，只交付已达标部分。

| 维度 | 分数 | 依据 | 重写了什么 |
|---|---|---|---|
| 证据与合规 | 70 | 未证实宣称已排除，但原产地、真实商品名和包装资料缺失，必要条件①无法满足 | 删除不支持的宣传文字 |
| 转化逻辑 | 85 | 仅承担商品识别，首图可识别品类 | 无 |
| 视觉层级 | 82 | 执行卡规定了留白与字号；实际成图待验收 | 无 |
| 一致性 | 80 | 已列 Style Lock；原产品图未齐，保真待验收 | 无 |
| 可执行性 | 70 | 只有结构示例，缺指定SKU原产品图；不能当作可直接生图的正式执行卡 | 保留视觉准备方案，不标成正式执行卡 |
- 机械检查：未运行（教学样例，不冒充工具运行记录）
- 重写轮次：1
- 未达标项：证据与合规、可执行性（缺原产品资料与资质原件），补齐后重新自审

这次示例说明 Skill 增加的是可追溯证据、任务分工、风格约束与交接细节，不能把漂亮样稿当作商业宣称已经成立。
```

## File: LICENSE
size: 1096
sha: 3b609fcfb97145a57c54792548964b82f70b8212
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/LICENSE

```text
MIT License

Copyright (c) 2026 OpenClaw Community

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
```

## File: README.en.md
size: 18337
sha: a9aa804d9ac8d13cc5c2e3ab0225014dc733e5b8
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/README.en.md

Content is not inlined in the catalog. Read the upstream file: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/README.en.md

## File: ROADMAP.md
size: 2518
sha: 9bea8f4e984dfd986a4f4c27b694ebe49001c6b5
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/ROADMAP.md

```text
# Roadmap

`SKILL.md` is the canonical v3 entrypoint. This roadmap tracks maintained capabilities and remaining work; it does not promise release dates.

## Current baseline

- Four modes: Standard, One-shot, Audit/revision, Designer handoff.
- Evidence ledger → conversion driver → Campaign Style Lock → Storyboard → execution cards → hard blockers and the five-dimension 80-point self-review with its record.
- Dynamic image counts, reference fidelity, negative constraints, and cross-border localization.
- Six conversion drivers, including price/bundle/promotion.
- Copy limits, mobile readability, and post-production typography by default.
- Separate platform playbooks, output contracts, and official source notes.
- Chinese and full English skill companions with section-alignment checks.
- Lightweight showcase assets, a worked example, and installation guidance for Codex, Claude Code, and Claude.ai.

## This maintenance update

- [x] Fix case-sensitive verification and add regression checks.
- [x] Replace the obsolete v1 showcase overview.
- [x] Archive the historical polishing report outside active guidance.
- [x] Reduce current showcase assets; preserve the complete durian thumbnail.
- [x] Add GitHub Actions verification, issue/PR templates, and a changelog.
- [x] Add machine-checkable prompt expectations and an output evaluator.

The repository already has [v3.0.0](https://github.com/feichanggege/ecommerce-visual-copywriting-skill/releases/tag/v3.0.0). New changes remain **Unreleased** until a maintainer reviews and publishes them. A workflow file alone does not prove a successful remote CI run.

## Next work, when supported by real cases

- Collect permitted, redacted agent outputs across runtimes; review semantic quality alongside lexical checks.
- Add category/market-specific examples when real evidence is available.
- Refresh login-only platform rules with official documents supplied by maintainers.
- Add a screen recording of an actual run, with its product evidence and model/runtime recorded.
- Review whether historical large Git objects warrant migration. Reducing current assets does not remove old objects; history rewriting needs a separate maintenance decision.

## Contribution standard

Use [CONTRIBUTING.md](CONTRIBUTING.md). Rule changes need applicable official sources, an affected example, matching Chinese/English updates, and validation evidence. No invented product facts, approval guarantees, arbitrary scoring thresholds, or automatic publication.
```

## File: SKILL.en.md
size: 42583
sha: 5294167be2fe4eee776259c9cfcb3c03c8d3ea5e
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/SKILL.en.md

Content is not inlined in the catalog. Read the upstream file: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/SKILL.en.md

## File: test-prompts.json
size: 26331
sha: a624ef22b3a18833b23e65f18a3b5710c9469dee
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/test-prompts.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/test-prompts.json

## File: tests/test_validation.py
size: 8371
sha: a6b71fe40383b97db00e849fe6c694c52458cd15
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/tests/test_validation.py

```text
"""Regression checks for the verifier, saved-output evaluator and upload package."""
import copy
import importlib.util
import json
import runpy
import tempfile
import unittest
from pathlib import Path
from zipfile import ZipFile

ROOT = Path(__file__).resolve().parents[1]

def load(filename):
    spec = importlib.util.spec_from_file_location(filename.replace("-", "_"), ROOT / "tools" / filename)
    module = importlib.util.module_from_spec(spec)
    spec.loader.exec_module(module)
    return module

verifier = load("verify-skill.py")
evaluator = load("evaluate-prompts.py")
packager = load("package-skill.py")
count_copy = runpy.run_path(str(ROOT / "scripts/count-copy.py"))["count"]
scan_copy = runpy.run_path(str(ROOT / "scripts/scan-final-copy.py"))["scan"]

class ValidationRegression(unittest.TestCase):
    def setUp(self):
        self.case = {
            "name": "food", "prompt": "普通食品详情页", "expected_behavior": ["排除功效"],
            "must_include": [["证据账本", "evidence ledger"]],
            "must_not_include": ["乌发", "FDA approved"], "final_copy_required": True,
        }

    def test_copy_counts_use_final_strings_including_punctuation(self):
        self.assertEqual(count_copy("小厨房，按需伸缩", "zh"), 8)
        self.assertEqual(count_copy("按需伸缩，适配台面", "zh"), 9)
        self.assertEqual(count_copy("小厨房也能灵活收纳", "zh"), 9)
        self.assertEqual(count_copy("39元\t 2只", "zh"), 5)
        self.assertEqual(count_copy("See the mechanism before choosing a size", "en"), 7)

    def test_real_lowercase_english_ledger_is_accepted(self):
        english = (ROOT / "SKILL.en.md").read_text(encoding="utf-8").replace("Evidence ledger", "evidence ledger")
        verifier.require_text("SKILL.en.md", english, ["Evidence ledger"])
        with self.assertRaisesRegex(ValueError, "missing expected text"):
            verifier.require_text("SKILL.en.md", "unrelated content", ["Evidence ledger"])

    def test_missing_english_failure_section_is_rejected(self):
        chinese = (ROOT / "SKILL.md").read_text(encoding="utf-8")
        english = (ROOT / "SKILL.en.md").read_text(encoding="utf-8")
        verifier.check_bilingual_sections(chinese, english)
        with self.assertRaisesRegex(ValueError, "bilingual contract"):
            verifier.check_bilingual_sections(chinese, english.replace("## Key failure modes", "### Key failure modes"))

    def test_analysis_may_quote_risky_phrase_but_final_copy_may_not(self):
        response = {"name": "food", "response": "Evidence ledger: 不使用乌发。最终稿：黑芝麻食品", "final_copy": "黑芝麻食品"}
        self.assertEqual(evaluator.evaluate([self.case], [response]), [])
        response["final_copy"] = "乌发"
        failures = evaluator.evaluate([self.case], [response])
        self.assertTrue(any("forbidden final-copy phrase" in item for item in failures))

    def test_missing_markers_empty_final_and_selective_rewrite_are_rejected(self):
        response = {"name": "food", "response": "普通食品", "final_copy": ""}
        failures = evaluator.evaluate([self.case], [response])
        self.assertTrue(any("final_copy is required" in item for item in failures))
        self.assertTrue(any("missing required marker" in item for item in failures))
        response.update(response="证据账本：乌发", final_copy="黑芝麻食品")
        self.assertTrue(any("exact excerpt" in item for item in evaluator.evaluate([self.case], [response])))

    def test_markers_ignore_case_but_final_copy_preserves_exact_source(self):
        response = {"name": "food", "response": "EVIDENCE LEDGER. Final copy: SKU ABC", "final_copy": "SKU ABC"}
        self.assertEqual(evaluator.evaluate([self.case], [response]), [])
        response["final_copy"] = "sku abc"
        self.assertTrue(any("exact excerpt" in item for item in evaluator.evaluate([self.case], [response])))

    def test_required_visible_conditions_cannot_exist_only_in_analysis(self):
        case = dict(self.case, must_include_final=[["测试条件", "test conditions"], "低档"])
        response = {"name": "food", "response": "证据账本：测试条件为低档。最终稿：风扇", "final_copy": "风扇"}
        self.assertEqual(sum("required final-copy marker" in item for item in evaluator.evaluate([case], [response])), 2)
        response.update(response="证据账本。最终稿：风扇；TEST CONDITIONS：低档", final_copy="风扇；TEST CONDITIONS：低档")
        self.assertEqual(evaluator.evaluate([case], [response]), [])
        with self.assertRaisesRegex(ValueError, "must_include_final"):
            evaluator.validate_cases([dict(case, must_include_final=[])])

    def test_duplicate_unknown_missing_and_invalid_case_are_rejected(self):
        response = {"name": "food", "response": "证据账本：黑芝麻食品", "final_copy": "黑芝麻食品"}
        with self.assertRaisesRegex(ValueError, "duplicate response"):
            evaluator.evaluate([self.case], [response, response])
        with self.assertRaisesRegex(ValueError, "unknown response"):
            evaluator.evaluate([self.case], [dict(response, name="unknown")])
        self.assertTrue(any("missing response" in item for item in evaluator.evaluate([self.case], [])))
        broken = copy.deepcopy(self.case)
        broken["must_not_include"] = [["乌发"]]
        with self.assertRaisesRegex(ValueError, "invalid must_not_include"):
            evaluator.validate_cases([broken])

    def test_local_file_links_are_checked_relative_to_document(self):
        with tempfile.TemporaryDirectory() as folder:
            root = Path(folder)
            doc = root / "README.md"
            (root / "a b.md").write_text("ok", encoding="utf-8")
            verifier.check_local_links(root, doc, "[valid](a%20b.md) [web](https://example.com)")
            verifier.check_local_links(root, doc, '[valid](a%20b.md "A title") [angle](<a b.md> "A title")')
            with self.assertRaisesRegex(ValueError, "broken local file link"):
                verifier.check_local_links(root, doc, '<img src="missing.jpg">')
            with self.assertRaisesRegex(ValueError, "broken local file link"):
                verifier.check_local_links(root, doc, "[escape](../outside.md)")

    def test_upload_zip_has_one_skill_root_and_all_runtime_references(self):
        with tempfile.TemporaryDirectory() as folder:
            output = Path(folder) / "skill.zip"
            packager.package(output)
            with ZipFile(output) as archive:
                self.assertIsNone(archive.testzip())
                names = archive.namelist()
                prefix = "ecommerce-visual-copywriting/"
                self.assertTrue(all(name.startswith(prefix) for name in names))
                for file in ["SKILL.md", "SKILL.en.md", "references/output-contracts.md",
                             "references/source-notes.md", "examples/durian-worked-example.md", "scripts/count-copy.py",
                             "references/copy-quality-rules.md", "references/category-notes.md", "scripts/scan-final-copy.py"]:
                    self.assertIn(prefix + file, names)
                self.assertFalse(any("/.git/" in name or "/assets/" in name or "/tests/" in name or "/docs/" in name for name in names))
            with self.assertRaisesRegex(ValueError, "overwrite a runtime resource"):
                packager.package(ROOT / "SKILL.md")

    def test_repository_checks_and_all_prompt_schemas(self):
        cases = json.loads((ROOT / "test-prompts.json").read_text(encoding="utf-8"))
        self.assertEqual(len(evaluator.validate_cases(cases)), 31)
        verifier.verify()

    def test_final_copy_scan_flags_placeholders_but_not_clean_copy(self):
        self.assertIn("待补/待确认/待核", scan_copy("承重（待补）")["hard"])
        self.assertIn("未提供类括注", scan_copy("尺寸（参数表未提供）")["hard"])
        self.assertEqual(scan_copy("沾到水或汗后，及时擦干再收好")["hard"], [])
        self.assertIn("内部建议口吻", scan_copy("建议：加一行规格")["soft"])
        self.assertIn("暂定/拟定", scan_copy("价格暂定")["soft"])
        self.assertEqual(scan_copy("价格暂定")["hard"], [])

if __name__ == "__main__":
    unittest.main()
```

## File: tools/evaluate-prompts.py
size: 5509
sha: 2aecc77f1e3b6881fbab6a737894094df739b6f6
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/tools/evaluate-prompts.py

```text
#!/usr/bin/env python3
"""Check saved agent responses; no API calls and no model-generated test results."""
from __future__ import annotations

import argparse
import json
from pathlib import Path

def validate_cases(cases: object) -> list[dict]:
    if not isinstance(cases, list) or not cases:
        raise ValueError("cases must be a non-empty JSON array")
    names = set()
    for case in cases:
        if not isinstance(case, dict):
            raise ValueError("each case must be an object")
        name = case.get("name")
        if not isinstance(name, str) or not name or name in names:
            raise ValueError("case names must be non-empty and unique")
        names.add(name)
        for field in ("prompt",):
            if not isinstance(case.get(field), str) or not case[field].strip():
                raise ValueError(f"{name}: {field} must be non-empty text")
        if not isinstance(case.get("expected_behavior"), list) or not case["expected_behavior"] or not all(
            isinstance(item, str) and item.strip() for item in case["expected_behavior"]
        ):
            raise ValueError(f"{name}: expected_behavior must be a non-empty text array")
        for field in ("must_include", "must_not_include", "must_include_final"):
            if field == "must_include_final" and field not in case:
                continue
            values = case.get(field)
            if not isinstance(values, list) or not values:
                raise ValueError(f"{name}: {field} must be a non-empty array")
            for value in values:
                alternatives = value if isinstance(value, list) and field != "must_not_include" else [value]
                if not alternatives or not all(isinstance(item, str) and item.strip() for item in alternatives):
                    raise ValueError(f"{name}: invalid {field} matcher")
        if not isinstance(case.get("final_copy_required"), bool):
            raise ValueError(f"{name}: final_copy_required must be boolean")
    return cases

def evaluate(cases: list[dict], responses: object) -> list[str]:
    validate_cases(cases)
    if not isinstance(responses, list):
        raise ValueError("responses must be a JSON array")
    by_name = {}
    for item in responses:
        if not isinstance(item, dict) or not isinstance(item.get("name"), str):
            raise ValueError("each response needs a name")
        if item["name"] in by_name:
            raise ValueError(f"duplicate response: {item['name']}")
        if not isinstance(item.get("response"), str) or not item["response"].strip():
            raise ValueError(f"{item['name']}: response must be non-empty text")
        if not isinstance(item.get("final_copy"), str):
            raise ValueError(f"{item['name']}: final_copy must be text, empty only for blocked/strategy outputs")
        by_name[item["name"]] = item
    known = {case["name"] for case in cases}
    if set(by_name) - known:
        raise ValueError(f"unknown response names: {sorted(set(by_name) - known)}")
    failures = []
    for case in cases:
        name = case["name"]
        item = by_name.get(name)
        if item is None:
            failures.append(f"{name}: missing response")
            continue
        answer, final = item["response"].casefold(), item["final_copy"].casefold()
        if case["final_copy_required"] and not final.strip():
            failures.append(f"{name}: final_copy is required")
        # Prevent checking an unrelated or selectively rewritten final-copy field.
        if item["final_copy"].strip() and item["final_copy"] not in item["response"]:
            failures.append(f"{name}: final_copy must be an exact excerpt of response")
        for matcher in case["must_include"]:
            alternatives = matcher if isinstance(matcher, list) else [matcher]
            if not any(value.casefold() in answer for value in alternatives):
                failures.append(f"{name}: missing required marker {matcher!r}")
        # Required visible sources/conditions cannot be satisfied by analysis alone.
        for matcher in case.get("must_include_final", []):
            alternatives = matcher if isinstance(matcher, list) else [matcher]
            if not any(value.casefold() in final for value in alternatives):
                failures.append(f"{name}: missing required final-copy marker {matcher!r}")
        # Forbidden claims are checked ONLY in publishable copy, not quoted risk analysis.
        for value in case["must_not_include"]:
            if value.casefold() in final:
                failures.append(f"{name}: forbidden final-copy phrase {value!r}")
    return failures

def main() -> int:
    parser = argparse.ArgumentParser(description=__doc__)
    parser.add_argument("--cases", type=Path, default=Path(__file__).resolve().parents[1] / "test-prompts.json")
    parser.add_argument("--responses", type=Path, required=True)
    args = parser.parse_args()
    try:
        cases = json.loads(args.cases.read_text(encoding="utf-8"))
        responses = json.loads(args.responses.read_text(encoding="utf-8"))
        failures = evaluate(cases, responses)
    except (OSError, ValueError) as exc:
        print(f"FAIL: {exc}")
        return 1
    for failure in failures:
        print(f"FAIL: {failure}")
    if failures:
        return 1
    print(f"PASS: {len(cases)} saved responses met lexical expectations; semantic/visual review is separate")
    return 0

if __name__ == "__main__":
    raise SystemExit(main())
```

## File: tools/package-skill.py
size: 1732
sha: cc34da15843f1ca1db274f165cabd2c422f683db
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/tools/package-skill.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/tools/package-skill.py

## File: tools/verify-skill.py
size: 12752
sha: 13fe6f6d5c43b5ee8e3d1bd45f930d50a796b600
upstream: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/tools/verify-skill.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/feichanggege/ecommerce-visual-copywriting-skill/blob/HEAD/tools/verify-skill.py
