用途
product-metrics 是一个产品管理类技能包，核心目标是在产品发布前建立明确的成果度量契约，并在发布后进行严谨的产品价值复盘，把“交付完成”与“产品价值实现”清楚地区分开。技能声明其优先级为 P0（关键）。
主要能力
能力预检
在使用度量契约与价值复盘前，技能要求先验证执行前提：定位安装目录下的 product-management/product-evidence（标准布局）或 product-management-product-evidence（Kiro 扁平布局）；确认校验脚本 validate-product-evidence.mjs 存在；要求 Node.js 版本不低于 20.0.0；确认传入的是合法且范围收敛的绝对权威根路径（拒绝根目录、主目录、上级工作区）、位于其内的常规账本、有效的 UTC --as-of 时间，以及 --gate 参数取 structural、experiment、commit 或 release。若缺少分析数据，价值结论应为“不结论”，并保留已发布交付状态。技能明确禁止占位输入、模拟校验、静默安装、扩大根路径范围、豁免查询或护栏定义，以及从请求体查询中推断权限。
度量契约（MET）
度量契约需要填写定义、单位、分母、适用人群、对比窗口、目标、护栏指标、度量负责人和复核触发器。允许的状态只有 planned、instrumented、observed、unavailable；数据尚未成熟时必须记为 unavailable 并在允许的来源上下文中说明成熟度理由，不能用 immature 作为状态。instrumented 与 observed 状态要求存在非空查询及匹配的 query_revision。
基线与护栏规则
发布要求具备历史基线证据（含数值、来源、窗口），基线窗口结束时间不得晚于对比窗口开始时间；或者使用限定范围的基线豁免，该豁免必须引用一条当前有效、未退役的发布决策（用途为 release、结果为 risk_accept），仅豁免该条度量契约的基线，不豁免查询定义与护栏指标，也不伪造审批。护栏指标（如错误率、延迟、流失）一旦突破，会作废主要收益，需要升级到获授权的故障处理路径；只有在明确配置了经认证的主机运行时停止控制时，才执行自动回滚或暂停。度量契约、价值复盘和校验输出本身不授予自主发布、暂停、退役、预算或敞口权限。
发布后价值复盘（REV）
价值复盘需要把原始投资决策（仅作历史归因，不代表当前权限）与假设，连接到实际观察和实际增量成本。新的价值复盘决策需要绑定当前战略权限的独立记录。归因分类为 causal_supported、descriptive 或 unknown，并需记录反事实与混杂因素（季节性、营销支出、促销）。建议取值为 scale、iterate、stop、inconclusive；证据不成熟或受混杂影响时，建议记为 inconclusive，归因记为 unknown 或 descriptive，交付状态保持已发布。技能强调应分别诊断方案内部局限与组织层面局限，单一 KPI 未达标本身不足以确定原因。
使用方式
本技能以技能包与本地校验脚本形式提供，需按上述预检要求准备好安装布局、脚本、Node.js 运行时和合法输入参数后，才能校验度量契约与价值复盘记录。资料未提供具体的安装命令或调用示例。
适用场景与限制
适用于产品发布前的度量设计与发布后价值评估，尤其适合需要把交付状态与业务成果分开管理、并防范未经验证 ROI 声明的团队。限制包括：需要 Node.js 20 及以上；缺少分析数据时无法得出价值结论；不具备自动发布或停止权限；资料未说明收费、平台支持范围和具体操作步骤。
反模式
技能列出四类反模式：把上线当成功；把相关性当因果 ROI；没有基线证据或风险接受决策就发布；允许自动化系统在缺少人工治理时扩大推广、退役功能或投入资金。