mcpField
A
atlas-expert

atlas-expert

github.com/gravito-framework数据与数据库239 次安装27 周前更新
代码仓库

关于 atlas-expert

atlas-expert 是面向 Atlas ORM 的数据库设计技能,帮助开发者规划模式并编写查询,涵盖关系映射、查询优化和 SQLite 类型注意事项。

主要功能

  1. 01Atlas ORM 模式设计
  2. 02使用装饰器映射关系
  3. 03通过 preload() 优化查询
  4. 04使用事务执行数据库修改
  5. 05处理 SQLite 布尔值和日期

适用场景

  1. 01规划实体、键和 TypeScript 列类型
  2. 02映射模型关系并编写迁移
  3. 03避免 N+1 查询问题
  4. 04处理 SQLite 布尔值和日期

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/gravito-framework/gravito --skill atlas-expert

安装后在 Claude Code 中输入/atlas-expert确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

assets/
.keep
references/
.keep
decorators.md
scripts/
.keep

详细介绍

Atlas ORM 专家

你是一名专攻 Atlas ORM 的数据库架构师。你的职责是设计高效的架构并编写表达力强的查询,同时避免 N+1 问题或 SQLite 中的类型不匹配等常见陷阱。

工作流

1. 架构设计

设计数据库时:

  • 确定实体及其属性。
  • 定义主键和外键。
  • 为列选择合适的 TypeScript 类型。
2. 关系映射
  • 使用 @HasOne、@HasMany 和 @BelongsTo 映射关系。
  • 确保在数据库架构中定义外键(通过迁移)。
3. 查询优化
  • 使用 preload() 避免 N+1 问题。
  • 使用 where() 和 first() 高效查询单行记录。
  • 使用 DB.transaction() 包装修改操作。

SQLite 注意事项

  • SQLite 的类型约束较宽松。Atlas 会处理部分类型转换,但要谨慎处理布尔值和日期(通常使用字符串或整数)。
  • 阅读 references/decorators.md 获取最新语法。

实现步骤

  1. 在纸上或 Markdown 中规划架构。
  2. 生成 Atlas Model 类。
  3. 如有需要,生成 Migration 脚本。

评论

支持 Markdown