用途
ce-product-pulse 用于生成一份按时间窗口聚合的产品脉冲报告，回答“用户经历了什么、产品表现如何”这一问题。它覆盖使用情况、质量、错误以及值得调查的信号，但不报告“已上线了什么”——已交付的工作应查看 issue 追踪与提交历史，脉冲只关注用户体验与系统性能。
主要能力
- 查询产品数据源，在给定时间窗口内生成紧凑的单页报告，目标为终端输出 30–40 行。
- 报告固定四个部分，依次为：Headlines（2–3 行窗口摘要）、Usage（主参与、价值实现、完成/转化、质量抽样）、System performance（延迟 p50/p95/p99 与按次数排序的 Top 5 错误及一行说明）、Followups（1–5 项值得调查的事项）。
- 支持并行与串行查询策略：分析与追踪查询并行；数据库查询串行，且仅使用范围受限的查询，避免大表全表扫描。
- 可选质量评分（仅 AI 产品）：从窗口内抽样最多 10 个会话或对话，按指定维度打 1–5 分，只记录分布（如“8x 5, 1x 4, 1x 2”）与匿名说明，不保存消息内容或用户标识。
- 报告保存到 docs/pulse-reports/YYYY-MM-DD_HH-MM.md，作为可浏览的脉冲时间线，便于检索、对比与丢弃。
使用方式
- 通过参数传入时间窗口，常见形式：24h、48h、72h、7d、30d，或 1h（发布期间短窗口）。参数为空时使用配置中的默认回看窗口；未设置时硬默认 24h；无法解析时询问用户澄清。
- 窗口上界会施加 15 分钟缓冲（例如 24h 窗口查询 [now - 24h - 15m, now - 15m]），以规避分析/追踪工具的摄取延迟。
- 交互优先使用宿主平台提供的阻塞式提问工具（Claude Code 的 AskUserQuestion、Codex 的 request_user_input、Gemini 与 Pi 的 ask_user）；仅在不存在阻塞工具或调用出错时回退到聊天中的编号选项，且不会静默跳过提问。每次只问一个问题，多选仅用于首次配置。
- 首次运行在仓库根目录（git rev-parse --show-toplevel）读取 .compound-engineering/config.local.yaml；若不存在或未配置 pulse_product_name，则进入首次运行访谈（Phase 1），随后执行脉冲（Phase 2）。参数为 setup、reconfigure 或 edit config 时，无论配置状态如何都进入访谈。
- 配置以扁平的 pulse_* 键写入 .compound-engineering/config.local.yaml，写入时保留非 pulse 键；若该文件未被 .gitignore 覆盖，会在写入前询问是否添加条目。访谈结束后会提供定时运行建议，但不自动调度。
配置键（访谈与运行会用到）
pulse_product_name（报告标题，未设置即视为未配置）、pulse_lookback_default（1h/24h/7d/30d，默认 24h）、pulse_primary_event、pulse_value_event、pulse_completion_events（0–3 个事件名，逗号分隔）、pulse_quality_scoring（true，默认 false，仅 AI 产品）、pulse_quality_dimension、pulse_analytics_source、pulse_tracing_source、pulse_payments_source（未使用则省略）、pulse_db_enabled（true，默认 false；启用时数据库访问为只读）、pulse_metric_sources（metric=source 对的逗号分隔列表，用于按策略指标覆盖来源，未列出的回退到 pulse_analytics_source 并标注 default source）、pulse_pending_metrics（待埋点的策略指标，在报告中显示为无数据）、pulse_excluded_metrics（有意排除的策略指标）。
若存在 STRATEGY.md，访谈前会读取它，从 YAML frontmatter 的 name 键（缺失时回退到 H1 标题并去掉 “ Strategy” 后缀）提取产品名，并从 ## Key metrics 段提取指标列表，作为种子带入事件与数据源配置。
数据源部分建议通过 MCP 连接；若用户提供读写数据库凭据，访谈会拒绝并给出替代方案。数据库完全可选，许多产品仅靠分析与追踪即可完成脉冲。
适用场景
- 发布期间或日常巡检，快速了解某时间窗口内的用户参与、价值实现与转化情况。
- 结合错误与延迟数据，识别值得深入排查的系统问题。
- 作为团队的工作记忆：每轮运行写入 docs/pulse-reports/，历史脉冲可形成时间线。
- AI 产品可通过质量抽样跟踪会话质量的分布变化。
限制
- 不设置阈值、不告警，由读者自行判断数据含义；不默认把指标标为“好”或“坏”。
- 保存到磁盘的报告中不含 PII（用户邮箱、账号 ID、消息内容）。
- 不修改产品、数据库或任何外部系统；所有查询为只读，若某工具提供写入模式则不使用。
- 不替代追踪仪表盘或分析工具；它只做单页汇总，深入调查仍需使用原生工具。
- 不自动调度，任何调度交接都需要用户明确确认。
- 关于具体支持的数据源清单、安装命令、收费标准与平台支持范围，现有资料未提供，暂未提供相关信息。