TapTap Data Skills

把 TapTap 数据团队维护的 skill(数据查询、分析、报告等)和它们依赖的知识库 / MCP 服务,一键装到本机检测到的所有 AI 编辑器(Claude Code / Cursor / Codex / OpenClaw),并保持版本同步。

装一个 skill

npx @taptap/data-skills add <skill-name>

默认走 SSO:首次运行会拉起浏览器登录,凭据持久化后续免登。

第一次运行会自动:

• 把 skill 文件装到检测到的每个 AI 编辑器
• 从服务端拉对应知识库(KB)缓存到本机
• 给需要 MCP 服务的 skill 写好编辑器配置

后续运行只做增量同步,跳过没变的部分。

看本机装了什么

npx @taptap/data-skills list                 # 已装的
npx @taptap/data-skills list --available     # 可装的
npx @taptap/data-skills info <name>          # 某个 skill 的版本/路径详情

升级 / 同步 / 卸载

npx @taptap/data-skills update [<name>]      # 升到 catalog 最新版本(不传名字 = 全部)
npx @taptap/data-skills sync-kb <name>       # 只刷新知识库,不动 skill 文件/MCP
npx @taptap/data-skills remove <name>        # 卸载,KB 缓存默认保留(下次 add 命中)

只想装到部分编辑器

默认装到本机所有检测到的 host(Claude Code / Cursor / Codex / OpenClaw)。可以显式选:

npx @taptap/data-skills add <name> --agent claude-code cursor

鉴权

默认走 SSO,无需配置任何环境变量。以下场景需要 service token,通过 DVIEW_MCP_TOKEN 传入:

• OpenClaw:不支持浏览器登录,必须用 token
• 容器 / CI / 无浏览器环境:同样必须用 token

# 推荐:静默读入,token 不进 shell history
read -rs "?DVIEW_MCP_TOKEN: " DVIEW_MCP_TOKEN
export DVIEW_MCP_TOKEN

Token 申请请联系 TapTap 数据团队。

排障

npx @taptap/data-skills doctor               # 一键自检
npx @taptap/data-skills doctor --report > /tmp/report.md

doctor --report 生成可发给维护者的报告,自动剥离敏感信息(token、SSO 凭据、绝对路径中的 $HOME 段)。报告里不会包含你的 token / 主机名 / 私有路径。

从旧版迁移

如果机器上有 @taptap-internal/data-analysis-skill 的残留:

npx @taptap/data-skills migrate

会安全把老 setup 搬到新 wrapper 下,不丢配置。

如果遇到问题

1. 先跑 doctor
2. 再跑 doctor --report 把生成的 markdown 报告发给数据团队 maintainer
3. 报告里包含 wrapper 版本 / 安装清单 / 各 host 路径状态(已脱敏),够 maintainer 定位大部分问题