product-enrich

/as:product-enrich — 产品信息补充

执行前，请阅读宿主契约和此组件的声明（skill:product-enrich）。仅加载共享目录中引用的模式配置。根据实际任务组合所需模式；声明是要求，不代表已获得访问权限或许可。

库变更由 /as:product-library 负责。准备完整的选定行／变更集及证据，然后在现有授权范围内移交，由其执行原生保存。该负责人会验证整个批次，将确切请求、预览和当前状态关联起来，并核实实际发布情况。此技能不会自行修改 product-library.csv。

宿主适配器：请阅读交付专属指南，了解调用、提问、目标访问和可选委派。

记录权威与宿主交接

如需交接结构化证据，请阅读完整的原生产品观察数据所有者说明和schema。对整个信封应用原生 validate/validate-batch，仅通过明确的所选项目／当前修订版／字段绑定进行适配。保留精确的类型化值、来源／定位信息／时间和未知状态；完整保留信封、审计观察记录、冲突和通知。现有的 null／空白／用户覆盖值必须保留。这些是尚未采纳的证据和审核提案，绝不构成编写规范的授权。

对于绑定到项目的工作，应用原生上下文解析，使用经过验证的项目身份，并阅读项目说明。内嵌或一次性的源资料工作无需创建项目。product-library 负责可复用的 CSV 存储；master-schedule 负责已采纳的规范身份／修订版，product-data-import 负责已接受的任务输入。不得根据目录、源文档或交付声明推断权威性。

明确区分已采纳的项目计划、一次性源资料工作，以及可选的可复用 product-library.csv。已采纳的项目／计划记录具有权威性；通过 /as:master-schedule 读取固定的修订版，并向该所有者提议变更，同时提供预期修订版、证据并保留覆盖值。此技能不会自行重写规范项目／计划记录，也不会推断审批状态。以下保存到库的说明仅适用于可选的 CSV 库；不会采纳或更新项目计划。

宿主使用其可用功能读取和编辑所提供的工作簿。保留原始文件、选定图像、公式、真实超链接和无关单元格。对于已采纳的计划，通过 /as:master-schedule 执行采纳／协调，并在编辑前创建原生备份，同时生成经过验证的编辑前／后记录 CSV 恢复快照；另行保留宿主提取的工作簿数据和映射。在一次性模式下，宿主在任务恢复文件中保留原生备份以及实际从工作簿提取的 CSV 快照／映射，不调用计划快照，也不采纳记录。三方冲突和拟议删除都需要明确解决方案。若不支持访问工作簿，应提供准确的交接说明，不得谎称已完成。对于一次性工作，已接受的源资料仍是任务输入，不会被隐式采纳。

为每条观察记录保留来源身份、页面／URL 定位信息、检索时间、所选与可用配置、单位和不确定性。绝不虚构 SKU 组合、尺寸、饰面选择、价格或货币；仅有 $ 不能明确表示货币。除非明确更改，否则保留用户选择。当前事实性声明必须基于实际检索到的来源；无法访问的证据仍为未知。/as:product-data-import 负责已接受的任务输入和更正；/as:product-audit 报告差异，但不会默默应用更改。/as:product-cut-sheet 和 /as:ffe-spec-book 使用共享的文档模板，并由宿主在输入解析后进行渲染。

从最近项目的 product-library.csv 或粘贴的数据中读取产品行，并为缺少类别、颜色、材料和风格元数据的产品提出补充建议。

适用场景

• 批量导入后，产品缺少类别或标签
• 设计师快速收集产品，但未填写详细信息
• 统一来自不同来源的产品元数据
• 生成 FF&E 计划前（丰富的数据有助于生成更好的计划）

步骤 1：接受输入

以任意格式接受产品数据：

CSV 文件：

/as:product-enrich ./products.csv

粘贴的数据：

Synthetic formatting input only:
Example Product A | Example Manufacturer | quantity 2 | supplied specification pending

步骤 2：分析每种产品

对于每种产品，区分来源规范字段与明确标注为暂定的描述性分类：

类别

映射到 ../../schema/product-schema.md 中定义的规范词汇（22 个术语）。

子类别

类别中的更具体分类：

• Chair → Task Chair、Lounge Chair、Dining Chair、Side Chair、Stool、Bench
• Table → Dining Table、Coffee Table、Side Table、Console Table、Conference Table
• Light → Pendant、Floor Lamp、Table Lamp、Wall Sconce、Ceiling、Task Light、Chandelier
• Sofa → Sofa、Sectional、Loveseat、Daybed、Settee
• Storage → Credenza、Bookcase、Filing Cabinet、Wardrobe、Sideboard、Dresser
• Desk → Writing Desk、Executive Desk、Standing Desk、Workstation

可选颜色／饰面与已选颜色／饰面

将有制造商证据支持的可选项与有证据支持的已选配置分开记录。Colors/Finishes 填写可选项；Selected Color/Finish 填写用户明确选择或有来源依据的选择，不得推断选择。仅有已选颜色并不构成完整的可选项列表。暂定的视觉描述应标注在 Notes 或预览中，不得放入这两个事实性饰面字段：

• 在事实性字段中保留来源中的准确饰面名称。可以提出 Black、White 或 Brown 等宽泛颜色标签作为描述性标签，但不得用这些标签替代原名称。

材料

主要材料，以逗号分隔：

• Wood（已知时注明类型：Walnut、Oak、Maple、Teak、Birch、Ash、Beech）
• Metal（注明类型：Steel、Aluminum、Brass、Chrome、Iron、Copper）
• Upholstery（注明类型：Leather、Fabric、Velvet、Bouclé、Mohair、Linen、Wool）
• 其他：Glass、Marble、Concrete、Ceramic、Plastic、Fiberglass、Rattan、Cane、Acrylic

风格标签

从以下类别中选择 2–4 个描述性标签：

• 时期／运动：Mid-Century Modern、Art Deco、Bauhaus、Scandinavian、Japanese、Industrial、Contemporary、Traditional、Minimalist、Postmodern、Memphis
• 特征：Organic、Geometric、Sculptural、Modular、Stackable、Compact、Statement、Classic、Iconic
• 使用场景：Residential、Contract、Hospitality、Healthcare、Education、Outdoor

图像分析

当用户要求进行视觉补充，且来源中包含命名为 Image URL 的字段时，应通过可用的主机图像能力建立实际授权的图像访问，并检查图像字节。无法访问时，视觉补充视为未经验证。对于缺失的事实属性，仅在获得授权时检索现有产品的相关原始资料；否则保留未知状态。检查图像以获取暂定的视觉描述。图像本身无法验证材料构成或已选饰面。图像可能提示：

• 所示光照下的表观颜色
• 表观纹理，并明确标注为推断
• 风格特征

步骤 3：展示预览

应用前，展示带有证据状态的预览。此示例表格仅供说明，并非产品证据；不得将其中的示例饰面复制到实际选择中：

Synthetic formatting input only:
Example Product A | Example Manufacturer | quantity 2 | supplied specification pending

标记补充信息不确定的任何产品：

⚠ "Custom Reception Desk" — unknown product, category set to Desk but verify

步骤 4：应用

添加到项目库

读取 ../../schema/product-schema.md 和 ../../schema/csv-conventions.md。将有证据支持的补充信息映射到规范命名字段：Category、Materials、可选的 Colors/Finishes，以及明确确定的 Selected Color/Finish。保留现有选择和已填写的值，除非已获授权进行精确更改。将推断出的颜色、纹理、材料或子类别描述标注在 Notes 中；可将建议的描述性风格标签追加到 Tags，并在 Notes 中保留其判断状态。不得将视觉推断转化为规格事实。

对于多条补充信息，生成完整的 33 列 CSV 提案，作为临时文件或用户可见的审核文件。验证该文件，预览每项材料变更以及目标 product-library.csv，然后使用已有的明确授权，或一次性询问缺失的批准。获批后，将完整批次交给 product-library 的原生导入操作，通过一次受保护的发布完成处理，而非逐行循环。对于确实只有单条记录的补充信息，可使用该所有者的原生更新功能，但须提供唯一匹配的稳定字段，以及精确的请求／当前状态证据。

对话

以 Markdown 格式输出增强后的表格。

步骤 5：摘要

✓ Enriched 4 products
  Categories: 4 assigned (0 already had values)
  Colors: 4 assigned
  Materials: 4 assigned
  Style tags: 14 total tags across 4 products
  Uncertain: 1 (flagged for review)

搭配使用

• /as:product-spec-bulk-fetch — 先获取规格，再增强结果
• /as:product-data-cleanup — 清理会规范格式，增强会添加元数据
• /as:product-data-import — 增强后的产品能生成格式更好的进度表
• /as:product-match — 增强后的标签有助于找到更好的匹配项

原始产品证据

针对任务，从原始文档中提取所选制造商、产品和变体的准确事实。示例数据为合成数据，绝不可作为证据。不要将产品事实、认证、价格或供应商格式定义复制到插件中，作为可复用的参考知识。保留未解决的值，并区分代表性图片与所选的确切变体。

原生输出与所有者交接

需要持久化的已编写报告时，使用 receive 的原生文档所有者进行精确的基于坐标的放置、查询和注册；不要根据标签创建项目文件夹。一次性报告只能使用明确授权的目标位置，无需设置工作室或项目。规范的已采纳修订和可复用的库保存仍由其所有者负责。现有的精确授权持续有效；仅获取缺失的材料范围或原生权限。

对于此技能实际保存或编辑的任何输出，请对其完整受影响集合应用原生变更序列。保留所有原始字节和访问权限、来源／身份防护、完整的待处理输出及缺失／前置条件；完成持久化保存，并在首次发布前独立重新读取所有保留／待处理内容及访问权限。保留无关数据，并在适用时保留实际工作簿功能。重新打开每个实际目标位置的完整字节及模式／适用的所有权／ACL，并在报告完成前验证变更、来源链和受保护的原件。字节正确、创建模式参数或单独发出的回执都不足以证明完成。保护措施不受支持或发布存在不确定性时，保持阻止／待处理状态并提供恢复证据。

根据所选模式使用适合的原生功能；只有所选方法需要时，才使用进程执行。无需 Arch Studio runner、可执行文件下载或源内容重建。只读／内联工作不需要写入能力。分别报告实际研究／提取、已验证的提案，以及任何经独立验证的所有者保存；没有实际证据时，不要声称已完成所有者交接。

原生工作簿保留比较

当有明确选定的原生 .xlsx 或 .xlsm 前后版本配对及获准的单元格编辑时，加载完整的工作簿比较所有者，并使用实际 ZIP/XML 检查执行原生 workbook_preservation.compare。保留完全一致的成员字节、声明的工作表／单元格属性、公式／缓存的区别及 XML 空白规则。此只读比较不授权编辑，也不能取代任务要求的实际目标单元格回读、备份、功能检查、重新计算或视觉验证。对于提供方或二进制格式，以及无法达到的检查精度，须明确说明其缺口；绝不要通过重新保存／转换工作簿来掩盖这些问题。无需 Arch Studio 辅助工具或进程运行时。