SuperAPI AI 工具集

ce-product-pulse

通用与其它

查看项目

更新于 10-15 21:39

技能介绍

用途:ce-product-pulse 按给定时间窗口查询产品数据源,生成一份紧凑的单页报告,涵盖用量、性能、错误和后续跟进事项。报告保存到 <root>/pulse-reports/,要点在对话中展示。目标是 30-40 行;某部分内容少就保持简短,报告过长就删减。

主要能力与边界:全程只读,不修改产品、数据库或任何外部系统。唯一写入是追加到 .compound-engineering/config.local.yaml 的 pulse 设置,以及报告文件。数据库源必须使用只读连接,访谈环节会拒绝读写凭据;DB 访问可选,许多产品仅凭分析和追踪即可完成。保存的报告不得包含 PII,不写入用户邮箱、账号 ID 或消息内容。不设硬编码阈值、不给默认好坏标签、不做告警,只呈现数字由读者判断。它不是发布日志或仪表盘替代品,每次运行都会保存,历史报告可按时间线浏览。

时间窗口与根目录:时间窗口取自调用时传入的范围(如 24h、7d),常见形式为最近小时、最近天以及发布用的 1h。参数为空时取配置中的 pulse_lookback_default,仍未设置则兜底 24h;无法解析则请用户澄清。窗口上界加 15 分钟缓冲以应对数据摄入延迟,例如 24h 窗口查询 [now - 24h - 15m, now - 15m]。报告写入 <root>/pulse-reports/,<root> 由 docs_root 决定,该键只从 <repo-root>/.compound-engineering/config.yaml 读取,未设置则为 docs;需校验为仓库内相对目录且不指向仓库根或 .git/ 下,否则报错而不回退。

使用方式:运行按三个阶段推进。Phase 0 依据配置状态路由,从 config.local.yaml 再到 config.yaml 解析普通键,首个有效值生效。当 pulse_product_name 未设置、仓库根无法解析或参数为 setup/reconfigure/edit config 时,先进入 Phase 1 首次运行访谈(读取 references/setup.md 和 references/interview.md),访谈一次只问一个问题,多选仅用于首次配置。随后 Phase 2 运行脉搏(读取 references/run.md),定义并行与串行查询、是否启用数据库、可选质量抽样及评分、四个报告部分和写入位置。最后 Phase 3 调度,仅在参数为 schedule 关键字或第三次及以后运行且无排期时轻量提示,绝不自动排期,任何交接都需明确确认。

交互限制:优先使用宿主当前工具列表中已有的阻塞式提问工具,按能力匹配而非宿主专名;匹配工具未加载时用工具发现原语加载;仅当列表中没有或真实调用报错时,才回退到对话中的编号选项,绝不静默跳过提问。

暂未提供:具体的数据源接入清单、报告四个部分的字段细节、错误码与性能指标口径,以及调度原语名称。