# 安装技能：标题和SKU命名

你是用户的 AI 助手。用户希望你安装这个技能，并带着用户把它配置到能正常使用。请按下面的顺序做，不要跳步。

## 技能信息

- 技能名：dianzhixiao-title
- 版本：v3（2026-10-14 11:29 发布）
- 作者：店智效官方
- 下载地址：https://dianzhixiao.yinceqiyeguanli.com/skills/dianzhixiao-title/download?version=3
- SHA-256：43b7e5e40460dd1b3acd8ccf202c0915a9c84792722fd881de3a7d2be13f51d9
- 大小：68 KB，17 个文件
- 技能页面：https://dianzhixiao.yinceqiyeguanli.com/skills/dianzhixiao-title

## 作者提供的使用说明

### 具体功能
按货号读取飞书上新表中的商品资料，实际查看商品图片。
结合店铺规则和清洗后的词库生成商品标题，按图片与原始命名规则整理规格名。
先生成方案，确认后写回飞书并读回核对；上架由店智效插件完成。

### 使用方法
1. 安装后，让 AI 运行配置向导，完成店铺、飞书表格与素材目录配置。
2. 指定店铺、货号范围，以及本次要写标题还是规格名。
3. 查看生成方案，确认后让 AI 写入飞书并核对结果。
示例：处理这家店指定货号的标题和规格名，先给我看方案。

### 运行条件
能读取技能、查看图片并运行 Python 的 AI 工具，例如 Codex、WorkBuddy、Claude Code。
Python 3.9 及以上；可编辑的飞书多维表格、自己的飞书应用及相应权限；本机商品图片。
生成标题还需要已清洗的关键词库；只生成规格名时不需要标题词库。

### 配置
飞书连接：配置自己的应用 App ID、App Secret，并授予目标表格权限；密钥只保存在本机配置或环境变量中，不发到聊天或公开页面。
店铺规则：选择准确的飞书表格及字段，填写货号、SKU、素材目录、品牌、禁词、标题与规格名规则。
词库：准备清洗后的关键词库；需要用插件抓词时，AI 会给出对应本机目录，由你填入插件下载地址。
安装 AI 通过 onboard.py 逐项引导；飞书授权等必须由本人完成的步骤会明确提示。

### 注意事项
写回飞书前先确认方案；结果未核实时先检查，不重复写入。此技能不修改价格、库存，也不直接发布商品。

## 第 1 步：下载并核对

1. 下载上面的技能包（zip）。
2. 计算文件的 SHA-256，必须和上面完全一致。不一致就停下，告诉用户“下载的文件和官网记录不一致”，不要安装。

## 第 2 步：放进技能目录

压缩包里只有一个 `dianzhixiao-title` 文件夹，把它解压到你读取技能的目录：

- Codex：`~/.codex/skills/`
- WorkBuddy：`~/.workbuddy/skills/`
- Claude Code：`~/.claude/skills/`
- 其他工具：放进它的技能目录；没有技能目录的，放在用户指定的文件夹，以后每次先读其中的 SKILL.md。

已经装过旧版本时，直接解压覆盖同名文件，不要先删除旧文件夹：里面可能有用户自己的配置和数据。这一步只解压，不要运行技能里的脚本。装好后，如果你的工具要重新打开才能识别新技能，告诉用户怎么做。

## 第 3 步：先跟用户讲清楚

读完 `dianzhixiao-title/SKILL.md` 后，先用两三句话告诉用户：

1. 这个技能能做什么、平时怎么用。
2. 要用起来，需要用户配合准备或配置哪些东西，列成清单。

SKILL.md 里有“装好后先做”“首次配置”之类的章节时，严格按它来，包括运行它要求的检查命令。

## 第 4 步：一步一步带用户配置

按清单一项一项来，一次只做一项：告诉用户这一步做什么、在哪里做；需要用户亲自操作的（登录、粘贴密钥、授权、在别的软件里选择文件夹等）请用户自己完成。不要让用户把密码、密钥发在聊天里。每完成一项就检查结果，确认没问题再做下一项。

## 第 5 步：确认能正常使用

全部配置完成后，按技能说明做一次检查或试运行，确认能正常使用，再告诉用户已经装好、以后怎么用。技能需要用户在其他软件里填写的路径或设置（例如插件里的下载文件夹），把这台电脑上的完整路径原样告诉用户。

## 以后更新

装好后告诉用户：以后要更新，打开技能页面 https://dianzhixiao.yinceqiyeguanli.com/skills/dianzhixiao-title，再复制一次安装指令发给 AI 就行；AI 会按同样的步骤下载最新版本覆盖安装，用户自己的配置和数据不受影响。
