前言¶
客服質檢通常要對照話術手冊，逐條翻會話、標違規、算合格率。數據在 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 。
