skills/forge-town/skills/dao-best-practice

dao-best-practice

SKILL.md

DAO规范化技能

此技能帮助规范化DAO文件,使其符合项目的最佳实践。

使用说明

  1. 识别需要规范化的DAO文件,通常位于 apps/web/src/db/models/daos/

  2. 阅读参考指南:DAO最佳实践指南 以了解规范。

  3. 代码示例:DAO代码参考 作为参考。

  4. 使用检查清单验证文件是否符合规范。

  5. 重构文件以匹配指南中的模式。

重要: 调用完毕技能后,强制查看检查清单,并确保返回的内容完全匹配清单中的所有项目。

⚠️ 强制后置步骤:Repository 评估

每次完成 DAO 写方法的创建或修改后,必须立即执行以下评估:

"当前 DAO 的写操作是否涉及多张表?"

  • 否(单表写入) → 流程结束,确保 DAO 方法签名包含可选 tx 参数即可
  • 是(跨表写入)必须触发 repository-best-practice 技能,为该写操作创建对应的 Repository

此评估不可跳过,漏掉 Repository 会导致跨表写入缺乏原子性保证。

核心规范

  • 文件结构:文件名与表名一致,导出为对象。
  • 方法:使用驼峰命名,标准CRUD方法。
  • 类型安全:使用Drizzle类型推断。
  • 性能:使用分页、联表查询等。

如果需要更多细节,请阅读参考文件。

Weekly Installs
18
GitHub Stars
1
First Seen
Feb 9, 2026
Installed on
codex18
gemini-cli17
github-copilot17
amp17
kimi-cli17
opencode17