SuperAPI AI 工具集

event-definition

通用与其它

查看项目

更新于 10-16 07:15

技能介绍

用途:审查或创建事件驱动系统中的事件定义,重点保证事件身份、命名、字段归属、记录边界与质量门禁。默认只围绕这几点检查,仅在需要示例或深入建模时按渐进披露加载参考文件。

主要能力:区分领域事件与集成事件;规范事件命名(用过去时、领域语言、一事一事件、统一命名格式、避免 Event/Message 等冗余后缀及基础设施名称);规范集成事件的前缀与共享词汇;界定 event_type 与流名称身份;规范字段命名(显式标识符、_at/_on 时间、枚举优先布尔、金额带币种、集合用复数、拆分多态载荷、避免事件中直接放 PII);区分记录元数据、事件上下文/信封与业务载荷。记录元数据如 event_id、stream_id、stream_version、recorded_at;事件上下文如 event_type、actor_id、on_behalf_of、occurred_at、correlation_id、causation_id;载荷放业务事实。

使用方式:先确认是领域还是集成事件、所属业务流程以及代码库既有约定,已有事件目录则优先遵循。用户给出定义则直接审查,否则先收集业务上下文再设计。必要时读取 references/event-naming-rules.md、references/field-naming-rules.md、references/event-record-boundaries.md、references/quality-checklist.md。

输出:列出审查事件及各项质量检查的通过/失败、违规修正建议、领域与集成分类、字段命名修正及理由、有争议的载荷与上下文归属。

限制:actor_id 仅表示发起者,不能据此推断归属或授权;事件处理器与投影应消费不可变记录事件,回放时避免时钟、随机 ID、角色查询或授权服务。资料未提供具体安装命令、平台或价格信息。