展开本页目录
开始前准备什么
- 自己的 Codex 环境与独立练习目录;现有配置先保留。
- 下载原创练习素材;需要模型的步骤沿用自己已验证的型号和凭据。
- 可选 Python 3,用于只读离线材料检查;通过不代表真实产品流程已运行。
- 为三款商品建立事实表
- 创建项目级 Skill 目录
- 固定 CSV 列和缺失值规则
- 显式调用项目技能
- 逐 SKU 核对双语结果
- 导出并与原表对照
原创输入、字段配置、人工预期、离线检查与对应 HTML 教材;不会自动安装或调用模型。
包含当前页具体步骤、官方来源与验证边界。
固定虚构练习数据,用于检查本页任务的映射与边界。
人工编写的对照,不是产品或模型实际运行收据。
Python 标准库,只验收教材输入与预期关系,不访问网络。
自行复制到独立练习项目的 .agents/skills/sku-bilingual-copy。
运行 python3 check-copy.py 自己的copy.csv,校验 SKU、材质、尺寸与缺失认证标记;不校验翻译质量。
1. 为三款商品建立事实表
下载 sku-facts.csv,在练习目录保留 sku_id、材质、尺寸和 certification。空白认证表示资料没有提供;把实际商品与原创虚构样例分开,避免把样例参数写到商店。
2. 创建项目级 Skill 目录
在独立练习目录创建 .agents/skills/sku-bilingual-copy,把教材 SKILL.md 放入其中。官方当前项目级路径为 .agents/skills;本教程不覆盖已有同名技能,也不会自动安装。
3. 固定 CSV 列和缺失值规则
阅读 Skill 的输入、六列输出和事实边界。中文标题与英文标题分别填写;保留原始材质和尺寸,认证缺失写 certification_missing。含逗号的文字须由 CSV writer 转义。
config.json · 字段教材,不可作为工作流导入
{
"skill_path": ".agents/skills/sku-bilingual-copy/SKILL.md",
"input": "sku-facts.csv",
"output": "copy.csv",
"columns": [
"sku_id",
"title_zh",
"title_en",
"material",
"size_cm",
"review_flags"
],
"invoke": "$sku-bilingual-copy"
}4. 显式调用项目技能
在 Codex 的练习项目中输入 $sku-bilingual-copy,说明读取 sku-facts.csv 并保存 copy.csv。先让它确认读到 3 个唯一 ID;凭据和模型沿用自己已验证的入口。
5. 逐 SKU 核对双语结果
检查 BOX-G、BAG-B、CUP-W 各出现一次,英文字段存在,材质和尺寸与事实表完全一致。翻译可以改措辞,不能新增防水、认证、赠品等资料没有的承诺。
6. 导出并与原表对照
先保存为测试 CSV,在表格中按 sku_id 对齐查看中英文标题。只读校验检查 ID、列、事实字段和缺失标记;标题是否准确自然仍需自己复核。
bash
python3 check-copy.py copy.csv7. 下载教材并运行离线核对
先下载完整教材包并解压,在材料目录运行 python3 check-fixture.py。脚本只读取原创输入、人工预期与配置,对照本页固定验收条件;通过说明材料内部关系一致,实际产品、模型与业务写入另需按前六步验证。
bash
unzip lesson.zip -d codex-ecommerce-sku-skill
cd codex-ecommerce-sku-skill
python3 check-fixture.py怎样确认已经完成
- 输出 SKU 集合与输入完全相等且无重复。
- 材质和尺寸逐 SKU 一致;缺少认证保留 review_flags。
- 下载素材是人工预期示例,未执行 Codex 生成或发布商品。
常见问题
和 Claude Code 商品 Skill 有什么区别?
此页使用 Codex 的 .agents/skills 路径,输入为多 SKU CSV,输出为双语 CSV。原教程是 Claude 的单商品 Markdown,文件结构与验收目标不同。
结构检查通过就能上架吗?
不能。检查脚本只验证 ID、字段与事实表对应关系;翻译、商品合法描述和平台规则仍须人工核对。

