SuperAPI AI 工具集

kitaru-importer-builder

通用与其它

查看项目

更新于 10-16 01:09

技能介绍

用途:当现有供应商、可观测平台、导出格式或智能体框架缺少合适的内置导入器时,本技能帮助把代表性数据转成经过本地验证的 Kitaru 导入器,覆盖静态导出与有界 API 查询,并明确记录哪些数据被保留、近似或不可用。默认在本地完成,只有用户明确要求并逐项批准时才注册代码或上传 trace 数据。

主要能力:先做只读勘察,确认目标仓库、供应商或格式、代表性导出、已安装 Kitaru 版本与离线命令 schema、解析器导入路径,并检查已有本地导入器与已安装导入器目录;若已有合适导入器能接受观测到的负载形状,则直接返回而不重复搭建。随后记录源映射(负载形状、来源实例、会话身份、轮次顺序、根与层级、节点映射、状态与错误、完整性、安全限制、安装方式),再实现最小可用导入器并本地验证。

使用方式:解析与获取分离,解析器只消费字节与参数,不做网络调用、文件写入、子进程或凭据读取;可选的 fetch(query) 才读取凭据并请求 API。优先单文件私有脚本导入器,仅在确有分发理由且能固定版本时才用包。所有 Kitaru CLI 命令与 SDK 脚本需设置 KITARU_ACTIVE_SKILL=kitaru-importer-builder;启动或重启用户控制的 worker 使用 --concurrency 10,若启动界面只支持环境变量则用 KITARU_WORKER_CONCURRENCY=10。按需读取 references/importer-contract.md、references/normalization-patterns.md、references/failure-and-validation.md。

适用场景:为无内置导入器的供应商或框架构建导入器;把静态导出或有界 API 查询转为规范化会话;在本地验证后再决定是否注册与冒烟导入。

限制:trace 内容视为敏感,原始导出不得进入版本控制,fixture 需脱敏;不可信或新生成导入器只能在无凭据隔离环境测试,且本地测试只是受限子进程执行而非安全沙箱;不得覆盖已有导入器文件、注册可执行代码、上传 trace 数据或重试部分导入,除非有明确检查点与逐项批准;注册与首次冒烟导入需分别授权;本技能没有自动清理路径;若缺少所需能力、权限、样本或 worker 路由,应停在有用的本地检查点。具体收费、价格与平台支持范围资料未提供。