按时间窗口生成产品脉搏报告（用量/性能/错误/跟进项）

当需要针对某个时间窗口（如 24h、7d）汇总产品数据源，生成单页只读脉搏报告时使用。

适用场景

解决思路

1. 解析 lookback window：从当前提示或对话中获取时间范围（如 24h、7d、1h）；若参数为空，则用配置中的 pulse_lookback_default，若仍未设置则回退到硬默认 24h；若参数无法解析，则询问用户澄清。
2. 对窗口上界应用 15 分钟尾部缓冲：查询区间为 [now - 窗口 - 15m, now - 15m]，避免因数据摄取延迟而少报最近事件。
3. 解析产物根目录 <root>：仅从 <repo-root>/.compound-engineering/config.yaml 读取 docs_root（<repo-root> 由 git rev-parse --show-toplevel 得到），不要从 config.local.yaml 读取；未设置则 <root> 为 docs；校验其值为仓库内相对目录、真实路径（解析符号链接后）仍在仓库内、且不是仓库根目录也不在 .git/ 下，否则报错并指明 docs_root 及其值，绝不回退到 docs；用 <root> 作为唯一产物位置，按 <root>/<子目录> 组合路径，不再读取 docs。
4. Phase 0 按配置状态路由：用 git rev-parse --show-toplevel 解析 <repo-root>，先读 config.local.yaml 再读 config.yaml（缺失则跳过），取第一个生效（非注释）值，标量为空视为未设置、无效值继续下一层再落到技能默认，列表和映射只要键存在（含空列表/空映射）就整体替换；对 pulse_* 键应用此规则，并在需要解释 pulse_* 值时阅读 references/config.md。
5. 路由判断：每次运行都经过 Phase 2（运行脉搏）再到 Phase 3（调度）；当 pulse_product_name 在级联后仍未设置、仓库根目录无法解析、或参数为 setup/reconfigure/edit config 时，先运行 Phase 1（首次访谈）；否则从 Phase 2 开始。
6. Phase 1 首次访谈：先阅读 references/setup.md（必需），它定义策略文档播种、访谈顺序与反驳标准、拒绝读写数据库、如何在不破坏其他键的情况下把配置写入 config.local.yaml、以及一次性调度提议；问题本身来自 references/interview.md（该文件指定的必需阅读）。
7. Phase 2 运行脉搏：若 Phase 1 运行过，则在任何查询前用原生文件读取工具从仓库根重新应用普通键规则（先本地后跟踪），以拾取 Phase 1 审查步骤中接受的修改；否则使用 Phase 0 已提取的 pulse_* 值，未设置项按 references/config.md 的默认值处理。
8. 在派发任何查询前阅读 references/run.md（必需），它定义哪些查询并行、哪些串行，决定是否运行数据库工作的 pulse_db_enabled 检查，可选的质量抽样及其评分纪律，四个报告章节，以及报告写入位置。
9. 交互方式：默认使用当前工具列表中宿主已有的阻塞式提问工具（按能力匹配，不按宿主特定名称）；工具在列表中即证明其存在，绝不要调用面向用户的提问工具来探测其是否存在；若匹配工具已列出但未加载，用宿主的工具发现原语加载该能力，不要搜索其他宿主的工具名；仅当列表中没有此类工具或真实提问调用报错时，才回退到宿主可见聊天界面上的编号选项；绝不静默跳过提问。
10. 一次只问一个问题；多选仅保留给首次运行配置。
11. 边界约束：全程只读，技能不修改产品、数据库或任何外部系统，唯一写入是追加到 .compound-engineering/config.local.yaml 的脉搏设置（访谈和退出写入保留在本地覆盖层）和报告文件；MCP 及其他数据源工具以只读方式调用，若工具提供写入模式则不要使用；数据库源必须是只读连接，访谈拒绝读写凭据，且数据库访问是可选的，因为许多产品仅靠分析和追踪即可完成脉搏。
12. 保存的报告不含 PII：写入磁盘的文件中不得出现用户邮箱、账号 ID 或消息内容。
13. 像创始人一样阅读：不设硬编码阈值，不默认标注“好”/“坏”，不做告警，只呈现数字让读者自行判断。
14. 保持单页：目标 30-40 行；某章节内容少就让它少；报告变长就删减。
15. 不替代发布日志或仪表盘：已发布工作留在 issue tracker 和提交历史中；深入调查仍用原生工具；本技能只整合单页阅读，且每次运行都保存，使过往脉搏可当作时间线浏览。
16. 完成标准：<root>/pulse-reports/YYYY-MM-DD_HH-MM.md 存在一份 30-40 行的报告，其头条和首要跟进项出现在聊天中，且已到达 Phase 3（调度）。
17. Phase 3 调度：设置时一次性提供周期运行（references/setup.md）；后续运行时轻描淡写地再提一次：若参数是调度关键词（daily、hourly、weekly），说明本次为临时运行并指向宿主框架的调度原语；若没有已存档的调度且这是第三次或更晚的运行，提一次调度可用；不要每次运行都唠叨，绝不自动调度——任何向调度原语的交接都需要明确确认。

适用边界 · 注意事项

• 需要修改产品、数据库或外部系统时（本技能全程只读）。
• 需要写入含 PII 的报告时（保存的报告不得含用户邮箱、账号 ID 或消息内容）。
• 需要发布日志、仪表盘替代或深入调查时（这些应使用 issue tracker、提交历史或原生工具）。