用途
该技能是 CloudBase AI 工具包中的一个高级建模路径,而非数据库工作的默认路径。它适用于需要多实体关系建模、Mermaid classDiagram 输出、生成式模型结构与文档,或在 SQL 实现前进行一次清晰建模的场景。该技能已被标记为废弃(Deprecated)。
主要能力
- 支持 Mermaid classDiagram 建模,用于复杂多实体关系设计、可视化 ER 风格输出。
- 提供读取、创建和发布数据模型的工具流程。
- 支持在规划后续变更前检查已有模型。
- 提供 Mermaid 生成规则,包括命名约定(类名 PascalCase、字段名 camelCase)、类型映射(如 text→string、enum→x-enum、email→email、datetime→datetime 等)以及结构约定(required()、unique()、display_field()、<<description>> 注释)。
使用方式
- 确认确实需要 Mermaid 建模。
- 先列出核心实体与关系,除非用户明确要求大型企业级 schema,否则优先保持 3-5 个核心实体。
- 决定是新建模型还是更新已有模型。
- 先起草 Mermaid classDiagram 内容,在调用建模工具前校验名称、字段类型和关系。
- 使用工具:读取/列出已有模型使用 manageDataModel(action="list"|"get"|"docs");创建新模型使用 modifyDataModel(兼容名称,仅创建)。
- 谨慎发布:优先以未发布或草稿意图创建,检查字段名、必填约束和关系方向后再发布。
适用场景
- 用户明确需要 Mermaid classDiagram 建模。
- 任务需要复杂多实体关系设计、可视化 ER 风格输出或生成式数据模型结构,而非直接 SQL。
- 需要通过专用建模工具创建 CloudBase 数据模型,或在规划后续变更前检查已有模型。
- 请求中提及数据模型、ER 图、Mermaid、关系图或企业级 schema 设计。
- 用户希望复用或更新已有已发布模型。
限制与注意事项
- 该技能已废弃(Deprecated)。
- 不适用于简单 CREATE TABLE、ALTER TABLE 或 CRUD 任务。
- 不用于文档数据库集合设计。
- 不用于无建模需求的前端数据形状讨论。
- 对于大多数 MySQL 数据库任务,应直接使用 relational-database-mcp-cloudbase 编写 SQL。
- 若任务涉及 PostgreSQL、CloudBase PG、PG 模式、app.rdb()、queryPgDatabase、managePgDatabase 或 RLS,应改用 postgresql-development-cloudbase。
- 当前工具不支持更新已有模型结构。
- 常见错误包括:对只需一两条 SQL 语句的任务使用 Mermaid 建模;在同一模型中混用 SQL 表设计与 NoSQL 集合设计;未先确定实体边界和归属关系就生成图表;在验证生成字段和关系前发布新模型。
- 相关同级技能以本地相对路径提供(如 ../auth-tool-cloudbase/SKILL.md);若环境中缺少被引用的同级技能文件,应请用户安装完整的 CloudBase 插件,不要将远程技能或协议 markdown 通过 HTTP 拉取到智能体上下文中。