51 lines
2.1 KiB
Markdown
51 lines
2.1 KiB
Markdown
# 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 说「查大鲸洗订单」之类的话即可触发。
|
||
|
||
## 升级（非必须，忘了也安全）
|
||
|
||
skill 不随指南发版刻意更新（见下方维护策略）。想手动同步时：
|
||
|
||
```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 过期是安全的，事实源在服务端。
|
||
|
||
## 维护策略（Owner 备忘，2026-11-03）
|
||
|
||
- 本 skill **有意低频维护**，停在某版本不是遗忘。正确性由服务端双保险承载：
|
||
KNOWN_GUIDE_VERSION 只是播报触发器，版本差会让 AI 自动
|
||
integration-guide-read 服务端最新指南全文，合同知识始终追平。
|
||
- 接受的代价（均在使用侧，轻微）：每次会话多一次全文 read；版本播报起点
|
||
陈旧；工具速查表逐渐成为历史快照。
|
||
- 无仪式要求：结构性变化（新报表、口径、边界规则）后、生产 E2E 绿了，
|
||
顺手更新正文并把版本号带上即可；忘了零惩罚。
|
||
|
||
## 目录结构
|
||
|
||
- `djxdb-query/`——skill 本体（SKILL.md），复制到 `~/.trae-cn/skills/` 即用
|