mcpField
P
product-data-import

product-data-import

github.com/alpacalabsllc数据与数据库39645 次安装1 周前更新
代码仓库

关于 product-data-import

product-data-import 将提供的产品笔记、列表、CSV 或选定的工作簿数据整理为可审阅清单或已接受的导入清单。它保留来源证据和未知项,不将导入视为批准,也不自行写入规范产品记录。

主要功能

  1. 01解析提供的产品数据
  2. 02验证并转换结构化观察
  3. 03计算条件兼容的价格合计
  4. 04准备已接受的任务清单
  5. 05比较原生工作簿变更

适用场景

  1. 01将产品列表整理为审阅清单
  2. 02准备文档任务的导入清单
  3. 03检查选定工作簿变更的保留情况

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/alpacalabsllc/skills-for-architects --skill product-data-import

安装后在 Claude Code 中输入/product-data-import确认已加载。

附带文件host-contract.jsonREADME.md

详细介绍

/as:product-data-import — 产品数据与受理内容

阅读 宿主契约、声明(skill:product-data-import)和选定的共享配置文件。使用原生功能;交付声明不代表具备访问或执行证据。

宿主适配器:阅读交付方式专属指南,了解调用、提问、文件访问和可选委派。

选择实际结果

将提供的笔记、CSV、粘贴的列表、观察记录或选定的工作簿数据规范化为可供审核的明细表。只有在请求文档任务受理时,此技能才负责管理已接受的 ffe/jobs/<job-id>/input-manifest.json。内联预览无需项目或写入。一次性样例使用获授权的现有任务输出根目录,不创建 PROJECT.md,也不注册工作室。与项目绑定的工作会解析上下文,读取其说明并保留不可变标识。

采纳的规格归 master-schedule 管理;可复用的 product-library.csv 变更归 product-library 管理。在现有授权范围内,准备完整的限定范围交接,其中包含实际证据和预期修订版本/哈希。本技能不会写入这些记录,也不会从导入操作推断选择或批准。请求已注册的报告时,使用 receive 的原生文档所有者;一次性导出无需注册采纳。

解析、验证并呈现

接受所提供的格式,不要求用户重新整理。仅提取有证据支持的产品名称/制造商、明确的变体/SKU、数量、价格/货币/计价依据、注明来源的尺寸/单位、材料、饰面和类别。保留来源引用、定位信息、实际观察时间和未知项。可选配置不等于已选定的规格。不要编造 SKU 组合、轴/单位、根据 $ 推断货币、缺失尺寸或权威标签。保留提供的精确标签;缺少标签时可以提出待审核的建议,但不得悄悄将其确认为 ID。

对于已输入的证据,请完整阅读观察记录所有者和架构。product_observations.validate 和 validate-batch 会强制检查所有结构和语义;adapt 需要明确绑定已选项目/当前修订版本,并返回仅供审核的提案。将审计观察记录、冲突和通知与原始信封一并保留。保留原始证据中的未知项,同时使用旧版不可用审计投影。现有目标值(包括 null/空白值和用户覆盖值)保持不变。验证/适配既不会检索也不会写入规范记录。

阅读产品架构,了解精确类别和货号前缀。根据请求的视图,将 Markdown 表格按类别分组,并在适用时按货号排序;任务选择时保留已接受的输入顺序。仅使用精确十进制值以及兼容的货币/计价依据,计算单价乘以明确数量。按货币分别汇总,区分提供的预算范围与观察到的价格,并将未知项/TBD 标明,不作猜测。已填写的示例或来源说明都不能作为产品证据或权威依据。

如果请求读取/编辑原生工作簿,应确认实际值、公式、真实超链接、选定图片和结构,并保留原生备份/提供方修订版本。CSV 无法保留工作簿功能。对于已采纳的变更,将完整映射的证据/冲突交给 master-schedule,以便协调并进行任何获授权的修订;一次性工作不代表采纳,也不意味着生成规范快照。若不支持访问,应提供范围明确的交接,不得将替代工作簿冒充原始工作簿。

已接受的作业清单

阅读完整的原生接收负责人、接收架构和身份架构。ffe_intake.prepare 接收明确的模式、确切的作业 ID、来源包/状态/哈希、按序排列的所选标签、可选的所选模板来源、固定的记录依据、supersedes、执行者和原因。带点号的标签必须保持原样;作业 ID 和输出文件名各自遵循不同规则。每个来源都必须明确包含 sha256;可用文件根据实际字节计算哈希,可用 URL 则需要由主机捕获的哈希。缺失、null、不匹配和已验证的哈希是不同状态。

单次模式下,记录依据为 null。采用模式下,通过主日程表的记录负责人和架构,读取确切的固定日程/条目;验证其哈希和所选成员资格,不得以当前状态替代。即使附件字节相同但范围不同,更正也必须创建通过 supersedes 关联的新作业。输出工作流会单独解析有效的设计/模板依赖项。接收不会授予审批权限,也不会渲染文档。

将原生变更序列应用于新的输入清单,并提供其来源/依据保护条件、现有的先前作业证据以及不存在条件。保留完整的准备后字节和恢复状态,完成所有持久化保存,并在无覆盖发布之前,独立重新打开/验证所有保留内容以及实际访问元数据。重新打开实际清单的完整字节、逻辑 input_hash、来源/身份关系,以及实际模式/所有权/ACL,然后再报告已接受的接收。接收使用自身紧凑的ASCII 转义逻辑哈希语法,而不是观测用的 Unicode 摘要或工件字节哈希。

对完全相同的作业/相同的规范化意图重试时,只验证先前结果,不写入;意图变更则需要创建通过 supersedes 关联的新作业。绝不覆盖先前清单,也不得仅凭哈希/回执推断已完成。对于不支持的保证和不确定的发布,保留明确的受阻/待处理结果,并附上恢复引用。

可选的可复用保存和最终报告

对于明确请求的可复用保存,依据产品架构和CSV 约定准备完整的行,然后将一个完整批次交给产品库的原生负责人。现有的确切授权继续有效;仅获取缺失的实质范围/权限。来源为 product-data-import;状态为 saved(仅当明确确立了所选项时才指定);产品/项目标签保留在 Tags 中。由于产品库没有数量列,数量/总价应放在 Notes 中。不要逐行循环处理,也不要独立写入产品库。

报告实际产出的内容:行内预览、已验证的审核提案、包含路径/input_hash 的已接受清单,或经独立验证的负责人保存结果。保留尚未解决的数据、范围、来源和限制。product-cut-sheet/ffe-spec-book 使用已接受的输入;研究、补充信息、清理、审计和采用仍是单独请求的结果。Arch Studio 可执行文件或已安装的运行器都不是前提。

原生工作簿保留比较

如果已明确选定前后两个原生 .xlsx 或 .xlsm 文件,且允许进行单元格编辑,则加载完整的工作簿比较责任方,并通过实际的 ZIP/XML 检查执行原生 workbook_preservation.compare。保留完全一致的成员字节、声明的工作表/单元格属性、公式/缓存的区别以及 XML 空白规则。此只读比较不授权编辑,也不能替代任务要求的实际目标单元格回读、备份、功能检查、重新计算或视觉验证。对于提供方格式或二进制格式,以及无法达到的检查精度,均须明确标注为差距;绝不要通过重新保存/转换工作簿来掩盖这些问题。无需使用 Arch Studio 辅助工具或进程运行时。

评论

支持 Markdown