核心用法
Checkly CLI Skills 是一套面向「监控即代码」(Monitoring as Code) 的完整 CLI 工作流指南，覆盖从项目初始化、认证配置、检查编写、本地测试到云端部署的全生命周期。
主要能力：
- 项目脚手架：
npm create checkly@latest一键生成包含 checkly.config.ts、__checks__/ 目录的标准项目结构 - 多类型检查：API Check（HTTP 请求+断言）、Browser Check（Playwright spec）、Heartbeat/TCP/DNS Monitor 等
- 本地测试链：
npx checkly test在 Checkly 运行时验证；浏览器检查可先用npx playwright test快速迭代 - 部署与导入：
npx checkly deploy持续部署；npx checkly import将现有 Web UI 检查反向生成代码 - 运维诊断：
npx checkly checks list/get查看失败检查、错误分组、RCA 根因分析；支持下载日志、视频、截图、pcap 等资产
配置层级（优先级递减）：Check 级 > CheckGroup 级 > checkly.config.ts 默认 > 账户全局默认
显著优点：
- 官方原生支持，与 Checkly 云平台深度集成
- TypeScript-first，类型安全，支持 Git 版本控制与 Code Review
- 原生 Playwright 支持，复用现有测试资产
- CI/CD Native，可嵌入部署流水线实现「监控随应用一起发布」
- 丰富的诊断能力，支持 Rocky AI 自动根因分析结果的复用
潜在局限：
- 需 Node.js 环境，对非 Node 技术栈团队有额外成本
- Browser Check 在 Checkly 运行时与本地 Playwright 可能有行为差异，需双重验证
- 复杂多步流程需理解 CheckGroup、Constructs 等抽象概念，学习曲线存在
- 私有化部署场景需额外配置 Private Locations
适合人群：
- 需要将监控纳入 Git 工作流的 DevOps/SRE 团队
- 已有 Playwright 测试资产、希望一键转为合成监控的 QA/开发者
- 追求「Infrastructure as Code」一致性，厌恶手动配置 Web UI 的工程师
- 需要规模化管理数十上百个检查的中大型组织
常规风险：
- API Key/Account ID 等凭证需妥善管理，避免泄露到版本库
npx checkly checks delete为破坏性操作，建议先用--dry-run预览- 生产部署前务必通过
npx checkly test验证，防止因运行时差异导致误报/漏报 - 检查频率与并发配置不当可能产生较高云成本