cue-kind-definition 是为 grafana-app-sdk 应用定义资源结构的 Skill。它用 CUE 写字段约束与版本信息,再生成类型和客户端。
一个资源既有共用信息,也有各版本的模式:spec 表达用户想要的状态,status 记录系统观察到的状态。新增版本要登记进清单,不是复制文件后就算可用。
稳定版本删除字段、改变类型或新增必填项等破坏性变化,应放到新版本。生成失败时回改 CUE 源文件,不手修生成目录,否则下次生成会覆盖。
主文给基础布局与约束例子,完整字段、命名类型和自定义路由另有引用,本文未展开。它适合先把资源契约写清的人;生成文件存在仍不代表旧数据兼容、迁移完成或运行验证通过。