SuperAPI AI 工具集

eventmodeling-orchestrating-event-modeling

编程与开发

查看项目

更新于 10-16 04:09

技能介绍

用途

该技能用于编排完整的 Event Modeling(事件建模)工作流,从需求梳理到代码生成。它将架构建模为 UI/Processor → Command → Event → Read Model 的结构。该技能本身不执行具体建模步骤,而是负责协调 9 个步骤的顺序、转换条件以及步骤之间需要传递的产物,每一步都委托给专门技能完成。

主要能力

  • 协调 9 步 Event Modeling 工作流,管理步骤顺序、转换条件和产物传递。
  • 访谈阶段:通过 AskUserQuestion 收集领域、需求状态、目标、约束和起点信息,并确认理解。
  • 将访谈记录写入 .trogonai/interviews/[project-name]/EVENTMODELING.md,并随步骤完成更新。
  • 支持从工作流中途进入:如果用户已有早期步骤的产物,从第一个未完成步骤继续,不重复已完成步骤。
  • 每一步都有明确的输入、需传递的输出和门禁条件(Gate),确保质量。
  • 最终产出完整的 Event Model,包括角色目录、事件时间线、UI 故事板、命令定义、读模型设计、系统边界、Given-When-Then 场景、完整性验证和验证报告。
  • 提供可选的后续技能,用于扩展模型以满足特定需求。

使用方式

该技能通过调用专门技能来执行 9 个步骤:

  1. 头脑风暴事件:调用 eventmodeling-brainstorming-events。输入领域需求和已有知识,输出事件列表和角色目录(所有人类角色和系统参与者)。门禁:角色目录存在且事件覆盖所有已知业务流程。
  2. 绘制事件:调用 eventmodeling-plotting-events。输入事件列表,输出按时间顺序排列的事件时间线,显示事件之间的因果依赖。门禁:时间线读起来像连贯的叙述。
  3. 故事板:调用 eventmodeling-storyboarding-events。输入事件时间线和角色目录,输出 UI 原型/线框图,每个角色一个泳道,显示每个屏幕展示和收集的数据。门禁:角色目录中每个角色至少有一个屏幕。
  4. 识别输入:调用 eventmodeling-identifying-inputs。输入故事板和角色目录,输出命令定义,每个命令归属于特定角色或系统处理器。门禁:故事板中每个 UI 操作映射到命名命令。
  5. 识别输出:调用 eventmodeling-identifying-outputs。输入事件列表和第 4 步的命令,输出读模型定义——为 UI 和处理器查询优化的事件投影。门禁:故事板中每个屏幕数据需求都由读模型满足。
  6. 应用康威定律:调用 eventmodeling-applying-conways-law。输入完整事件模型(事件、命令、读模型),输出系统泳道,将事件和命令映射到团队边界。门禁:每个边界可由团队独立拥有。如果康威定律边界与项目无关,可跳过此步。
  7. 细化场景:调用 eventmodeling-elaborating-scenarios。输入命令和读模型,输出每个命令和视图的 Given-When-Then 规格,包括正常路径、验证失败和边缘情况。门禁:每个命令至少有一个场景。
  8. 检查完整性:调用 eventmodeling-checking-completeness。输入完整模型(事件、命令、读模型、场景、角色目录),输出字段可追溯性矩阵,确认每个字段都有来源和目的地,并列出发现的缺口。门禁:所有缺口解决或明确接受。
  9. 验证:调用 eventmodeling-validating-event-models。输入完整事件模型,输出验证报告,包含 PASS / PASS WITH WARNINGS / FAIL 结论。门禁:PASS 结论后才能宣布模型可实施。如果 FAIL,处理发现的问题并重新调用验证技能。

可选——生产就绪检查清单:当模型用于生产时,调用 eventmodeling-validating-event-models-checklist。它跨 7 个阶段运行 23 项架构检查,独立于第 9 步返回 PASS / PASS WITH WARNINGS / FAIL 结论。第 9 步的 PASS 不能替代此检查清单。

适用场景

  • 学习事件建模。
  • 生成生产代码。
  • 设计验证。
  • 团队文档。

限制

  • 该技能本身不执行具体建模步骤,依赖专门技能完成。
  • 访谈阶段可跳过,前提是用户已提供清晰的领域描述、需求或范围,以及明确的输出目标。
  • 第 6 步(应用康威定律)在边界与项目无关时可跳过。
  • 生产就绪检查清单为可选,但生产就绪要求时不能以第 9 步 PASS 替代。
  • 资料未提供具体收费、价格、平台支持等信息。

可选后续技能

这些技能不属于 9 步主路径,但可扩展模型以满足特定需求:

  • eventmodeling-designing-event-models:当流标识、每个命令的状态形状或事件因果关系需要详细设计时使用。可在任何步骤应用,最常见于第 1 步期间或之后。
  • eventmodeling-optimizing-stream-design:模型完成后使用,验证流增长估计和快照决策。
  • eventmodeling-translating-external-events:当外部系统(webhook、IoT、第三方 API)需要输入领域模型时使用。
  • eventmodeling-slicing-event-models:第 9 步 PASS 后使用,将模型拆分为可独立部署的功能切片,并规划并行团队实施。

质量检查清单

  • 所有 9 个建模步骤完成——没有步骤被无故跳过。
  • 角色目录存在,包含命名的人类角色和系统处理器。
  • 每个命令归属于角色目录中的特定角色。
  • 每个读模型至少满足一个 UI 或处理器查询需求。
  • 每个命令至少有一个 Given-When-Then 场景。
  • 完整性检查显示没有未解决的字段可追溯性缺口。
  • 验证返回 PASS 或 PASS WITH WARNINGS,且所有关键问题已解决。
  • .trogonai/ 中的访谈记录已更新每个已完成步骤的状态。