Excel Template Transform — Skill 套件

将源Excel数据按映射配置规则整理到目标模板格式，实现不同系统/格式间的数据转换。

首次使用设置

安装后首次使用，Agent 需要确认以下内容：

1. ETT 工作目录：用户希望配置和输出文件存放的目录（默认：~/ett-workspace/）
• assets/ 子目录：存放映射配置 JSON
• output/ 子目录：存放转换结果文件
• 如果目录不存在，Agent 自动创建

1. Python 环境：确认 python 命令可用，且已安装 openpyxl、pandas
• 如果缺少依赖，提示用户安装：pip install openpyxl pandas

1. 记录用户选择：将 ETT 工作目录路径保存到用户记忆中，后续使用不再询问

> 注意：本 Skill 套件已内置核心转换脚本 scripts/ett_transform.py，无需额外安装 ETT 工具。

套件组成

预设配置（Presets）

套件内置两类预设配置，安装后可直接使用，无需从头配置：

预设文件位置：presets/ 目录（与SKILL.md同级）

使用预设配置

场景A：直接转换（已有源数据，需要目标模板）

1. 选择预设配置（如"星空企业版→EAS Cloud / 会计科目"）
2. 获取对应目标模板Excel（从金蝶系统导出，或自行创建）
3. 使用 ett-data-transform 执行转换

场景B：查看/调整预设配置

1. 使用 ett-template-config，选择"查看/调整已有配置"
2. 从 presets/ 目录选择预设配置
3. 查看映射详情，人工调整，保存

场景C：基于预设配置创建新模板

1. 使用 ett-template-config，选择"新建配置"
2. 参考预设配置的映射思路，为新模板创建映射
3. 保存为新配置文件

使用流程

1. 首次使用 → 设置 ETT 工作目录（一次性）
2. 检查是否有预设配置 → 有则直接使用（场景A/B/C）
3. 无预设 → ett-template-config 配置模板映射（一次性）
4. 后续使用 → ett-data-transform 执行数据转换（反复使用）

支持的映射类型

目标模板Excel获取方式

使用预设配置时，需要对应的目标模板Excel文件。获取方式：

1. 从金蝶系统导出（推荐）：登录金蝶系统 → 进入对应模块 → 下载导入模板
2. 自行创建：按金蝶导入格式要求，创建空白Excel模板

参考文档

• ett-template-config/references/mapping-config-guide.md — 映射配置完整规范
• ett-data-transform/references/mapping-config-guide.md — 映射配置完整规范
• presets/ — 预设配置文件目录
• scripts/ett_transform.py — 核心转换脚本（已内置）