用途
Model Product 是一个产品遥测建模技能，目标是构建结构化的产品模型：理解产品做什么、谁在使用、价值如何流动、存在哪些实体。该模型是后续所有阶段（审计、设计、实现）的输入。
输出文件：.telemetry/product.md
前置条件：无，这是整个流程的起点。若 .telemetry/ 文件夹不存在，需先创建：
mkdir -p .telemetry/audits
然后写入 .telemetry/README.md 说明该文件夹用途（首次运行时从 assets/telemetry-readme.md 复制；若已存在则保留原样）。
主要能力
该技能通过两个连续步骤完成建模：
-
静默代码库扫描：在提问前快速做结构性扫描，推断产品形态。扫描对象包括 README/docs（产品目的、架构、关键概念）、路由/页面（功能区域）、控制器/处理器（API 端点）、模型/schema（实体）、任务/worker（异步工作流）、mutation/action（用户发起的变更）、鉴权/中间件（角色、权限、多租户）、包清单（技术栈与集成）。要求不读每个文件、不看追踪/分析代码、不超过 2-3 分钟、不向用户展示原始发现。
-
与用户对话：基于推断视图进行有依据的对话，覆盖产品身份（类别、主要价值动作、失败的样子）、价值映射（核心功能 vs 支撑功能）、实体模型（用户/账户/组的关系、角色、多租户）、组层级深度（多数产品 2-3 层即可）、商业模式（变现方式、定价层级、免费 vs 付费）、当前状态（现有追踪工具、最大缺口、痛点）、集成目标（遥测数据去向）。
使用方式
技能内置参考索引，按需查阅：references/principles.md（15 条核心遥测原则）、references/b2b-spec.md（双实体 B2B 模型、group 调用）、references/identity-and-groups.md（Identify/group 模式）、references/glossary.md（术语定义）、references/group-hierarchy.md（嵌套组结构）、references/end-to-end-walkthrough.md（完整 Clipper 示例）。
行为规则包括：先扫描后提问；综合而非倾倒原始数据（对话中原始数据不超过 20 行）；验证而非假设；聚焦产品而非代码；询问价值而非功能；尽早捕获层级；保持轻量；trait 设计属于设计阶段而非本阶段；不写“未知”或占位符；填满模板每个字段；呈现结论而非推理过程；一句话描述要生动具体。
输出结构
.telemetry/product.md 包含：Product Identity（一句话描述、类别、产品类型、协作模式）、Business Model（变现、定价层级、计费集成）、Tech Stack（语言、框架、数据库、后台任务、HTTP 客户端模式、模块组织）、Value Mapping（主要价值动作、核心功能、支撑功能）、Entity Model（用户、账户的 ID 格式、角色、多账户、层级）、Group Hierarchy（层级图与表格、默认事件层级、管理动作层级）、Current State（现有追踪、文档、已知问题）、Integration Targets（目标、用途、优先级）、Codebase Observations（推断的功能区域与实体模型）。
适用场景
适用于需要为产品建立遥测追踪基础的产品团队，尤其是 B2B SaaS 产品。B2B 产品适用组层级和账户级追踪；B2C 或混合产品实体模型可能只需用户。
限制
product.md 不是审计（无追踪覆盖率统计）、不是追踪计划（无事件定义或 trait 设计）、不是工作笔记、不是实现细节。它是静态产品描述，为后续阶段提供信息。trait 设计（在用户、账户、组上追踪什么）发生在设计阶段。
后续阶段
完成产品建模后，建议用户运行：
- product-tracking-audit-current-tracking — 捕获当前追踪现实
- product-tracking-design-tracking-plan — 设计目标追踪计划
生命周期：model → audit → design → guide → implement ← feature updates