busic-database

SkillDatabases & data

BuSic数据层规范。用于Drift表定义、迁移、Repository实现和Domain模型映射时快速确认主真源与联动检查项

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the busic-database skill

What this skill tells your AI

The instructions your AI receives, as published by glowled/busic in .agents/skills/busic-database/SKILL.md and read by ahel’s review.

何时使用

  • 新增或修改 Drift 表
  • 调整 schemaVersion、迁移逻辑或 Repository 映射
  • 想确认 Domain 模型、DB 表和 Repository 的职责边界

先看这些真源

表与迁移 checklist

改表时至少同步检查:

  1. 表定义文件
  2. @DriftDatabase(tables: [...]) 注册
  3. schemaVersion
  4. onUpgrade
  5. build_runner

命令:

dart run build_runner build

Agent 执行时,dart run ... 通常需要提权到沙箱外;完整分类见 busic-harness-workflow

Repository 规则

  • Repository 接口和实现都放在 data/
  • Domain 模型与 DB 表分离,由 Repository 负责映射
  • Repository 不是业务状态容器;业务编排仍在 Notifier
  • 需要长期存活的 Repository,再交给手动 Provider 管理

常见联动

  • 下载链路不要只改任务表,记得回写 songs.localPathsongs.audioQuality
  • 分享 / 备份不要把本地路径写进跨设备数据
  • 数据库变更后,测试要优先验证真实表状态,而不是只断言中间变量

相关 Skill

Signals

GitHub stars
28
Forks
8
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
busic-database
Source
github.com/glowled/busic