Document low-frequency maintenance policy in README

This commit is contained in:
claudecode
2026-11-03 23:15:19 +08:00
parent ef3cb376cc
commit 9e86e13328
+14 -4
View File
@@ -23,17 +23,27 @@ cp -r djxdb-skill/djxdb-query ~/.trae-cn/skills/
重启 Trae 会话后生效。之后对 AI 说「查大鲸洗订单」之类的话即可触发。 重启 Trae 会话后生效。之后对 AI 说「查大鲸洗订单」之类的话即可触发。
## 升级(指南每次发版后) ## 升级(非必须,忘了也安全)
DJXDB 指南每发新版,本仓库会同步 bump skill 内的 KNOWN_GUIDE_VERSION: skill 不随指南发版刻意更新(见下方维护策略)。想手动同步时:
```bash ```bash
cd djxdb-skill && git pull cd djxdb-skill && git pull
rm -rf ~/.trae-cn/skills/djxdb-query && cp -r djxdb-query ~/.trae-cn/skills/ rm -rf ~/.trae-cn/skills/djxdb-query && cp -r djxdb-query ~/.trae-cn/skills/
``` ```
重启会话。即使忘了升级,skill 也会在调用 integration-guide-info 时发现版本 重启会话后生效。即使不升级,skill 也会在调用 integration-guide-info 时发现
不一致,自动拉取并播报新版指南要点——skill 过期是安全的,事实源在服务端。 版本不一致,自动拉取并播报新版指南要点——skill 过期是安全的,事实源在服务端。
## 维护策略(Owner 备忘,2026-11-03)
- 本 skill **有意低频维护**,停在某版本不是遗忘。正确性由服务端双保险承载:
KNOWN_GUIDE_VERSION 只是播报触发器,版本差会让 AI 自动
integration-guide-read 服务端最新指南全文,合同知识始终追平。
- 接受的代价(均在使用侧,轻微):每次会话多一次全文 read;版本播报起点
陈旧;工具速查表逐渐成为历史快照。
- 无仪式要求:结构性变化(新报表、口径、边界规则)后、生产 E2E 绿了,
顺手更新正文并把版本号带上即可;忘了零惩罚。
## 目录结构 ## 目录结构