goodbuddy/resources/skills/product-evidence/SKILL.md

name, version, description, allowed-tools, compatibility

name	version	description	allowed-tools	compatibility
product-evidence	1.0.0	建立和维护产品市场材料的事实与证据清单，统一产品版本、功能状态、技术参数、 术语、适用边界和可公开主张。用于开始任何产品介绍、投标参数、PPT、技术方案、 白皮书或案例材料之前，也用于跨产物一致性核验。	Read Grep Glob Execute	Python 3.9+，校验脚本不依赖第三方包

产品事实与证据

所有产品市场产物都必须从同一份 product-evidence.json 取事实。缺少依据时标记 待核验，不允许由 Agent 补造参数、客户结果、认证、兼容性或竞争结论。

<skill-dir> 指本 SKILL.md 所在目录。

建立清单

cp "<skill-dir>/templates/product-evidence.example.json" ./product-evidence.json

逐项填写：

• product：产品名称、版本、类别、定位、成熟度和目标读者。
• terminology：统一术语、定义和禁用旧称。
• features：功能 ID、用户动作、结果、状态、版本范围和证据。
• parameters：参数值、单位、测试条件、适用版本、公开级别和证据。
• claims：允许对外使用的事实、目标或比较主张及适用产物。
• use_cases：角色、问题、工作流、人工复核点和已有结果。
• differentiators：比较对象、比较范围和支持证据。
• limitations：部署条件、依赖、适用边界和必要人工复核。
• evidence：来源、定位、核验日期、责任人和公开级别。
• prohibited_claims：不得出现在任何材料中的绝对化或未经批准表述。

事实分级

• released：当前版本已提供，必须有可定位证据。
• beta：可试用但存在范围限制，正文必须同时说明限制。
• planned：仅可用将来时或规划表述，不得写成现有能力。
• deprecated：不得作为当前卖点。

证据公开级别：

• public：可进入公开网站、彩页和公开演示。
• restricted：只在授权客户或受控投标材料中使用。
• internal：只用于内部判断，不能原样写入外发产物。

校验

先探测可用的 Python 3 解释器：Windows 优先使用 python，macOS/Linux 优先使用 python3。下文 <python> 表示探测成功的解释器命令。

<python> "<skill-dir>/scripts/validate_evidence.py" ./product-evidence.json
<python> "<skill-dir>/scripts/validate_evidence.py" ./product-evidence.json --json
<python> "<skill-dir>/scripts/validate_evidence.py" ./product-evidence.json \
  --strict --channel public

结构错误、重复 ID、失效引用、无证据的已批准事实主张、非法状态或疑似密钥参数 必须阻断。缺证据、占位符和待核验项在普通模式下告警，在 --strict 下阻断。

--channel 按目标渠道核对公开级别：已批准且带 allowed_outputs 的主张，其 引用证据的 disclosure 不得低于渠道要求。对外产物必须以 --strict 加目标 渠道运行通过后才能进入下游技能。

给下游技能的输入

调用任何产品产物技能时，同时提供：

1. 已通过校验的 product-evidence.json。
2. 目标受众、使用场景、发布渠道和保密级别。
3. 本次产物允许引用的证据范围。
4. 截止日期、页数或篇幅、格式和品牌要求。

下游产物中的每个数字、兼容性、认证、客户效果和比较结论都应能追溯到清单 ID。

完成标准

清单结构校验通过；公开级别与使用渠道匹配；所有现有功能、参数和批准主张有 证据；规划能力、限制和人工复核要求没有被省略；不含密钥、客户隐私或私有地址。