product-research

/as:product-research — 产品研究

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

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

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

记录权威性与主机交接

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

对于绑定项目的工作，请应用原生上下文解析，使用经验证的项目身份，并阅读项目说明。内联或一次性来源工作无需创建项目。产品库负责可复用的 CSV 存储；主计划负责已采纳的规范身份／修订版本，产品数据导入负责已接受的任务输入。不得从目录、来源文档或交付声明推断权威性。

明确区分已采纳的项目计划、一次性来源工作，以及可选的可复用 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 中。

工作原理

Designer gives a brief
        ↓
Host searches authorized sources
        ↓
Presents candidates with specs + reasoning
        ↓
Designer picks winners
        ↓
Saved to project product library

步骤 1：获取需求说明

设计师描述他们想要什么。需求说明可以宽泛，也可以具体：

宽泛：

“我需要用于科技公司办公室大堂的吸音板”

具体：

“想找一张圆形餐桌，直径 48-54"，实木桌面（优先胡桃木或橡木），钢制或黄铜底座，价格低于 $3,000，需要有现货或交货周期不超过 6 周”

从需求简介中提取的信息

尽可能提取设计师提供的以下信息。不要询问他们未提及的字段——根据已有信息开展工作。

字段	示例
类别	桌子、座椅、照明、吸音板、花盆、储物
使用场景	办公室大堂、会议室、户外露台、家庭办公室
风格 / 美学	斯堪的纳维亚风格、世纪中叶风格、工业风、极简、温馨、大胆
材料	实木、大理石、钢、织物、网布、再生材料
尺寸	“直径 48-54 英寸”、“高度低于 30 英寸”、“适合 6x4 英尺的空间”
预算	低于 3,000 美元、500-1,000 美元区间、高端、经济实惠
可持续性	GREENGUARD、FSC、Cradle to Cradle、再生成分、B Corp
交货周期	有现货、6 周以内、不着急
数量	1 件重点单品、会议室用 12 件、开放式办公室用 50 件以上
室内 / 户外	室内、户外、两者皆可
必备条件	可堆叠、可提供 COM、符合 ADA 标准、耐候
需避开的品牌	“不要 Ikea”、“不要任何来自 Amazon 的产品”

**不要采访设计师。**如果需求简介是“大厅用吸音板”，就足以开始搜索。如有需要，可在展示初步结果后再询问（“我找到了织物、毛毡和木条款式的选项——您偏好哪一种？”）。

第 2 步：研究

在网上搜索符合需求简介的产品。使用多个有针对性的搜索查询，从不同角度进行搜索：

搜索策略

对于“胡桃木圆形餐桌，低于 3,000 美元”这样的需求简介：

1. 类别 + 材料搜索：round walnut dining table
2. 设计导向搜索：best round wood dining tables architects designers
3. 商用 / 项目搜索：contract round dining table solid wood specifications（用于商业项目）
4. 如果设计师提到了偏好的品牌，则进行特定品牌搜索：Muuto round table、HAY dining table
5. 如相关，则进行可持续性搜索：FSC certified round dining table

根据需求简介的复杂程度，进行 3-5 次搜索。力求广泛覆盖不同价位、品牌和风格。

对于找到的每个候选产品

尝试使用 WebFetch 获取产品页面，以提取完整规格。如果页面由 JS 渲染且未返回数据：

• 仅使用搜索结果识别候选产品，并查找另一个最新、权威的来源。
• 绝不能根据模型记忆填写价格、供货情况、交货周期、尺寸、表面处理、认证或其他采购信息。
• 对于没有当前制造商、授权经销商或认证登记机构来源支持的任何易变信息，标记为 Not verified；不要将搜索摘要当作已确认事实。

每条价格、供货情况、交货周期、表面处理、尺寸和认证信息都要保留来源 URL 和访问日期。优先使用制造商当前的产品页面或价目表；只有在制造商未公布相关信息时，才使用授权经销商来源。标记为 Not verified 的候选产品仍可能有参考价值，但必须在候选清单中明确显示这些信息缺口。

目标：找到 6-10 个真正符合需求简介的候选产品。不要用匹配度低的产品凑数。

第 3 步：展示候选产品

以编号候选清单展示结果，并提供足够的详细信息以供评估：

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

展示规则

• 如果候选产品达到 6 个以上，先展示摘要表——设计师可以快速浏览
• 为每个产品说明“原因”——解释它为何符合需求简介，并指出任何妥协之处
• 如实标明取舍——“贴面而非实木”、“超出预算，但值得一看”、“交货周期长”
• 不要过度推销——如果产品匹配度较低，就直说，或者不要列入
• 如有帮助，可按角度分组——“经济型选项”、“高端之选”、“最快交付”

第 4 步：保存到项目库

当设计师选定候选产品（“保存 1、3 和 5”）后，为最近的项目根目录中的 product-library.csv 准备行。项目根目录是最近的、包含 PROJECT.md 的上级目录；不要在项目根目录之外创建产品库。

行格式

阅读 ../../schema/product-schema.md，了解确切的 33 列行数据约定；阅读 ../../schema/csv-conventions.md，了解本地文件规则。预览所有选定产品和目标路径，然后使用现有的明确授权，或只询问一次以获取缺少的批准。获批后，将所有完整行序列化为一个 JSON 数组，并将完整批次一次性提交给 product-library 的原生追加操作。该所有者会验证当前状态和整个批次，然后执行受保护的发布并重新读取最新数据；切勿逐行循环操作或手动编辑持久化 CSV。

此技能专用的列值：

• AG (Source)： research
• AF (Status)： saved
• AD (Tags)： 根据简报上下文填写（例如 "lobby-reno, walnut"）
• AE (Notes)： 演示文稿中的“原因”说明
• T (Selected Color/Finish)： 留空（设计师尚未配置）

保存后

✓ Saved 3 products to your library (rows 48-50).
  Tagged: lobby-reno, walnut

Want me to refine the search? Different style, budget, or materials?

第 5 步（可选）：迭代

设计师可能希望进一步完善：

• “更像 #1，但价格更低” → 按该风格／品牌档次搜索替代品
• “有没有户外款？” → 添加条件进行新一轮搜索
• “能找到 #3 的规格表 PDF 吗？” → 搜索制造商的产品资料表
• “并排比较 #1 和 #3” → 进行详细比较
• “这些产品中有获得 GREENGUARD 认证的吗？” → 检查候选产品的认证情况

每次迭代都可以向知识库添加更多产品。

对话风格

• 搜索前不要问太多。 一句话的简报就足以开始。
• 先展示结果，再进行完善。 根据实际选项作出反应，比预先说明所有要求更高效。
• 要有鲜明观点。 设计师需要的是专业的研究助手，而不是搜索引擎。指出最佳选项，说明取舍，并提出替代方案。
• 了解行业。 提及相关品牌、设计师和行业平台。理解商用与住宅项目、COM/COL、交货周期和认证。

备注

• JS 渲染的产品页面很常见（Hem、Muuto、Vitra 等）。如果原生检索没有返回数据，只使用搜索结果发现候选产品，并查找当前的权威来源；采购相关信息仍标记为 Not verified。不要根据一般知识补全这些信息。
• 知识库由多方共享。 此技能中的产品与批量抓取导入和 PDF 提取内容共存。Source 字段（research）标明每行数据的来源。

原始产品证据

针对任务，从原始文档中检索确切的已选制造商／产品／款式信息。示例数据是合成的，不能作为证据。不要将产品信息、认证、价格或供应商格式定义复制到插件中，作为可复用的参考知识。保留未解决的值，并区分代表性图片与确切选定的款式。

原生输出与所有者交接

需要生成的持久化报告应使用 receive 的原生文档所有者进行精确的坐标定位、查询和注册；不要根据标签拼接项目文件夹。一次性报告仅使用明确获准的目标位置，无需设置工作室／项目。规范的采纳版本和可复用的库保存内容仍由其所有者持有。现有的精确授权持续有效；仅获取缺失的材料范围或原生权限。

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

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

原生工作簿保留情况比较

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