SuperAPI AI 工具集

temporal-playground

设计与创作

查看项目

更新于 10-16 08:11

技能介绍

用途:Temporal Playground 是一个可视化、基于节点的工作流设计器,用于设计、编辑并生成 Temporal 工作流。用户通过拖拽节点、在画布上连线来设计工作流,然后把结构化规格发送给 Claude 进行实现。它通过动态扫描和 Temporal MCP 文档服务器与项目现有工作流集成。

主要能力:支持可视化设计 Temporal 工作流;扫描 monorepo 中的工作流文件,返回名称、服务、文件路径、信号、查询、更新、活动(含超时/重试配置)、子工作流和条件等结构化元数据;UI 挂载时通过 GET /api/workflows 自动发现工作流,按服务分组展示;可将 WorkflowMetadata 转换为 React Flow 节点/边;生成自然语言与 JSON 两种规格输出;提供 temporal-docs MCP 服务器查询实时 Temporal 文档。

使用方式:Claude Code 通过 .mcp.json 自动启动 MCP 服务器(HTTP :4343 + stdio)。启动 Vite UI:pnpm playground:dev(热重载,:4344,代理 API 到 :4343)。独立/生产模式:pnpm playground(API + 静态 UI,:4343)。构建:pnpm playground:build。安装 UI 依赖需进入 .agents/skills/temporal-playground/ui 使用 npm install(非 pnpm)。调用 temporal_scan_workflows 扫描工作流,调用 temporal_watch 等待提示,根据 [CHAT] 或 [APPLY CHANGES] 标签分别处理:聊天仅修改画布草稿,应用更改则修改代码文件。

适用场景:用户想可视化设计 Temporal 工作流、检查或修改 monorepo 中的现有工作流、从可视化规格生成工作流代码、请求“构建工作流”“设计工作流”或“打开工作流构建器”,或交互式探索 Temporal 模式。

限制:资料未提供收费、价格、平台支持范围等信息。需注意避免硬编码与源文件脱节的工作流结构、未查 Temporal 文档 MCP 就生成代码、在用户加载现有工作流时新建文件、遗漏 allHandlersFinished 条件、在工作流函数内执行非确定性操作。