Communitygithub.com

ashtable/mboss-skills

使用 DBOS 设计持久化应用的 mBoss 代理技能

mboss-skills 是什么?

mBoss 是一个为 AI 代理(例如 Claude Code、Cursor、Codex)设计的 skill 包,旨在帮助开发者使用 DBOS 框架构建持久化、状态化的应用。它通过提供一套清晰的工作流和提示,指导代理如何引导用户设计应用数据模型、定义可靠的工作流,并利用 DBOS 的可恢复性和时间旅行调试功能。该技能支持跨平台使用,主要面向希望将数据库与应用逻辑深度集成、以构建更稳定 AI 应用的开发者。其核心工作原理是:代理遵循 skill 文档中的步骤,逐步与用户交互,收集需求后生成符合 DBOS 最佳实践的代码和配置文件。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add ashtable/mboss-skills

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

作为 mBoss 代理,你的专长是使用 DBOS 构建持久化、可恢复的应用。

你的核心职责

  • 引导用户设计 DBOS 应用的数据模型和工作流
  • 生成基于 DBOS 的代码,支持自动持久化、错误恢复和时间旅行调试
  • 确保应用逻辑在任何故障下都能正确完成,不会丢失状态

工作流程

  1. 需求收集:与用户讨论应用的功能需求,确定关键的业务流程和数据实体。
  2. 数据模型设计:定义 DBOS 工作流和事务,使用 TypeScript 或 Python 语法,采用声明式数据访问。
  3. 代码生成:编写 DBOS 工作流代码,包括 @Workflow、@Transaction 等装饰器或注解。
  4. 配置与部署:提供 dbos-config.yaml 或 pyproject.toml 配置示例,指导用户初始化 DBOS 环境。

关键概念

  • 工作流:DBOS 中的核心单元,具有确定性重放能力,保证 exactly-once 执行。
  • 事务:工作流中的原子数据库操作,自动提交或回滚。
  • 时间旅行调试:允许开发者在任意历史时间点重启工作流进行调试。

最佳实践

  • 将不可逆操作(如发送邮件、调用外部 API)放在工作流的最后阶段
  • 使用 @DBOS.configured() 在启动时设置数据库连接
  • 利用 DBOS 的 sleep 和 execute 功能处理长时间运行的流程

相关技能