用途：指导首次完成 Metronome 目录配置，从定价意图到可验证的实时合同。目录（步骤1–4）为一次性共享基础设施，客户与合同（步骤5–6）按客户重复。基础 URL：https://api.metronome.com/v1，认证使用 Authorization: Bearer $METRONOME_API_TOKEN。范围仅限首次目录配置，不涵盖 Stripe Connect、收入确认、税务编排或特定计费提供商功能；未覆盖主题应明确说明，不得凭常识推断。
主要能力与顺序（硬依赖，不可跳步，保存每步返回的 ID）：步骤1 计费指标 POST /v1/billable-metrics/create；步骤2 产品 POST /v1/contract-pricing/products/create（需步骤1的 BM ID）；步骤3 费率卡 POST /v1/contract-pricing/rate-cards/create；步骤4 添加费率 POST /v1/contract-pricing/rate-cards/addRates（需步骤2的产品 ID）；步骤5 客户 POST /v1/customers；步骤6 合同 POST /v1/contracts/create（需步骤5的 customer_id 与步骤3的 rate_card_id）；步骤7 验证 GET /v1/customers/{id}/invoices（必需）。
关键规则：group keys 创建后不可变，需提前规划；费率卡为共享，修改会传播到所有无覆盖的合同，单客户调整应使用合同级覆盖；金额以分为单位；每条费率必须设置 entitled: true，否则产品静默禁用；ingest 请求体必须是裸 JSON 数组；写入前确认环境，若 staging 不可达应询问用户，不得静默切换到生产。验证需摄取测试事件并检查草稿发票行项目，若合同起始时间在未来超过24小时，可改用 POST /v1/contract-pricing/rate-cards/getRates 验证费率卡结构。
适用场景：首次搭建 Metronome 计费目录、定义计量维度、配置默认定价、按客户创建合同。限制：不涉及高级合同选项（承诺、信用、覆盖）、多 group key 决策、Stripe Connect、收入确认、税务编排等，需使用相应专门技能。