Name: Development Sheet Factory
Author: aimentorai

스킬 검색.../

Development Sheet Factory | Skills Pool

# 1️⃣ AI 调用 MCP 获取竞品数据，输出 mcp_results.json
# （用户与 Claude 对话，无需手动调用）

# 2️⃣ 脚本整合竞品数据
export WORKSPACE=~/Desktop
python3 scripts/collect_competitor_data.py --date 20260328 \
    --mcp-results $WORKSPACE/20260328选品/mcp_results.json

# 3️⃣ 脚本生成开发表格
python3 scripts/generate_dev_sheets.py --date 20260328 \
    --competitor $WORKSPACE/20260328选品/_competitor_data.json

python3 scripts/generate_one_shot.py --date 20260328 --limit 3

列名	必需	说明
`SKU_ID`	✅	原始 ASIN
`SPU_ID`	✅	合并变体后的 SPU（文件名用）
`中文标题`	✅	产品中文名（6-18字）
`商品链接`	✅	产品链接
`主图链接`	✅	主图 URL
`售价`	✅	定价（欧元）
`类目ID路径`	✅	亚马逊类目 ID 路径
`季节性产品`	✅	是/否
`节日月份`	✅	旺季月份（非季节性则空）

YYYYMMDD开发表格/
├── B0XXXXXX+产品中文名.xlsx      # 每个 SPU 一个文件
├── B0YYYYYY+另一个产品.xlsx
├── ...
└── _READY.json                    # 完成标志

python3 scripts/generate_one_shot.py --workspace <WORKSPACE> --date <YYYYMMDD>

python3 scripts/collect_competitor_data.py --workspace <WORKSPACE> --date <YYYYMMDD> \
    --mcp-results <mcp_results.json>

python3 scripts/generate_dev_sheets.py --workspace <WORKSPACE> --date <YYYYMMDD> \
    --competitor <_competitor_data.json>

单元格	字段	数据来源
C2	亚马逊链接	复筛表`商品链接`
F2	主图	复筛表`主图链接`（下载 → 嵌入）
O2	季节性判断	复筛表`季节性产品`（是/否）
P2	季节性月份	复筛表`节日月份`
B7	产品中文名	复筛表`中文标题`
I7	前期定价	复筛表`售价`
J7	后期定价	复筛表`售价`（初始值）
K7	FBA 费用	Excel 公式（保留模板，勿覆盖）

单元格	字段	数据来源	示例
D2	竞品链接1	`traffic_listing` items[0]	`https://www.amazon.de/dp/{asin}`
E2	竞品链接2	`traffic_listing` items[1]	同上
I2	竞品定价区间	所有竞品价格范围	`€9.99 - €39.95`
S2	市场评分	竞品平均评分	`4.2/5.0`
T2	差评分析	低评论关键词	`主要问题：质量、尺寸（基于5条差评）`

{
  "schema_version": "1.0",
  "date": "20260328",
  "status": "ready",
  "total_spu": 25,
  "generated": 25,
  "failed": 0,
  "generated_at": "2026-03-28 18:30:00",
  "competitor_filled": 23,
  "competitor_skipped": 2,
  "files": [
    {"sku": "B0XXXXXX", "file": "B0XXXXXX+产品中文名.xlsx"},
    ...
  ]
}

# 批量补填整个目录
python3 scripts/fill_competitor.py \
    YYYYMMDD开发表格 \
    _competitor_data.json

情况	处理方式
模板文件不存在	报错并输出模板路径，终止
复筛表缺失必需字段	跳过该 SPU，记录日志，继续
主图下载失败	F2 写 URL 文本，不中断流程
主图尺寸过大	自动缩放到 F2 单元格，保持宽高比
MCP 返回空结果	D2/E2/I2/S2/T2 留空，`_READY.json` 记录 skipped
K7 公式丢失	检查是否从模板复制（禁止新建工作簿）

=IF(J7<=11,
  IF(AND(MAX(F7:H7)<=33,MEDIAN(F7:H7)<=23,MIN(F7:H7)<=2.5),
    LOOKUP(D7*1000,{0,41,61,81,101,211,461},{1.64,1.66,1.8,1.83,1.86,2.02,2.02}),
    IF(AND(MAX(F7:H7)<=33,MEDIAN(F7:H7)<=23,MIN(F7:H7)<=4),2.39,
      IF(AND(MAX(F7:H7)<=33,MEDIAN(F7:H7)<=23,MIN(F7:H7)<=6),2.78,
        IF(AND(MAX(F7:H7)<=35,MEDIAN(F7:H7)<=25,MIN(F7:H7)<=12),
          IF(D7*1000<=150,2.78,2.99),"尺寸超标")))),
  IF(AND(MAX(F7:H7)<=33,MEDIAN(F7:H7)<=23,MIN(F7:H7)<=2.5),
    LOOKUP(MAX(D7*1000,(F7*G7*H7)/5),{0,21,41,61,81,101,211,461},{2.07,2.11,2.13,2.26,2.28,2.31,2.42,2.42}),
    IF(AND(MAX(F7:H7)<=33,MEDIAN(F7:H7)<=23,MIN(F7:H7)<=4),2.78,
      IF(AND(MAX(F7:H7)<=33,MEDIAN(F7:H7)<=23,MIN(F7:H7)<=6),3.16,
        IF(AND(MAX(F7:H7)<=35,MEDIAN(F7:H7)<=25,MIN(F7:H7)<=12),
          LOOKUP(MAX(D7*1000,(F7*G7*H7)/5),{0,151,401,901,1401,1901,3901},{3.12,3.13,3.14,3.15,3.17,4.28,4.28}),
          IF(AND(MAX(F7:H7)<=45,MEDIAN(F7:H7)<=34,MIN(F7:H7)<=26),
            LOOKUP(MAX(D7*1000,(F7*G7*H7)/5),{0,151,401,901,1401,1901,2901,3901,5901,8901,11901},{3.13,3.16,3.18,3.67,3.69,4.29,4.83,4.96,5.77,6.39,6.39}),
            IF(AND(MAX(F7:H7)<=61,MEDIAN(F7:H7)<=46,MIN(F7:H7)<=46),4.3,
              IF(AND(MAX(F7:H7)<=101,MEDIAN(F7:H7)<=60,MIN(F7:H7)<=60),4.33,"超大件"))))))))

# 🌟 推荐方式：环境变量
export WORKSPACE=~/Desktop
python3 scripts/collect_competitor_data.py --date 20260328 \
    --mcp-results $WORKSPACE/20260328选品/mcp_results.json

# 方式2：新方式（显式指定 workspace）
python3 scripts/collect_competitor_data.py \
    --workspace <WORKSPACE> --date <YYYYMMDD> \
    --mcp-results <mcp_results.json> [--limit N]

# 方式3：旧方式（向后兼容）
python3 scripts/collect_competitor_data.py \
    --mode integrate \
    --source <复筛表.xlsx> \
    --mcp-results <mcp_results.json> \
    --output <输出目录> [--limit N]

# 🌟 推荐方式：环境变量
export WORKSPACE=~/Desktop
python3 scripts/generate_dev_sheets.py --date 20260328 \
    --competitor $WORKSPACE/20260328选品/_competitor_data.json

# 方式2：新方式（显式指定 workspace）
python3 scripts/generate_dev_sheets.py \
    --workspace <WORKSPACE> --date <YYYYMMDD> \
    --competitor <_competitor_data.json> [--limit N]

# 方式3：旧方式（向后兼容）
python3 scripts/generate_dev_sheets.py \
    <复筛表.xlsx> <YYYYMMDD> \
    --competitor <_competitor_data.json> [--limit N]

参数 / 环境变量	说明
`$WORKSPACE`	环境变量，workspace 目录。未设置默认 `~/Desktop`
`--workspace`	显式指定 workspace 目录（覆盖环境变量）
`--date`	数据日期 YYYYMMDD（必需）
`--limit N`	仅处理前 N 个 SKU（测试模式）
`--competitor`	竞品数据 JSON 路径
`--spu`	指定 SPU 列表（增量生成，逗号分隔）

pip3 install openpyxl Pillow

# 一次性设置 workspace（推荐）
export WORKSPACE=~/Desktop

# Step 1: AI 逐个调用 traffic_listing，增量写入 mcp_results.json
# （AI 在对话中逐个调用 MCP，每拿到结果就追加到 JSON 文件）

# Step 2: 一键生成所有开发表格
python3 scripts/generate_one_shot.py --date 20260328

# Step 3: 检查输出
ls -la $WORKSPACE/20260328选品/20260328开发表格/
cat $WORKSPACE/20260328选品/20260328开发表格/_READY.json | python3 -m json.tool

库	用途
`openpyxl`	Excel 读写
`Pillow`	图片嵌入

文件	说明
`{SPU}+{中文标题}.xlsx`	开发表格（从模板复制生成）
`_READY.json`	完成状态和统计信息

单元格	字段
D7	重量（kg）
F7	长度（cm）
G7	宽度（cm）
H7	高度（cm）

Development Sheet Factory

Development Sheet Factory（开发表格工厂）

目标

快速开始

方式一：一键生成（推荐）

方式二：分步执行

Development Sheet Factory

Development Sheet Factory（开发表格工厂）

目标

快速开始

方式一：一键生成（推荐）

方式二：分步执行

测试模式（仅生成前 N 个）

输入输出契约

输入：YYYYMMDD选品复筛.xlsx

输出：YYYYMMDD开发表格/

执行流程

推荐流程：一键生成

分步流程（旧方式，向后兼容）

验收

第三阶段：验收

表格自动填充规则

基础字段（脚本填充）

竞品字段（MCP + 脚本填充）

用户手动填写

_READY.json 格式

补填竞品（开发表格已存在的情况）

异常处理

质量检查清单

FBA 费用公式

脚本参数

collect_competitor_data.py

generate_dev_sheets.py

依赖

典型工作流

常见问题

Taskflow Inbox Triage

Accessibility

Open a Pull Request

Investor Materials

Continuous Agent Loop

Configure Ecc