mcpField
E
ecommerce-visual-copywriting

ecommerce-visual-copywriting

github.com/feichanggegeマーケティング・グロース977278 回インストール1 日前に更新
リポジトリ

ecommerce-visual-copywriting について

ecommerce-visual-copywritingは、商品情報をデザイナーや画像生成モデル向けのビジュアル案と制作文案に変換するスキルです。根拠に基づく表現、商品の一貫性、コンプライアンス確認を重視します。

主な機能

  1. 01必要な成果物に応じたタスク振り分け
  2. 02訴求内容の根拠管理
  3. 03ビジュアルスタイルの統一
  4. 04ストーリーボードと画像生成プロンプト
  5. 05コンプライアンスと成果物の確認

活用シーン

  1. 01商品画像や詳細ページの企画
  2. 02デザイナー向け引き継ぎ資料の作成
  3. 03既存の文案やビジュアルのレビュー
  4. 04他市場向けのEC素材のローカライズ

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/feichanggege/ecommerce-visual-copywriting-skill --skill ecommerce-visual-copywriting

インストール後、Claude Code で/ecommerce-visual-copywritingを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

CONTRIBUTING.md
README.en.md
README.md
ROADMAP.md
SKILL.en.md
LICENSE
test-prompts.json
.claude-plugin/
marketplace.json
agents/
openai.yaml
docs/
skill-polishing-report.md
examples/
README.md
references/
compliance-rules.md
output-contracts.md
platform-playbooks.md
tools/
verify-skill.py

詳細

电商视觉策划与执行

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

运行原则

  1. 证据优先:用户提供的包装、参数、资质、检测、品牌资料和明确事实 > 已核验的官方最新平台规则 > 本 Skill 的参考资料 > 合理假设。
  2. 按任务路由:只交付用户需要的层级,不强制走完整流程;不要为了“流程完整”重复追问已知信息。
  3. 不把假设写成事实:缺资料时标记“待确认”,不要补造销量、评价、证书、检测、专利、资质、功效、排名或平台规则。
  4. 先统一视觉,再写细节:同一套图必须先锁定产品身份、构图、色彩、光影、字体、背景和禁止漂移项。
  5. 平台规则有时效性:涉及当前尺寸、禁限词、类目政策、主图要求、资质或审核规则时,优先查官方最新来源;无法核验时明确标记“未核验”,不要凭旧规则下结论。
  6. 高风险合规不做最终法律结论:食品、保健品、医疗器械、健康护理、儿童用品等场景,按保守口径处理,并说明需要以目标市场法律、监管和平台最新规则为准。

执行模式

根据用户意图自动选择,不要机械暂停。

A. 标准模式

适用于方向不清、视觉成本高、用户明确要求“先策划/先分镜/确认后再做”。

  1. 先输出《视觉策略与证据账本》。
  2. 再输出 Storyboard。
  3. 在真正进入大量最终文案或生图 Prompt 前等待确认。
B. 一次性交付模式

用户明确说“直接出完整方案”“一次性给我”“按你判断做完”,或资料已经足够明确时,直接完成策略、Storyboard、执行稿和质量门,不做不必要的中途确认。

C. 审查/改稿模式

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

  • 转化逻辑问题
  • 视觉层级问题
  • 证据或合规问题
  • 平台适配问题
  • 文案与画面不一致
  • 风格漂移
D. 设计师交接模式

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

Step 0:任务路由与最小输入

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

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

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

只有缺失信息会改变定位、合规边界或关键画面时才追问,最多追问 3 个关键问题;其余缺失项采用最合理假设继续,并显式标注假设。

Step 1:建立证据账本

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

宣称/卖点来源状态最终处理
包装或资料明确写明用户资料已确认可使用,保持原意
可由参数直接推导用户资料有依据可转成利益表达,但不扩大
需要检测/认证/平台规则支持缺少证据待补证改中性表达或保留占位
涉及治疗、保证性效果、虚构背书无合法依据禁止不进入最终稿

最终稿只能使用“已确认”或“有依据”的内容。“待补证”必须转为中性表达、占位符或待确认项。

Step 2:判断成交驱动力

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

驱动力典型场景视觉重点
视觉/质感美妆、饰品、家居、礼盒材质、光影、比例、包装、氛围
痛点/效率清洁、收纳、工具、生活用品问题场景、使用前后、步骤缩短
理性/参数3C、家电、设备、功能型商品参数翻译、机制、规格、兼容性
信任/证据食品、茶饮、母婴、高客单商品产地、工艺、资质、检测、品牌证据
情绪/身份香氛、服饰、礼赠、宠物、生活方式场景、审美、仪式感、身份认同

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

只保留 Top 3 购买理由。没有证据支撑的“猛卖点”不因为转化需要而放宽边界。

Step 3:锁定 Campaign Style Lock

至少明确:

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

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

Step 4:规划 Storyboard

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

常见主图任务:

角色任务
Hero / KV一眼识别产品 + 单一核心购买理由
Benefit把核心参数或功能翻译成用户收益
Proof用真实证据建立信任
Compare用客观维度降低选择成本,不虚构竞品数据
Scene放入真实使用场景,强化代入
Spec / CTA规格、组合、适用条件或下一步决策信息

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

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

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

涉及 Amazon、Shopify、TikTok Shop、Temu、Shopee、Lazada、淘宝、天猫、京东、拼多多、抖音小店等平台时,读取 references/platform-playbooks.md。如果用户问的是当前具体审核规则、尺寸、禁词或类目要求,优先核验官方最新规则。

Step 5:执行输出

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

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

跨境场景不要逐字翻译中文卖点。做本地化:保留事实边界,调整表达习惯、单位、场景、购买理由和信息密度。

Step 6:五维质量门

先检查硬性阻断项,再做质量判断。

硬性阻断项

出现任一项,不能直接交付最终稿:

  • 编造或无法追溯的资质、检测、认证、销量、评价、排名、专利、数据。
  • 产品身份与用户素材冲突,例如包装、规格、颜色、Logo、结构被改错。
  • 把“待补证”内容写成确定事实。
  • 当前平台规则未核验却写成“平台明确规定”。
  • 高风险品类使用治疗、保证性效果或扩大批准范围的表达。
五维 Pass/Fail
维度Pass 条件
证据与合规关键宣称可追溯,风险项已降级或删除
转化逻辑每张图有独立决策任务,Top 3 购买理由清楚
视觉层级第一落点明确,文字密度和主体比例合理
一致性Style Lock、产品身份、字体、色彩、光影不漂移
可执行性设计师或生图模型无需猜关键元素即可执行

任一维度 Fail,就修对应问题后再交付。不要用其他维度的高分抵消。

如果用户明确要求量化评分,可使用 1–5 分并给出每一分的可解释依据;不要用没有锚点的“80/100”制造伪精确。

コンプライアンスと最新性

コンプライアンスに関わる場合は、references/compliance-rules.md を読み込んでください。このファイルは保守的に運用するためのフレームワークであり、法律上の助言ではありません。

特に注意してください:

  • 免責事項を付けても、それ自体が許容されない表現を「修正」することはできません。
  • 絶対的な表現、比較、価格、認証、健康・医療、効果、ユーザー評価などに関する表現は、証拠と対象市場を確認する必要があります。
  • 一般食品、保健食品・栄養補助食品、医療機器、ヘルスケア用品、子ども向け用品などに、同じ宣伝表現の基準を使い回すことはできません。
  • プラットフォームのルール、法律、規制方針、カテゴリ要件は変わる可能性があります。インターネットに接続できる場合や公式文書がある場合は、そちらを優先して確認してください。

参考ファイルの読み込みルール

必要なときだけ読み込み、コンテキストを無駄に消費しないようにしてください:

  • references/compliance-rules.md:コンプライアンス審査、高リスクカテゴリ、データ・効果・資格に関する表現。
  • references/platform-playbooks.md:プラットフォームごとの差異、ページのタスク分担、越境シーン。
  • references/output-contracts.md:完全な実行原稿、デザイナーへの引き継ぎ、審査レポートの固定構成。
  • examples/README.md:入出力例が必要な場合。

主な失敗パターン

  • 過剰な質問:資料が十分にあるのに質問を続けること。前提を明示して作業を進めてください。
  • 手順の機械的な適用:ユーザーが一括での完全な納品を求めているのに、強制的に2回中断すること。実行モードに従ってください。
  • 固定の5枚構成:プラットフォームや情報量を考慮せず、無理に5枚にすること。ビジュアル上のタスクに応じて枚数を調整してください。
  • 訴求点の詰め込み:1枚の画像に複数の購入理由を詰め込むこと。各画像で解決する主な意思決定上の問題は1つだけにしてください。
  • 古いプラットフォームルール:過去の経験を現在のルールとして記載すること。必要に応じて、公式の最新情報を確認してください。
  • センシティブワードだけに頼ったコンプライアンス対応:単語を削除するだけで、表現の論理を確認しないこと。「事実 -> 証拠 -> ユーザーの受け取り方」を必ず確認してください。
  • 越境向けの直訳:中国語のコピーを一語ずつ翻訳すること。現地に合わせて書き直してください。
  • 参考画像による実物との乖離:見た目を優先し、製品の構造やパッケージを勝手に変えること。製品の忠実な再現を優先してください。

E-commerce Visual Copywriting v3.0 · Canonical entrypoint: SKILL.md

コメント