product-metrics

product-metrics — 指标简报

旧流程承认了这个缺口，却没有填补：product-strategy 要求“没有指标，问题就不明确”，但没有工具帮忙建立这个指标——它把工作交给了一个根本不存在的指标教练。这里就是那个站点：它定义候选北极星指标，构建支撑它的杠杆树，并为每个活跃假设提供一个数字、衡量方法，以及截至今天的数值。

何时调用

何时	来源 / 去向
product-strategy 的指标关卡未通过（“没有指标，问题就不明确”）	从 product-strategy 进入（.agents/skills/product-strategy/SKILL.md）
撰写指标简报	转至 prd（.agents/skills/prd/SKILL.md）——节点的战略 context/ 已补全，且指标已定义
没有前置关卡	在已加载的产品节点上独立调用

这两个相邻站点都已安装在此工具包中：在这里提及它们是有依据的，并非凭空杜撰——不同于旧版本中提到的指标教练，它既没有规范，也没有负责人。

访谈

访谈采用 .agents/skills/grill/SKILL.md#method 中的施压方法——仅通过路径引用，绝不复制。 五项要素（带示例的反问、最多施压 1–2 次、退出选项、证据层级、记录每个缺口）均严格按照其中的说明执行。

提问之前：如果已加载的产品节点包含来自 product-strategy 的有日期研究（即包含假设的发现简报），请先阅读——活跃假设从中获取，不会再次提问。 如果没有前置研究，则直接询问。

按以下顺序执行四个步骤：

1. 候选北极星指标

提出一个候选北极星指标，并用一行说明理由：它会影响哪项产品决策，而不是解释“它为什么重要”。如果回答没有指出决策（“因为它衡量成功”“因为大家都看这个”），grill 会用反问让对方重新回答。

2. 指标树

北极星指标位于顶端，杠杆变量位于其下——这些变量一旦变化，就会带动北极星指标变化。每个杠杆都要注明在哪里衡量（哪个事件、哪张表、哪个来源——只说明在哪里，绝不说明如何埋点：那属于用户产品的正文，不属于此工具）。没有注明衡量位置的杠杆就是一个缺口，而非完整条目。

3. 每个活跃假设对应一个指标

针对每个活跃假设（由 product-strategy 提供，或在没有前置研究时于此提出）：用哪个数字来验证或证伪该假设、如何衡量，以及截至今天的数值是多少。

硬性规则：没有来源的数值，不算数据。 如果操作者无法说明某个当前数值的来源（仪表板、测量结果、有日期的数字），就不能把它写得仿佛有来源一样：应将其记录为缺口，并注明由谁补齐——格式与 grill 使用的缺口格式相同。为了让条目看起来完整而编造数字，就等于把未完成的扫描伪装成已完成，这是系统其他部分明令禁止的。

4. 护栏指标

北极星指标改善时，哪些指标不应恶化？设置触发警报的阈值——必须是一个数字或可验证的条件，绝不能写成“如果恶化很多”。

虚荣指标

每提出一个指标（北极星指标、杠杆指标或假设指标），都要问：无论这个数字朝哪个方向变化，它会改变什么决策？

如果没有答案，或者答案是另一个指标（“它会改变我们对增长的看法”），那它就是虚荣指标：应当直言“这是一个虚荣指标：它不会改变任何决策”，并在将它纳入简报前，要求明确说明它应该影响的具体决策。既不会默默将其舍弃，也不会为了避免打断访谈而接受它。

指标简报

最后，它会将交付成果作为已加载产品节点的带日期研究写入：

research/<YYYY-MM-DD>-metric-brief.md

带日期，绝不覆盖——这与本仓库研究文件夹已采用的标准相同。路径位于大脑自身 tree.md 中的 content: */products/*/research/*.md 行内：无需新增 glob，也无需新增 resolver 行。如果没有产品节点，同一文件——<YYYY-MM-DD>-metric-brief.md——则会写入当前文件夹。

简报包含以下四个部分，顺序如下，且各自使用固定标题：

## Candidate North Star
## Metric tree
## Metric per hypothesis
## Antimetrics

• 候选北极星指标：用一行写明指标及理由（它会影响哪个决策）。
• 指标树：顶部为北极星指标，每个杠杆各占一行，并注明测量位置。
• 各假设对应的指标：每个活跃假设各列一项——使用哪个数字、如何测量、截至今天的数值，或注明差距及负责人。
• 反指标：每项都注明其警报阈值。

如果访谈过程中发现了虚荣指标，简报仍会将其写下来——并加上标签“（虚荣指标：它不会改变［被询问但始终无人负责、且未解决时的］决策）”——绝不会悄无声息地删除它。

此交付成果不代表什么

指标简报既不会创建产品节点的新规范文件，也不会要求创建此类文件：它属于带日期的研究，是对现有内容的补充；它既不会替换 context/ 中的现有文件，也不会强迫其重新进行版本管理。如果将来需要指标规范文件（会被覆盖的实时 metrics.md），该决定须由操作者批准，而非由此工具决定。

保存位置

此技能会先确定保存位置，再生成交付成果，绝不会事后才确定。共有三种情况、两个保存位置：

• 已加载产品节点：交付成果会保存到该节点的 research/<YYYY-MM-DD>-<name>.md。
• 存在大脑，但没有产品节点——尚无工作区，或工作区中没有产品节点：交付成果会写入当前文件夹中的文件。
• 完全没有大脑：交付成果会写入当前文件夹中的文件。

没有产品节点时，文件仍会写入当前文件夹。结束消息只会指出刚写入的路径，然后到此为止——这就是此技能正常的结束方式，并非需要说明的异常情况。

此技能绝不会询问应使用哪个保存位置，也绝不会臆造第三个位置。

此工具包的其余技能每次安装一个。先查看 .agents/skills/，再查看 .claude/skills/（同一技能同时存在于两处时只计一次），并且只提供尚未安装的技能——每个会话仅提供一次：本会话中此技能首次结束时提供；同一或其他交付成果之后再次结束时，不再提供：

• grill — npx skills add pedroromeroluna/ai-first-product-skills --skill grill
• prd — npx skills add pedroromeroluna/ai-first-product-skills --skill prd
• product-strategy — npx skills add pedroromeroluna/ai-first-product-skills --skill product-strategy

一次安装整个工具包：npx skills add pedroromeroluna/ai-first-product-skills。此命令会安装工具包提供的内容；上面列出的其他技能则需通过指定名称安装。