@bty/cs-skills

BetterYeah 客服 Agent 运维 Claude Code skills 套件。一条命令把 5 个 skill 装到 ~/.claude/skills/ / ~/.agents/skills/ / ~/.codex/skills/，配合 Claude Code、Claude Agents、Codex 使用。

安装

需要两个 npm 包：

# 1. BetterYeah 客服平台 CLI（skill 运行时调用）
npm install -g @bty/customer-service-cli

# 2. 本包（5 个 skill）
npm install -g @bty/cs-skills

安装完成后会自动 symlink 到 ~/.claude/skills/ / ~/.agents/skills/ / ~/.codex/skills/。 重启 Claude Code / Codex 即可看到 skill。

跳过 cs-cli 不会让 npm install 失败，但 5 个 skill 全部依赖 cs-cli 在 PATH 里；缺它会在第一次调用时报错。 装完跑 bty-skill doctor 一眼确认两条都就位。

包内 skill 清单

| Skill | 用途 | | --- | --- | | cs-trace | 拉取并解析 cs-cli debug trace 数据：关键 flow、LLM prompt、工具结果 | | cs-check-real-trigger-msg | 根据 bad reply 的 record_id 校验 testcase / issue 的真实 user trigger | | cs-testcase-create | 基于 SOP + 高质量聊天记录批量生成 single-turn testcase（v5 schema） | | cs-testcase-halluccheck | 对 Agent 回复做幻觉检测：7 个数据源白名单（product / FAQ / debug_message 等） | | cs-testcase-precheck | 送测前对 testcase 做结构 / 语义 / P0_hard 红线预检 |

详细使用方式：

bty-skill list                    # 列清单
bty-skill info cs-trace           # 查看某个 skill 的 SKILL.md

在 Claude Code 中直接用 /cs-trace 之类的命令调用即可（重启后生效）。

运行依赖

| 依赖 | 说明 | | --- | --- | | Node.js ≥ 16 | 仅安装阶段需要（postinstall 脚本执行 symlink） | | Python ≥ 3.9 | skill 运行时 | | cs-cli | BetterYeah 客服平台 CLI，npm install -g @bty/customer-service-cli | | BTY_API_KEY | BetterYeah 网关 API key，用于 LLM 调用（详见下方） |

一键检查：

bty-skill doctor

输出会显示每项 [ok] / [missing]，按提示补齐即可。

配置 BTY_API_KEY

cs-testcase-create / cs-testcase-halluccheck / cs-testcase-precheck 走 BetterYeah 网关代理 claude-opus-4-6，需要 API key。

在 ~/.zshrc（或 ~/.bashrc）末尾追加：

export BTY_API_KEY="你的 BetterYeah 网关 key"
export BTY_API_BASE_URL="https://aigw-api.betteryeah.com"   # 可选，有默认
export BTY_API_MODEL="claude-opus-4-6"                       # 可选，有默认

然后：

source ~/.zshrc
bty-skill doctor

API key 申请：联系 BetterYeah 商务或技术对接人。

CLI 命令

bty-skill list            列出包内 skill
bty-skill info <name>     打印指定 skill 的 SKILL.md
bty-skill doctor          检查安装状态与运行依赖

升级与卸载

npm update -g @bty/cs-skills              # 升级到最新版
npm install -g @bty/[email protected]       # 锁版本
npm uninstall -g @bty/cs-skills           # 卸载（自动清理 symlink）

排障 FAQ

Q：bty-skill doctor 显示 [missing] cs-cli A：装 cs-cli：npm install -g @bty/customer-service-cli。

Q：[missing] BTY_API_KEY A：参考上方「配置 BTY_API_KEY」，记得 source ~/.zshrc 后重启 Claude Code 让 skill 进程读到新环境变量。

Q：Claude Code / Codex 里看不到 /cs-* 命令 A：检查 symlink 是否就位：

ls ~/.claude/skills/ | grep cs-

如果缺失，重装：

npm uninstall -g @bty/cs-skills && npm install -g @bty/cs-skills

Q：skill 跑起来报 ModuleNotFoundError: cs_shared A：lib symlink 损坏。同上重装一次即可。

Q：Windows 平台支持吗？ A：postinstall 会优先创建目录 junction（管理员权限下），失败回退到完整复制。基本功能可用， 但 symlink 行为不如 macOS / Linux 直观，建议在 WSL 里跑。

反馈

源仓库 / Issue：https://gitlab.bantouyan.com/x-lab/customer-ops

开发者文档

如果你 clone 了源仓库做本地开发，看 README.dev.md：包含目录结构、 开发模式 install.sh、客户 workspace 工作流、cs-cli --workspace 铁律等内部细节。