create-live-page 用于创建“实时页面”这类 Claude 构件（artifact）。实时页面本身不保存数据，只保存查询；每次有人查看页面时，查询会通过查看者自己的 Kopai 连接器运行，所以页面展示的是查看者本人连接中的 Kopai 遥测数据，并随查看过程刷新。
用途与主要能力
该技能围绕 Kopai 实时页面提供一套完整工作流，涵盖：检查账户连接器、发现指标元数据、编写聚合查询、在发布前观察真实响应、构建页面并处理各类错误状态，以及完成发布。页面可按服务展示错误率等遥测视图，示例即为“最近一小时按服务划分的错误率”。
使用方式与流程要点
- 检查连接器：账户连接器名称必须精确为 Kopai，例如在 Claude Code 中工具显示为 mcp__claude_ai_Kopai__query。若仅有近似名称（如 kopai、Kopai (2)、kopai-local），可以构建页面，但应拒绝发布，并提示用户在连接器设置中重命名；若 Kopai 仅是 Claude Code 中配置的服务器，或根本不存在，则可用于前几步，但同样应拒绝发布，并说明发布页面只能调用 claude.ai 账户上的连接器。
- 发现指标：跟踪和日志无需发现；指标需调用 metrics_discover 获取名称、类型、单位和属性键。若返回 result_too_large，可从用户请求或 OpenTelemetry 语义约定中取名称，并在后续查询中确认。
- 编写查询：以 KopaiQuery JSON 形式针对查询工具的模式编写，每个查询均为聚合形式（timeSeries 用于图表，summary 用于单值）。分组图表需要两次调用：先用 summary 排名，再用 in 过滤绘制。需在此处一次性选定粒度，确保窗口除以粒度再乘以分组数不超过聚合上限。查询无效时依据返回的 issues 修复后重试。
- 观察真实响应：通过 Kopai 连接器逐一调用页面将调用的工具，了解返回负载形状；必须返回数据的图表若查询结果为空，应回到第 3 步修正，不得发布空图表。观察到的值属于用户真实数据，仅用于了解形状，不得写入页面源码。
- 构建页面：声明 mcp 能力并列出页面代码实际调用的工具（通常为 query）；每个查询对应一个 watchTool 调用，refetchInterval 等于查询粒度毫秒数；提供基于 result.cache.storedAt 的“最后更新”行；为 server_not_connected、not_granted、blocked_by_policy、needs_reauth、result_too_large 等状态提供各自提示；页面上说明每位查看者需要自己的 Kopai 连接，并链接到 https://kopai.app/connect-ai-assistants。
- 发布：仅在第一步找到精确名为 Kopai 的连接器时发布，并告知用户每位查看者都需要自己的 Kopai 连接。
适用场景与限制
适用于在 Claude 中构建依赖 Kopai 遥测数据、且需要按查看者身份实时查询的页面。运行时 API 细节（如 claude.use("mcp")、watchTool、错误码、缓存、轮询下限）属于 artifact-capabilities 技能及其 mcp.d.ts，使用前需加载并以其为准。页面查询必须为聚合形式，不能事后自行修复查询；连接器名称不精确或不存在时不得发布；空数据不得绘制部分图表；观察到的数据值不得出现在页面源码中。