前言¶
客服质检通常要对照话术手册，逐条翻会话、标违规、算合格率。数据在 Excel 里，规则在文档里，人工抽检一轮往往要数小时，且不同人标注口径容易漂移。下面介绍 SkillHub 上的 ai客服质检（坐标 @user_2cd25b29/kefuzhijian，当前版本 3.0.6）：上传会话表后，由内置脚本按既定规则生成 HTML 报告和绩效汇总表，把重复劳动交给 Agent 与 run.py 执行。
这是什么¶
ai客服质检 是面向客服运营场景的 Agent Skill，归类为 business-ops（子类含客服助手、用户运营）。发布者为社区用户 user_2cd25b29（SkillHub 展示名 w12天水讼），来源为 community。Skill 元数据标明 requires_api_key=false，不依赖额外 API Key 配置。
官方简介概括为：AI 客服对话质检系统；内置完整执行脚本 run.py，支持命令行参数；用户上传会话 Excel（排号表 CSV/xlsx 可选），输出绩效与违规、差评相关质检结果，并附带客服绩效汇总 Excel。包内还包含判定规则、关键词库与迭代说明（如 references/rules.md、TROUBLESHOOT.md）。
SkillHub 页面：https://www.skillhub.cn/skills/user_2cd25b29/kefuzhijian
API 入口：https://api.skillhub.cn/user_2cd25b29/kefuzhijian
截至页面展示数据：6145 次下载，12 个历史版本。
核心功能¶
以下能力均来自 Skill 包说明与 run.py / references/qi_report2.py 行为，可按需核对。
场景与规则识别¶
- 识别售后、二次进线、辱骂、客户情绪异常等会话类型，并按规则决定是否计入绩效合格率或进入违规/差评核查。
- 对转人工后的会话执行 答疑 → 探需 → 推荐 三步话术核查；合格条件为须同时出现探需与推荐（仅有答疑不合格）。
- 同步扫描违规行为与差评对话；差评侧按满意度字段筛选并展示对话明细。
报告与汇总输出¶
执行完成后主要产出：
- HTML 质检报告（默认同目录
*_质检报告.html）：单页内分块展示 绩效质检、违规行为质检、差评场景核查 三块内容，并支持结果筛选（如质检结果、客服账号、满意度等，见 Skill 文档）。 - 客服绩效汇总 Excel：与 HTML 同前缀的
*_客服绩效汇总.xlsx，含人名、账号、合格率等汇总字段。
执行方式¶
- 推荐：在已安装 Skill 的 Agent 中上传 Excel，用「质检」「生成质检报告」等意图触发，由 Agent 调用
run.py。 - 批处理：在 Skill 目录下直接运行
python3 run.py，适合定时或大批量任务。
Skill 说明提到使用后可将规则经验沉淀在 Skill 内，判定可随迭代调整；具体维护方式以 Skill 内 SKILL.md 与 rules.md 为准。
安装与启用¶
安装 SkillHub CLI（未安装时）¶
先确认本机是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，按 SkillHub 官方文档执行（完整安装含 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
文档：https://skillhub.cn/install/skillhub.md
安装 ai客服质检¶
官方安装说明：根据上述文档，安装坐标 @user_2cd25b29/kefuzhijian。安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 且 Agent 可能无法加载。
skillhub search kefuzhijian
skillhub install @user_2cd25b29/kefuzhijian --dir <你的 Agent skills 目录>
常用路径示例（来自 SkillHub 文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可从 SkillHub 页面下载 Zip（当前包名 kefuzhijian-3.0.6.zip），解压到上述 skills 目录对应子文件夹。下载地址形如：
https://api.skillhub.cn/api/v1/download?slug=@user_2cd25b29/kefuzhijian
安装或更新 Skill 后，按你所用客户端要求重启或刷新 Agent，以便加载新的 SKILL.md。
典型用法¶
1、准备数据¶
会话数据为 Excel，字段需包含 Skill 文档中的列（如会话组编号、问题/回答内容与时间、客服名称、是否成交、是否满意等）。可选 排号表（CSV 或 xlsx），用于账号与人名映射；机器人账号（如 H 列以 jimi_vender_ 开头）不参与人工客服识别。
2、命令行生成报告¶
进入 Skill 目录后执行（路径换成你的文件）：
python3 run.py /path/to/会话.xlsx
带排号表与自定义输出：
python3 run.py /path/to/会话.xlsx \
-p /path/to/排号表.xlsx \
-o /path/to/质检报告.html \
-m 200
参数含义：
| 参数 | 说明 |
|---|---|
excel |
会话 Excel，必填 |
-p, --paihao |
排号表（CSV/xlsx），可选 |
-o, --output |
输出 HTML 路径，可选 |
-m, --max-sessions |
每人最多计入会话数，默认 200 |
-v, --verbose |
详细日志 |
3、在 Agent 里对话触发¶
将 Excel 提供给 Agent，说明需要质检或生成报告。Agent 读取 Skill 后应调用同目录 run.py；若需改规则或排障，可参考 references/qi_report2.py 顶部配置项或 TROUBLESHOOT.md。
经过上面的步骤，当前目录（或 -o 指定路径）应出现 HTML 报告与同前缀的绩效汇总 xlsx。
适用场景与注意¶
适合：有固定导出格式的在线客服会话表；需要批量产出可转发给主管的 HTML 报告和 Excel 汇总；希望把手册里的违规条目、三步话术规则固化在脚本里，减少人工翻聊天记录。
限制与注意：
- 列名与列位置需符合 Skill 约定；导出模板不一致时要先对齐或改
qi_report2.py读取逻辑。 - 二次进线、售后等规则有明确关键词与占位符判断，误判时先查
SKILL.md与rules.md，再查TROUBLESHOOT.md。 - 包内
SKILL.md头部仍写有内部工程名apple-jd-qi-report与文档版本 v2.5，与 SkillHub 发布版本 3.0.6 并存；以 SkillHub 版本与 Zip 内容为准。 - 质检结果用于管理参考，敏感词与违规认定仍建议抽检复核。
结尾¶
ai客服质检 把「会话 Excel → 绩效/违规/差评三块质检视图 + 绩效汇总表」收成一条可重复执行的 Skill 流程：Agent 负责理解意图与路径， run.py 负责落地规则。若你要在 Cursor 等环境里接入，从 SkillHub 安装 @user_2cd25b29/kefuzhijian 即可；详情与更新以官方页为准：https://www.skillhub.cn/skills/user_2cd25b29/kefuzhijian 。
