SuperAPI AI 工具集

event-modeling

设计与创作

查看项目

更新于 10-16 09:57

技能介绍

用途:教会智能体按 Martin Dilger 的“Understanding Eventsourcing”方法主持事件建模,产出由参与者、事件、命令、读模型、自动化与切片组成的完整事件模型,存于 docs/event_model/,驱动后续实现。核心原则:存“发生了什么”(事件)而非仅当前状态;事件是业务语言中的过去式不可变事实,每个读模型字段必须可追溯到事件。

流程:两阶段。阶段一领域发现,识别业务、参与者、主要流程、外部系统与要建模的工作流,产出 docs/event_model/domain/overview.md;阶段二逐工作流走九步流程(须参照 references/nine-steps.md),一次只设计一个工作流,完成九步再开始下一个,产出 workflows/<name>/overview.md 及 slices/ 下各切片文件。

四种模式:状态变更(命令→事件)、状态视图(事件→读模型)、自动化(事件→读模型→流程→命令→事件,需四要素齐全且有终止条件)、翻译(外部数据→内部事件,仅限工作流专属集成)。命令输入来自用户数据与事件流,绝不来自读模型。每种切片模式有最低架构层要求,缺层即不是完整垂直切片。

GWT 场景:为每个切片生成 Given/When/Then 验收标准,命令场景测试业务规则,视图场景不可拒绝事件;数据校验交给类型系统。每个切片至少含一个应用边界场景,从外部输入到可观察输出。可自动化则写验收测试,否则记录人工核对清单。共享事件模式的切片相互独立。完成 GWT 后校验模型完整性,发现缺口须向用户澄清并补齐。

适用场景:事件溯源系统的领域建模与设计阶段。限制:建模期间不谈数据库、API、框架或实现;不得跳过步骤、同时设计多工作流或带着缺口推进;独立模式为建议性,流水线模式为门禁;缺失依赖可用 npx skills add jwilger/agent-skills --skill domain-modeling 安装。收费、价格、平台等信息暂未提供。