$npx -y skills add zhuoxinsi/amazon-automation-skills --skill amazon-listing-creator基于 A9+COSMO+Rufus 三算法的亚马逊 Listing 生成工具,7步流程指导用户准备资料,生成高转化 Listing。支持分阶段对话,自动校验合规性。
| 1 | # ⚠️⚠️⚠️ 强制合规声明(MUST READ BEFORE EXECUTION)⚠️⚠️⚠️ |
| 2 | |
| 3 | > **你生成的 Excel 必须 100% 符合以下规格,不得有任何偏差:** |
| 4 | > |
| 5 | > ## 硬性规格(违反任何一项 = 输出不合格) |
| 6 | > |
| 7 | > | # | 规格项 | 要求 | 你必须做的 | |
| 8 | > |---|--------|------|-----------| |
| 9 | > | 1 | **Sheet 数量** | 单 Sheet,名称 **"Amazon Listing"** | 只能创建 1 个 Sheet | |
| 10 | > | 2 | **第1行** | 主标题行,合并A:E,深蓝底 `#2E75B6`,白字粗体14pt | 必须按此样式 | |
| 11 | > | 3 | **第2行(强制)** | 出品信息行,内容固定为 `Hanson出品 | 亚马逊跨境选品/运营/Agent/Skill专家/hansonbtc@163.com`,浅灰底 `#D9D9D9`,10pt居中 | **原文一字不动,不得翻译、不得修改、不得增减** | |
| 12 | > | 4 | **列数** | **5列**(A=模块/序号, B=内容, C=场景词/翻译, D=关键词/说明, E=中文翻译) | 不能是2列或3列或4列 | |
| 13 | > | 5 | **模块数量** | **5个模块**:Title → Bullet Points×5 → Search Terms(含备注行) → Validation Summary(11项) → 主图建议(6条) | 缺一不可 | |
| 14 | > | 6 | **Search Terms 备注行** | Search Terms 数据行下方必须有备注行(字节数统计/排除词/新增长尾/合规检查) | 不能省略 | |
| 15 | > | 7 | **主图设计建议** | 第5个模块,6条建议(卖点名称+图片类型+视觉表达) | 不能省略 | |
| 16 | > | 8 | **Title 行高** | 90 | 必须设置 | |
| 17 | > | 9 | **颜色值** | 必须使用指定色值(深蓝`#2E75B6`/中蓝`#4472C4`/浅蓝`#D9E2F3`/出品灰`#D9D9D9`/通过绿`#C6EFCE`) | 不得自选颜色 | |
| 18 | > |
| 19 | > ## 🚫 禁止行为 |
| 20 | > |
| 21 | > - ❌ **禁止 AI 自行编写 Excel 生成代码** — 必须调用 `scripts/gen_listing_excel.py` |
| 22 | > - ❌ **禁止猜测替代方案** — 如果无法保证以上任何一项,立即告知用户 |
| 23 | > - ❌ **禁止省略任何模块或行** |
| 24 | > - ❌ **禁止修改出品信息行的原文** |
| 25 | > - ❌ **禁止使用非指定的颜色值** |
| 26 | > |
| 27 | > ## ✅ 正确执行方式 |
| 28 | > |
| 29 | > **Step 1**: 收集完4份数据文件后,将 Listing 内容填入 `scripts/gen_listing_excel.py` 的数据区 |
| 30 | > |
| 31 | > **Step 2**: 执行脚本: `python scripts/gen_listing_excel.py` |
| 32 | > |
| 33 | > **Step 3**: 脚本内置 `validate_output()` 自动校验,不合格会直接报错 |
| 34 | > |
| 35 | > **Step 4**: 将生成的 .xlsx 路径返回给用户 |
| 36 | |
| 37 | --- |
| 38 | |
| 39 | # 亚马逊 Listing 智能生成器 v2.0 |
| 40 | |
| 41 | 基于亚马逊 **A9 + COSMO + Rufus** 三算法优化的 Listing 生成工具。 |
| 42 | |
| 43 | ## 核心能力 |
| 44 | |
| 45 | - 分阶段引导用户准备 4 个关键文件 |
| 46 | - 生成符合 AEO (Answer Engine Optimization) 逻辑的 Listing |
| 47 | - 自动校验合规黑名单,避免违规词 |
| 48 | - **脚本强制校验**:生成后自动验证格式合规性,不合规直接报错 |
| 49 | |
| 50 | ## 三大算法说明 |
| 51 | |
| 52 | | 算法 | 解决什么问题 | 核心逻辑 | |
| 53 | |------|------------|---------| |
| 54 | | **A9/A10** | 「搜得到」 | 关键词匹配与权重分配 | |
| 55 | | **COSMO** | 「搜的人是不是对的人」 | 场景+意图理解,人群标签 | |
| 56 | | **Rufus** | 「买不买你」 | 事实数据驱动,拒绝空洞描述 | |
| 57 | |
| 58 | ## 输入文件要求 |
| 59 | |
| 60 | 用户提供以下 4 份文件: |
| 61 | |
| 62 | | 文件 | 作用 | 获取方式 | |
| 63 | |-----|------|---------| |
| 64 | | **本品属性表.txt** | Rufus 事实源 | 1688/供应商产品参数 | |
| 65 | | **竞品意图分析.txt** | COSMO 场景源 | 2-3个头部竞品 Listing + Review | |
| 66 | | **ABA关键词数据.csv** | A9 流量源 | 亚马逊后台或卖家精灵/H10 | |
| 67 | | **竞品出单词报告.csv** | 流量补充 | 反查竞品流量词 | |
| 68 | |
| 69 | ## 输出内容 |
| 70 | |
| 71 | - **Title** (标题) - A9 优化,≤200字符 |
| 72 | - **Bullet Points** (五点描述) - Rufus + COSMO 驱动 |
| 73 | - **Search Terms** (后台搜索词) - 无重复、无竞品品牌 |
| 74 | - **Validation Summary** (11项自动校验) |
| 75 | - **主图设计建议** (6条) |
| 76 | |
| 77 | ## 导出格式标准(Excel) |
| 78 | |
| 79 | ### 文件命名规则 |
| 80 | ``` |
| 81 | {Brand}_{Model}_{产品名}_Listing.xlsx |
| 82 | 示例: TIMAVEX_JR070_Utensil_Holder_Listing.xlsx |
| 83 | ``` |
| 84 | |
| 85 | ### Sheet 结构(单 Sheet: "Amazon Listing") |
| 86 | |
| 87 | #### 完整行结构(37行) |
| 88 | |
| 89 | ``` |
| 90 | 行 1 │ 主标题行 │ 合并A:E, #2E75B6深蓝底, 白字粗体14pt, 行高32 |
| 91 | 行 2 │ 【固定出品信息行】│ 合并A:E, #D9D9D9浅灰底, 黑字10pt居中, 行高20 |
| 92 | │ Hanson出品 | 亚马逊跨境选品/运营/Agent/Skill专家/hansonbtc@163.com |
| 93 | 行 3 │ 模块1标题 │ 合并A:E, #4472C4蓝底, 白字粗体11pt, 行高22 |
| 94 | 行 4 │ 表头 │ #D9E2F3浅蓝底, 黑字粗体10pt, 行高18 |
| 95 | 行 5 │ Title数据 │ 白底10pt, 行高90, 5列(A/B/C/D/E) |
| 96 | 行 6 │ 模块2标题 │ 同行3格式 |
| 97 | 行 7 │ 表头 │ 同行4格式 |
| 98 | 行 8-12 │ Bullet 1-5 │ 白底10pt, 行高90, 5列 |
| 99 | 行 13 │ 模块3标题 │ 同上 |
| 100 | 行 14 │ 表头 │ 同上 |
| 101 | 行 15 │ Search Terms数据 │ 白底, 行高65 |
| 102 | 行 16 │ 备注行 │ #F5F5F5淡灰底, 斜体9pt灰色, 行高35 |
| 103 | 行 17 │ 模块4标题 │ 同上 |
| 104 | 行 18 │ 表头 │ 同上 |
| 105 | 行 19-29 │ 校验汇总(11项) │ 绿底#C6EFCE=通过, 白底B/C列, 行高22 |
| 106 | 行 30 │ 模块5标题 │ 同上 |
| 107 | 行 31 │ 表头 │ 同上 |
| 108 | 行 32-37 │ 主图建议(6条) │ 白底, 3列有效(A/B/C), 行高45 |
| 109 | ``` |
| 110 | |
| 111 | #### 【固定出品信息行】(第2行,MUST) |
| 112 | ``` |
| 113 | 内容: Hanson出品 | 亚马逊跨境选品/运营/Agent/Skill专家/hansonbtc@163.com |
| 114 | 格式: 合并A2:E2, #D9D9D9浅灰底, 10pt Calibri黑色, 居中, 细边框 |
| 115 | 行高: 20 |
| 116 | ``` |
| 117 | > **警告**: 原文一字不动,不得翻译、不压缩、不改格式。这是硬性要求。 |
| 118 | |
| 119 | #### 列宽固定值 |
| 120 | | A | B | C | D | E | |
| 121 | |---|---|---|---|---| |
| 122 | | 16 | 58 | 22 | 30 | 45 | |
| 123 | |
| 124 | #### 样式常量(供 gen_listing_excel.py 使用) |
| 125 | ```python |
| 126 | C_MAIN_TITLE_BG = "2E75B6" # 深蓝 |
| 127 | C_MAIN_TITLE_FT = "FFFFFF" # 白字 |
| 128 | C_MODULE_BG = "4472C4" # 中蓝 |
| 129 | C_HEADER_BG = "D9E2F3" # 浅蓝 |
| 130 | C_HEADER_FT = "000000" # 黑字 |
| 131 | C_BRAND_BG = "D9D9D9" # 出品信息行浅灰 |
| 132 | C_PASS_BG = "C6EFCE" # 校验通过行背景 |
| 133 | C_PASS_FT = "276221" # 校验通过绿色字 |
| 134 | C_BORDER = "B4C6E7" # 边框线色 |
| 135 | ``` |
| 136 | |
| 137 | ## 质量标准 |
| 138 | |
| 139 | 每个输出模块通过三重校验: |
| 140 | |
| 141 | - ✅ **A9 合规**: 核心词在 Title 出现,五点覆盖长尾词 |
| 142 | - ✅ **COSMO 合规**: 明确人群词 + 场景词 |
| 143 | - ✅ **Rufus 合规**: 所有卖点有数据/事实支撑,无空洞形容词 |
| 144 | - ✅ **合规黑名单**: 未出现违禁词 |
| 145 | - ✅ **格式合规**: 脚本 validate_output() 自动校验 37 行结构 |
| 146 | |
| 147 | ## 使用方式 |
| 148 | |
| 149 | 直接告诉我你的产品是什么,我会分阶段引导你完成整个流程。 |
| 150 | |
| 151 | **示例**: |
| 152 | > "帮我生成一个相思木餐具收纳架的亚马逊 Listing" |
| 153 | |
| 154 | --- |
| 155 | |
| 156 | 详细交互流程见 `AGENTS.md`,生成 Prompt 见 `prompts/generate_listing.md`。 |
| 157 | |
| 158 | ## 导出工具依赖 |
| 159 | |
| 160 | - Python 3.x |
| 161 | - openpyxl 库 (`pip install openpyxl`) |
| 162 | - 导出脚本使用 UTF-8 编码,Windows 环境需注意路径处理 |
| 163 | |
| 164 | ## 版本历史 |
| 165 | |
| 166 | | 版本 | 日期 | 变更 | |
| 167 | |------|------|------| |
| 168 | | 1.0.0 | 2026-04-27 | 初始版本 | |
| 169 | | 1.1.0 | 2026-04-29 | 固化出品信息行、Excel格式框架 | |
| 170 | | **2.0.0** | **2026-04-29** | **加强制合规声明 + 脚本校验 + 禁止AI自编代码** | |