# DJXDB Skill 分发仓库

面向内部同事分发 DJXDB 查询 skill（`djxdb-query`）。skill 引导你的 AI 通过
DJXDB MCP 查询大鲸洗业务数据；鉴权、报表合同、指南正文均由服务端承载，
本仓库只分发引导知识与版本播报机制。

## 前置条件（缺一不可）

1. **个人 caller key**：向 DJXDB 服务方 Owner 索取，一人一把，凭 key 追溯
   与吊销。key 属于个人凭据，不得转借。
2. **Trae 注册 DJXDB MCP**：在项目 `.trae/mcp.json` 或全局 MCP 配置注册：
   - url：`https://djxdb.pandaqie.top/mcp`
   - header：`x-djxdb-caller-key`，值为你的个人 key

   key 只写进 MCP 配置文件，不进对话、代码、日志或任何其他文件。

## 安装

```bash
git clone https://2034.pandaqie.top/dajingxi/djxdb-skill.git
cp -r djxdb-skill/djxdb-query ~/.trae-cn/skills/
```

重启 Trae 会话后生效。之后对 AI 说「查大鲸洗订单」之类的话即可触发。

## 升级（指南每次发版后）

DJXDB 指南每发新版，本仓库会同步 bump skill 内的 KNOWN_GUIDE_VERSION：

```bash
cd djxdb-skill && git pull
rm -rf ~/.trae-cn/skills/djxdb-query && cp -r djxdb-query ~/.trae-cn/skills/
```

重启会话。即使忘了升级，skill 也会在调用 integration-guide-info 时发现版本
不一致，自动拉取并播报新版指南要点——skill 过期是安全的，事实源在服务端。

## 目录结构

- `djxdb-query/`——skill 本体（SKILL.md），复制到 `~/.trae-cn/skills/` 即用