SuperAPI AI 工具集

product-data-import

数据与分析

查看项目

更新于 10-15 19:55

技能介绍

用途:把用户提供的笔记、CSV、粘贴列表、观察记录或选定的工作簿数据,规范化为可审阅的 FF&E 清单;在请求文档作业录入时,生成 ffe/jobs/<job-id>/input-manifest.json。行内预览无需项目或写入。

主要能力:接受原始格式,不要求用户重排;仅提取有证据的产品名称/厂商、明确变体或 SKU、数量、价格/币种/基准、来源标注的尺寸与单位、材料、饰面和类别,并保留来源引用、定位、观察时间与未知项。可输出按类别分组、按项目编号排序的 Markdown 表格;用无损小数计算单价乘数量,仅在币种与基准兼容时合计,区分预算区间与观察价格,标记未知或 TBD。

使用方式:先读取宿主契约、声明 skill:product-data-import 及选定共享配置,并读取宿主适配器关于调用、提问、文件访问与可选委托的说明。类型化证据使用 product_observations.validate 与 validate-batch,适配需显式绑定所选项目与当前版本,仅返回审阅用提案。作业入口由 ffe_intake.prepare 传入显式模式、确切 job ID、来源包/状态/哈希、有序选定标签等;来源均为 sha256,缺失、null、不匹配与已验证哈希要区分。相同作业与相同意图的重试只校验不写入,意图变更需新建一个以 supersedes 关联的作业。

适用场景:一次性样本可写入已有授权任务输出根目录;项目绑定工作需解析上下文并保持不可变身份。显式请求的可复用保存须整批交由 product-library 的原生所有者处理,不得逐行循环或独立写入产品库。

限制:不发明 SKU 组合、轴/单位、币种或权威标签;缺失标签只能作为待审提案。可用配置不等于已选规格。不覆盖旧清单,不凭哈希/回执推断完成。本技能不写入 master-schedule 或 product-library 记录,也不从导入推断选定或批准。无法访问时保留带边界的精确交接,不得以替代工作簿冒充原件。工作簿保留比较需显式选定的前后 .xlsx/.xlsm 与允许的单元格编辑,仅做只读比较,不授权编辑。是否提供 Arch Studio 可执行文件或运行时为可选,非前置条件。官方文档与收费信息暂未提供。