用途
该技能用于把外部系统产生的事件（Webhook、API 轮询、IoT 设备等）翻译为领域事件，将技术性数据映射为业务概念。适用于与外部系统集成、需要把第三方事件接入自有领域模型的场景。
主要能力
- 访谈阶段（可选）：当用户未完整提供外部系统清单、事件格式或翻译规则时，通过关键问题收集信息。核心问题包括外部系统详情（系统名称、事件类型、数据格式、认证方式）与领域映射复杂度（直接映射、需聚合多事件、需其他系统数据）。
- 外部系统编目：枚举所有向领域发送事件的系统，记录事件类型、载荷格式、认证与投递机制（Webhook、轮询、流式）。
- 映射复杂度评估：识别需要领域数据补全的集成，暴露关联缺口（外部 ID ≠ 领域 ID），标记多源聚合场景。
- 翻译规则设计：为每个外部事件定义触发条件、前置条件、翻译逻辑、成功与失败场景。
- 关联处理：建立外部 ID 到领域实体的关联桥，例如通过引用表或外部载荷中的元数据。
- 重复与乱序处理：通过幂等检查避免重复事件，存储外部 ID 用于去重。
- 缺失数据补全：从自有系统查询上下文进行丰富，忽略不需要的数据，或对可推断信息做合理假设。
- 输出格式：提供外部系统与事件、翻译规则、关联参考、失败与恢复、测试建议等结构化输出模板。
- 质量清单：涵盖翻译规则覆盖、关联机制、去重、缺失数据处理、失败场景、敏感数据处理等检查项。
使用方式
技能以访谈与工作流结合的方式推进。若用户已提供完整外部系统清单、示例载荷格式与关联策略，则跳过访谈直接设计翻译规则；否则先进行访谈。访谈发现可追加到项目的事件建模文件中，路径为 .trogonai/interviews/[project-name]/EVENTMODELING.md，并更新访谈记录表。工作流步骤包括：识别外部事件源、分析技术表示、定义领域翻译规则、处理关联、定义翻译场景、处理重复与顺序、处理部分或缺失信息。
适用场景
- 支付网关（如 Stripe）Webhook 翻译为领域支付事件。
- GPS 位置服务的地理围栏进出事件翻译为领域事件。
- 第三方履约系统仅提供订单 ID 时的上下文补全。
- 定时轮询外部 API 获取事件并翻译。
限制
资料未提供该技能的具体安装命令、运行环境要求、收费方式或平台支持信息。技能本身为方法论与流程指导，不包含可直接执行的代码实现。