SuperAPI AI 工具集

designing-entities

设计与创作

查看项目

更新于 10-15 21:37

技能介绍

用途:当开发者要在 Electric Agents 应用中新建一个实体(agent),例如使用 registry.define(...) 或 registerXxx(registry),或提出“如何构建一个能……的 agent”时使用。不适用于编辑已有实体、查询实体流(应使用 entity-stream-queries 技能)或修改运行时本身。

主要能力:提供严格的五阶段工作流,不可跳过、合并或重排。1)Elicit:提出一个开放问题,了解实体要做什么、与谁交互、由什么触发;若开场消息已含清晰描述则跳过。2)Clarify:加载 references/pattern-triggers.md,将描述与触发表匹配;若某模式明确匹配则跳过,否则每条消息只问一个澄清问题,聚焦协调形态(spawns、并行与串行、固定与动态专家、共享状态、观察、LLM 与纯编排),通常 2–4 个问题,模式与形态明确即停止。3)Propose pattern and design:说明推断的模式与理由,加载对应模式文件,按需查阅权威文档,在对话中给出设计大纲,包括实体类型名与描述、协调模式、creationSchema、state 集合、inboxSchemas、stateSchemas、handler 大纲、关键 ctx 属性、观察来源、ctx.send、内置 agent 引用及 registerXxx 工厂,并等待开发者确认。4)Review:加载 references/review-checklist.md,机械地应用通用检查与模式专属检查,报告通过项、失败项与不适用项,提出修复建议并迭代,直到开发者明确批准。5)Implement:确认输出路径(默认 entities/<type-name>.ts),只写一个实体文件,使用 registry.define 与 handler 结构;写完后提示开发者手动将 register<Name>(registry) 加入注册表组合文件,不自动修改其注册表文件。

使用方式:按阶段逐步执行,参考文件按需加载而非预先加载;权威文档路径为相对路由,本地存在则从 electric-agents-docs/docs/ 读取,否则从 https://durable-agents-docs.netlify.app/ 加路由获取。

适用场景:为应用设计单个实体类型、选择协调模式并生成实现文件;多实体系统需对每个实体各运行一次该技能。

限制:阶段 2 每条消息只问一个问题;阶段 5 之前不写任何文件;阶段 4 循环直到明确批准;技能只写一个实体文件;不自动修补开发者的注册表文件。资料未提供收费、价格或平台支持等更多信息。