前言¶
资金岗、共享中心或实施同事经常遇到同一类事：银行给的流水是 MT940、各家银行自己的 Excel，或是 PDF，而目标系统只认固定列名的导入模板。手工复制粘贴容易错列、漏借贷方向，批量多账户时更耗时间。下面介绍 SkillHub 上的社区技能「银行对账单处理和转换」（坐标 @user_ac4bcccb/imp-trm-accstmt），由 Agent 按技能说明解析对账单、做字段映射，并生成 BIPV5、金蝶云星瀚、保融 ATS、九恒星司库、用友 NCC 等系统可直接使用的 Excel/xls 文件。
这是什么¶
这是一份基于通用 SKILL.md 格式的 Agent Skill，发布在 SkillHub（分类 office-efficiency，来源 community，发布者 user_ac4bcccb）。页面当前版本为 v1.0.3，标签标明 requires_api_key=false，无需额外 API Key。
定位可以概括为：解析 MT940 / Excel / PDF 银行对账单 → 智能字段映射 → 输出各目标系统的标准导入模板。官方说明中强调：当用户需要将上述格式对账单转为 BIPV5、EAS_YXH、FINGARD、NSTC、YYNCC 等模板时，应使用本技能。
官方页面：
- SkillHub：https://www.skillhub.cn/skills/user_ac4bcccb/imp-trm-accstmt
- API 入口：https://api.skillhub.cn/user_ac4bcccb/imp-trm-accstmt
核心功能¶
输入格式¶
- MT940：SWIFT 标准银行对账单，含 TXT、STA 等常见载体。
- 国内银行 Excel：资料中列举的包括招商、中信、兴业、浦发、民生、徽商、广西北部湾、渤海、国开、中原等。
- 国内银行 PDF：文本型 PDF；图片型 PDF 可选 OCR。资料中举例农商行、平安、恒丰、浙商、郑州等。
目标系统与模板文件¶
默认目标为 BIPV5。其余系统通过 target_system 区分，对应 assets/template/ 下的官方模板：
| 系统代码 | 说明 | 模板文件名 |
|---|---|---|
| BIPV5（默认） | 银行流水处理 Excel | YYBIPV5_banktransaction.xlsx |
| EAS_YXH | 金蝶云星瀚离线明细 | eas_yxh_banktransaction.xlsx |
| FINGARD | 保融 ATS 离线信息 | fingard_banktransaction.xls |
| NSTC | 九恒星司库批量导入银行明细 | nstc_banktransaction.xls |
| YYNCC | 用友 NCC 数据页签 | yyncc_banktransaction.xls |
输出会尽量贴合各系统要求：例如 EAS_YXH 保留单元格批注与下拉项；FINGARD、NSTC、YYNCC 保留说明 sheet 与对照表。
解析与映射能力（资料已写明部分）¶
- 余弦相似度匹配列名，缓解各银行表头不一致问题。
- 对方账号、对方名称支持多种别名（如对手账号、收款账号等）。
- 借贷标识分离、日期与币种转换；可从表头区域提取本方账号，并清理「账号（人民币）」类币种后缀。
- PDF：合并折行表头（如「交易时」+「间」→「交易时间」）；用 PyMuPDF 的 X/Y 坐标按列重组表格，不依赖固定列数。
- 可配置 JSON 映射文件扩展新银行格式或新目标系统，官方说明称无需改代码即可适配新格式。
- 支持账号与明细分离的对账单结构，以及多文件批量转换合并为单个导入文件。
输出位置：默认与输入文件同目录，便于与原始对账单放在一起管理。
模板加载：统一入口为 scripts/core/template_manager.py 中的 resolve_template(target_system)。若从 clawhub 等无法携带二进制模板的市场安装且本地缺少模板，会从预配置地址自动下载到 assets/template/。
安装与启用¶
SkillHub 提供两种常见方式：CLI 安装，或让当前 Agent 按安装文档拉取技能。
1. 检查 SkillHub CLI¶
先确认本机是否已有 skillhub：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行完整安装（含默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安装到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前客户端识别的 skills 目录，否则默认落在 ./skills/ 可能不会被加载。常用路径如下（摘自 SkillHub 安装说明）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
在 Cursor 中示例：
skillhub install @user_ac4bcccb/imp-trm-accstmt --dir ~/.cursor/skills/
安装后按所用客户端要求重启或刷新技能列表。
3. 通过对话让 Agent 安装¶
SkillHub 技能页提供的提示词为：
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_ac4bcccb/imp-trm-accstmt。
将上述内容发给支持 Skill 的 Agent，由其按 skillhub.md 完成安装与目录配置。
典型用法¶
本技能以 自然语言触发 + Agent 按 SKILL.md 执行脚本 为主，官方未在公开页给出单独的命令行「一键转换」示例。实践中可按下面步骤与 Agent 协作。
- 准备文件：将 MT940（
.txt/.sta）、银行 Excel 或 PDF 放在可访问路径，并说明目标系统（不写则默认为 BIPV5）。 - 发起任务：用与场景匹配的表述，例如「把这份招商银行 Excel 对账单转成金蝶云星瀚 EAS_YXH 导入模板」「解析 MT940 生成 BIP 导入文件」「PDF 银行流水转用友 NCC」。
- 核对输出：在同目录下检查生成的
.xlsx或.xls，再导入对应财务/司库系统。
官方列出的必须触发关键词包括：银行对账单转换、MT940 解析、PDF 对账单转换、境外/SWIFT 对账单、转换为金蝶/保融/九恒星/用友 NCC，以及英文表述如 bank statement import、MT940 to BIP、PDF to BIP 等。提到银行对账单、MT940、SWIFT、银行流水、PDF 对账单或上述厂商名称时，Agent 应挂载本技能处理。
多文件场景可明确要求「批量转换多银行对账单并合并为一个导入文件」。
适用场景与注意¶
适合谁
- 需要把多来源银行流水导入 BIPV5、金蝶云星瀚、保融 ATS、九恒星司库或用友 NCC 的财务、资金、实施人员。
- 对账单格式杂、表头不统一，希望减少手工列映射的同事。
- 已在使用 Cursor、Claude Code、Codex 等支持 Skill 的 Agent 环境。
使用注意
- 社区来源技能，导入生产前请在测试环境校验金额、借贷方向与笔数。
- PDF 为扫描件时依赖可选 OCR，识别率受原件质量影响，需人工抽检。
- 新银行版式可通过 JSON 映射扩展；若模板目录缺失，首次运行可能触发网络下载模板（clawhub 等市场场景）。
- SkillHub 统计（以抓取资料为准）：评分 100000，下载 2041 次；页面数据会更新，以 SkillHub 为准。
结尾¶
「银行对账单处理和转换」把 MT940、国内 Excel/PDF 对账单与五套主流导入模板之间的格式鸿沟收拢到一条 Agent 工作流里：解析、映射、按系统模板落盘，并支持映射扩展与批量合并。若你正在处理银行流水导入模板类需求，可从 SkillHub 安装 @user_ac4bcccb/imp-trm-accstmt：
https://www.skillhub.cn/skills/user_ac4bcccb/imp-trm-accstmt
