前言¶
基金销售业务里，基金公司下发的销售服务费明细常以 PDF 或 Excel 呈现，字段命名、费用类型和表头顺序并不统一。若要导入内部系统或按 TA 报送模板归档，往往需要人工筛掉代理费、管理费等项目，再对照 TA 代码表重排表头。重复劳动多，也容易在基金代码格式或报表周期上出错。
下面介绍 SkillHub 社区技能「销售服务费转换」（@user_8bcbd14b/sale-fee-convert）。它把「解析源文件 → 匹配 TA → 只保留销售服务费 → 输出固定表头 .xls」写成 Agent 可执行的规则，触发后按约定直接生成文件，而不是先长篇解释或二次确认。
这是什么¶
「销售服务费转换」是发布者 user_8bcbd14b 在 SkillHub 上架的社区 Skill（business-ops 分类），当前版本 1.0.0，来源标记为 community。页面标注 requires_api_key=false，安装后不需要额外配置 API Key。
技能在 SKILL.md 中的定位是：机器级无脑执行——激活后直接生成标准 Excel，不询问、不总结、不额外解读。适用对象是已在 Cursor、Claude Code、Codex 等环境中使用 Agent Skills、且需要处理基金销售服务费报表的运营或中后台同事。
官方入口：
- API 索引：
https://api.skillhub.cn/user_8bcbd14b/sale-fee-convert - SkillHub 页面：
https://www.skillhub.cn/skills/user_8bcbd14b/sale-fee-convert
（SkillHub 页面截至撰写时展示的下载约为 861 次，评分为平台内部计分 100000；具体数字以页面实时显示为准。）
核心功能¶
以下能力均来自技能包内 SKILL.md 的约定，而非推测。
输入与前置校验¶
- 接收 PDF 或 Excel 作为源文件。
- 校验文件未损坏、未加密、可正常解析；不满足则直接拦截，不继续转换。
提取、匹配与筛选¶
- 基金公司名称：从源文件提取完整名称，并对照内置「TA 代码—基金公司」映射表（技能内
ta_mapping，覆盖安信、博时、易方达、华夏等常见管理人及对应 TA 代码），自动绑定 TA 代码。 - 基金代码与销售服务费金额：提取基金代码与金额；基金代码必须为 6 位纯数字 文本，不合规行剔除。
- 费用类型：仅保留「销售服务费」；强制排除代理费、申购费、赎回费、转换费、管理费、托管费、认购费及其他费用。
输出格式与命名¶
输出为 Excel 97-2003 的 .xls 文件，表头顺序固定为：
TA代码基金代码托管服务费金额（技能约定：该列填入提取到的销售服务费数值）算法名称（非必填）（整列留空）月份（报表周期首日，yyyymmdd，仅第一行填写）月份2（报表周期末日，yyyymmdd，仅第一行填写）
文件命名：报表周期（yyyymm 形式）+ 基金公司名。处理完成后直接提供可下载的 .xls，不做内容摘要或备注。
触发与行为约束¶
技能声明的触发词包括：处理、销售服务费、上传、pdf、excel。激活后须遵守 force_rule：无需用户再次确认即执行转换；禁止总结原文、禁止额外备注、禁止二次询问。
安装与启用¶
SkillHub 官方安装说明见 https://skillhub.cn/install/skillhub.md。简要步骤如下。
1. 确认 SkillHub CLI¶
检查本机是否已安装 skillhub：
command -v skillhub && skillhub --version
若未安装，可使用官方脚本（完整安装含 CLI 与默认 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. 安装本技能¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录；默认装到 ./skills/ 时，部分客户端不会自动加载。
skillhub install sale-fee-convert --namespace user_8bcbd14b --dir <你的 skills 目录>
SkillHub 页面给出的自然语言安装提示为：让 AI 根据 https://skillhub.cn/install/skillhub.md 安装 @user_8bcbd14b/sale-fee-convert。
3. 各客户端常见 skills 路径¶
路径来自 SkillHub 安装文档，按你实际使用的客户端选择其一：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
安装到对应目录后，按客户端要求重启或刷新 Agent，使新 Skill 被识别。
典型用法¶
技能未附带独立示例数据文件，可复现的流程如下。
- 在已启用该 Skill 的 Agent 对话中，上传基金公司提供的 PDF 或 Excel 销售服务费明细（确保未加密、可打开）。
- 用触发词明确意图，例如说明需要「处理销售服务费」或「上传 pdf 转 excel」。
- Agent 按
SKILL.md执行六步流水线：提取公司名并匹配 TA → 提取基金代码与金额 → 筛除非销售服务费 → 按固定表头写入.xls→ 按周期与公司名命名 → 返回可下载文件。 - 收到
.xls后，在 Excel 或下游系统中核对 TA 代码、6 位基金代码、金额列及首行的月份/月份2是否与源报表周期一致。
全程不应出现「是否继续」「以下是摘要」类打断；若源文件损坏或加密，应在前置校验阶段失败。
适用场景与注意¶
适合谁
- 经常收到多家基金公司销售服务费报表，需要统一成同一套
.xls表头再导入或归档的团队。 - 希望把 TA 对照、费用类型过滤、基金代码格式校验固化在 Agent 规则里，减少手工复制粘贴的场景。
限制与注意
- 仅处理技能列明的费用类型；其他费用已在规则中排除，勿指望本 Skill 一并转换。
- 基金代码非 6 位数字的行会被剔除，源表若含字母或带后缀的代码需先在外部清洗或确认是否适用。
- 输出列名写作「托管服务费金额」，实际填充的是销售服务费；对接系统时以技能约定为准，避免按字面误解字段含义。
- TA 映射表内置在
SKILL.md中；若出现新管理人或未收录名称，匹配可能失败，需要更新技能或人工补 TA。 - 行为上强制「不总结、不询问」；若你希望 Agent 先解释报表内容再转换，与本 Skill 的
force_rule冲突，应改用普通对话或另建技能。 - 财务与合规场景下，生成文件仍建议人工抽检金额合计与抽样基金代码，技能不替代复核流程。
结尾¶
「销售服务费转换」把基金销售服务费报表的解析、TA 绑定、费用筛选和 .xls 表头标准化写进 Agent Skill，适合在 SkillHub 一键安装后，用上传文件加触发词完成批量整理。详情与安装入口见 SkillHub 官方页面：https://www.skillhub.cn/skills/user_8bcbd14b/sale-fee-convert。
