zayn-product-brief

基于型号、描述、截图和已有资料，快速整理产品用途、关键规格、版本差异、采购关注点和信息缺口。

Install

openclaw skills install @zaynpeng/zayn-product-brief

PRODUCT_BRIEF() 产品速览

1. 基本信息

text

Skill ID: zayn-product-brief
Display Name: PRODUCT_BRIEF()
Chinese Name: 产品速览
Project: WorkFn
Author Prefix: zayn
Category: Product Intelligence
Version: 0.1.0
Status: Draft for testing

PRODUCT_BRIEF() 负责看懂产品。
RFQ() 负责判断询价是否值得投入。
QUOTE() 负责检查报价是否完整。

2. 解决的问题

客户只发型号、截图或一段描述，销售不知道产品是什么
同一产品存在不同配置、版本和应用场景
产品知识分散在官网、Datasheet、历史报价和沟通记录中
AI 容易仅凭型号强行补全规格
销售不清楚客户还需要确认哪些参数
报价前没有形成统一的产品理解
产品用途、关键规格和采购关注点没有被快速整理
技术信息和商业判断混在一起

3. 适用场景

客户只提供型号
客户提供产品截图
客户提供官网配置说明
客户描述不完整
销售第一次接触某类产品
需要快速了解服务器、内存、硬盘、SSD、GPU、网络设备或笔记本配件
报价前整理产品基础信息
向采购或工程发起确认前整理问题
为 RFQ()、CLARIFY() 和 QUOTE() 提供产品背景

4. 不适用场景

直接判断询价是否值得投入
直接判断客户是否值得开发
直接生成销售报价
直接给出最终兼容性结论
直接确认库存
直接确认市场价格
直接确认原厂保修
仅凭模糊截图认定具体型号
没有任何资料时生成完整产品说明

5. 输入参数

必填参数

参数	说明
`product_input`	客户提供的型号、描述、截图或链接内容
`available_sources`	当前可用资料来源
`analysis_goal`	本次需要理解什么

建议参数

参数	说明
`brand`	品牌
`model`	型号
`part_number`	PN 或产品编号
`customer_description`	客户原始描述
`image_notes`	截图或图片中可见信息
`datasheet`	Datasheet 内容
`official_page`	官方页面内容
`historical_quotes`	历史报价记录
`order_records`	历史订单记录
`supplier_feedback`	供应商反馈
`engineering_notes`	工程师确认
`application`	已知应用场景
`target_system`	目标整机、平台或设备
`known_constraints`	已知限制
`language`	输出语言

6. 必填参数

必须至少提供：

一项产品识别信息
一项可用资料来源
本次分析目标

如果只有一个模糊名称，没有任何可验证资料，应返回：

text

当前信息不足，无法形成可靠产品速览。

7. 可选参数

可选参数用于补充品牌、型号、产品线、关键规格、应用场景、配套设备、目标市场、客户特殊要求、历史供应经验，以及供应商或工程师确认。

8. 证据优先级

原厂 Datasheet
原厂官网
工程师明确确认
实物标签、清晰照片和序列信息
已确认订单和历史交付记录
已确认采购或供应商资料
客户原始描述
历史报价和内部记录
可信第三方数据库
普通网页和搜索结果
AI 推测

不得用低等级证据覆盖高等级证据。不同来源冲突时，必须保留冲突并标注待确认。

9. 判断规则

规则一：先识别产品层级

必须先判断客户提供的是单个部件、模块、板卡、平台、机头、整机、套件，还是服务或方案。不得把平台、机头和整机混为一谈。

规则二：事实与推测分开

所有输出必须区分已确认、高可信判断、待确认和 AI 推测。

规则三：只整理与当前目标相关的规格

优先整理影响报价、兼容性、交期、成色和保修的规格，以及客户明确关心的规格，不为完整而列出全部规格。

规则四：型号不等于完整配置

同一型号可能有不同容量、接口、功率、区域版本、固件、配套、成色和包装。不得仅凭型号补全完整配置。

规则五：截图只做可见信息提取

截图中看不到的信息不得推断。

规则六：历史记录只做辅助

历史供应过同型号，不代表当前仍然有货或当前规格完全一致。

规则七：产品理解与商业判断分开

不得输出值得报价、不值得报价、高潜产品、利润高、客户会接受或市场一定有货。这些判断应交给其他 Skill。

10. 风险检查

是否把平台当成整机
是否把机头当成完整系统
是否把主板当成整机
是否把产品系列名当成具体 PN
是否把历史配置当成当前配置
是否把网页搜索结果当成原厂确认
是否把图片相似当成型号一致
是否忽略区域版本差异
是否忽略成色和保修差异
是否忽略接口、容量、功率和尺寸
是否把供应商口头反馈写成确定事实
是否把兼容性推测写成确定结论

11. 输出结构

A. 产品识别结论

产品名称、产品类别、产品层级、品牌、型号或 PN，以及当前识别置信度。

B. 一句话说明

用一句话说明这是什么、用在哪里和主要解决什么问题。

C. 已确认关键规格

只列出有证据支持的规格。

D. 可能存在的版本差异

按证据列出容量、接口、功率、区域版本、固件、配套、包装和成色差异。没有证据时不强行列出。

E. 典型应用场景

只写有资料支持的应用。

F. 采购和报价关注点

包括精确 PN、数量、成色、包装、交期、保修、兼容性、目标设备、是否接受替代和是否要求品牌标签。

G. 当前信息缺口

列出缺什么、为什么重要，以及建议向客户、采购或工程确认什么。

H. 风险提示

只列出真正影响判断的风险。

I. 建议下一步

只能给一个主要动作，例如确认具体 PN、向工程确认兼容性、查找原厂 Datasheet、获取清晰标签照片，或确认是平台、机头还是整机。

J. 下游 Skill 输入摘要

输出供 CLARIFY()、RFQ()、QUOTE() 以及未来的 PRODUCT_VERIFY()、PRODUCT_COMPARE()、COMPATIBILITY() 使用的事实摘要，只提供事实，不替下游 Skill 做判断。

12. 禁止事项

仅凭型号补全全部规格
仅凭图片认定具体型号
编造 PN
编造接口、容量、功率或尺寸
编造库存
编造交期
编造价格
编造原厂保修
直接判断是否值得报价
直接给出最终兼容性结论
把历史记录写成当前事实
把普通网页搜索结果写成原厂确认
为了结构完整而填满所有字段
覆盖人工和工程师确认
大规模搜索无必要资料

13. 信息不足时的处理

当信息不足时，输出：

text

当前只能形成初步产品识别，无法形成完整产品速览。

并列出当前已知信息、最关键的三个缺失项、建议确认顺序、可以暂时留空的字段和是否适合进入 CLARIFY()。不得为了完成任务扩大到无边界搜索。

14. 人工判断边界

工程师确认优先于 AI 推测
原厂资料优先于普通网页
人工确认的 PN 不得被覆盖
AI 不得自动修改产品主表
AI 只输出新文档或建议
原始资料必须保留
疑似信息不得写入确定字段
兼容性和替代结论应保留人工确认入口

15. 验收标准

能识别产品层级
能区分已确认和待确认信息
不仅凭型号补全规格
不仅凭图片认定产品
能指出关键规格
能指出版本差异风险
能列出采购关注点
能给出最小下一步动作
不越权做商业判断
能为下游 Skill 提供可靠输入

16. 当前状态

text

Version: 0.1.0
Status: Draft for testing

参数解析流程

本 Skill 必须先解析用户输入并映射到参数表。

参数状态表

正式分析前，必须输出参数状态表。

参数状态只能使用：

text

已命中
部分命中
缺失
冲突
待验证

统一格式：

参数	必需程度	当前状态	已获取内容	缺失或冲突影响
待按本 Skill 参数填写	待确认	缺失	无	待判断

参数状态表必须基于用户输入，不得凭空补充。

最低运行条件

待补充本 Skill 的最低运行条件。

在最低运行条件完成定义前，不得由 AI 根据 Skill 名称临时猜测。已有明确最低运行条件的 Skill，应同时遵守其现有规则。

缺失参数处理

不得自动补全缺失参数，必须明确提示用户补充，并说明缺失参数、重要性、影响、补充方式及当前是否可以先做初步分析。

冲突参数处理

不得自行解决冲突，必须保留不同来源、标记冲突、说明影响并提示验证。在冲突解决前降低分析置信度。

待验证参数处理

待验证信息不得写成确定事实。供应商口头反馈、市场信息、预计库存、预计交期、公开资料、客户可能意图和 AI 推测等必须明确标记。

正式分析触发条件

只有达到最低运行条件，且关键缺失、冲突、证据来源、分析目标和风险边界已得到处理后，才进入正式分析。

初步分析模式

参数不完整时，只能提供明确标注的初步分析：

text

以下为初步分析，仍需补充关键参数。

不得把初步分析包装成确定结论。

正式分析模式

参数完整并满足触发条件时，才可输出正式分析。正式输出前必须再次检查参数缺失、冲突、待验证信息、推测、人工判断、职责边界和用户真实目标。