SuperAPI AI 工具集

generate-connectivity-knowledge

编程与开发

查看项目

更新于 10-16 01:31

技能介绍

用途:当某 SaaS 在 Exchange 中没有专用 Mule 连接器时,本技能生成 Mule HTTP-Connector 流程集成所需的连通性知识。它通常由 build-mule-integration 在其 Step 3a(HTTP 回退分支,get_latest_connector.sh 未找到合适连接器)调用,流程生成器据此配置 HTTP Request 操作的正确认证、分页与实体结构。

主要能力:按三阶段推进——研究 API、生成 OpenAPI 3.0 规范、对每个操作进行实机验证,并在 connectivity-schema/<apiName>/ 下输出自包含文件夹,包含 api-reference.md、<apiName>.yaml 和占位的 config.properties。api-reference.md 的认证、速率限制、用例与实体参考部分供 build-mule-integration Phase 2 生成 HTTP Request 配置与 DataWeave 转换;<apiName>.yaml 是可发布到 Exchange 的真实 OpenAPI 3.0 规范。

使用方式:从 $ARGUMENTS 解析 apiName(kebab-case)与 useCases,可选 Project Folder 与 documentation URL;若缺失 apiName 或 useCases 需询问用户。工作流依次为 INPUTS、DOC_DISCOVERY、PRIMARY_ENDPOINTS、PRIMARY_ENTITIES、CRUD_COMPLETION、DEPENDENCY_ANALYSIS、SECONDARY_CRUD、ACTION_PLAN、DEEP_RESEARCH、API_REFERENCE_CONSOLIDATION、OPENAPI_SPEC_GENERATION、VALIDATION_PREREQUISITES、VALIDATION_LOOP、FINAL_REPORT。研究与规范生成阶段自主运行;实机验证阶段除四个强制暂停点外自主运行:凭据收集(config.properties 缺失或缺少必需键时必须暂停等待)、实体 ID 提供、破坏性操作(DELETE 或破坏性 PUT)确认、验证循环结束后存在失败操作时询问处理方式。认证失败(401/403)会立即中止循环并给出中止报告。凭据安全为强制要求:绝不读取、显示、回显、记录或推理 config.properties 中的凭据值;检查键是否存在用 grep -c '^KEY_NAME=' config.properties;注入 curl 用 $(grep '^KEY_NAME=' config.properties | cut -d'=' -f2-)。

适用场景:为缺少专用 Mule 连接器的 SaaS 构建集成连通性知识;产出最小忠实规范,仅覆盖用户用例加一个连通性测试端点,而非全量端点目录。

限制:需先确认至少一个可访问且含端点文档的资料源,否则不得继续;OpenAPI 规范不存在时改用人类可读文档;字段名、类型与约束必须照文档复制,不得推断。其他功能、收费、价格、平台或效果信息暂未提供。