canary-watch

canary-watch 技能概览

canary-watch 是一项部署后监控技能，用于在发布、合并或依赖更新后，检查线上 URL 是否出现回归。需要在真实环境里做快速、可重复的 canary 检查时，用 canary-watch 比起那种只凭猜测判断“这次发布安不安全”的泛化提示更合适。

它最适合工程师、SRE 和产品团队，用来确认应用仍能正常加载、关键 API 仍有响应，以及重要的 UI/内容信号没有丢失。它要完成的核心任务很直接：尽早发现故障，在更多用户受影响之前完成回滚或排查。

canary-watch 实际会检查什么

这个技能关注的是实用的回归信号：HTTP 状态、控制台错误、网络失败、性能漂移，以及 h1、nav、footer 或 CTA 等关键页面元素的消失。相比一句“网站是不是还活着”的检查，canary-watch 更适合在高风险变更之后使用。

canary-watch 最适合用在什么场景

canary-watch 适用于生产或 staging 的 smoke check、发布窗口监控、基线对比，以及修复后的验证。尤其是在你已经知道目标 URL、并且希望拿到带阈值的监控结果，而不是进行一场泛泛的排错会话时，它会非常合适。

什么时候不该用 canary-watch

如果你需要深入的根因分析、跨服务 tracing，或者长期的可观测性仪表盘，canary-watch 不是完整方案。它是一个面向短周期监控和回归检测的专用技能，而不是日志系统或 APM 栈的替代品。

如何使用 canary-watch 技能

在你的工作区安装 canary-watch

按照仓库里的安装命令走完 canary-watch 的安装流程，然后在把它用于生产工作之前，先确认它已经能在你的 agent 环境里可用。如果你的平台使用的是另一套 skill manager，也要把同一个 skill slug canary-watch 映射进去。

把模糊目标改写成可执行的提示词

canary-watch 的使用方式在你给出 URL、watch 模式和成功边界时效果最好。弱输入：“帮我检查网站。” 强输入：“部署后监控 https://app.example.com 30 分钟，出现新的控制台错误、5xx API 响应，或 nav 和 CTA 元素缺失时告警，并与当前基线对比。”

先读这些文件

先从 SKILL.md 开始，再查看技能提到的任何关联仓库上下文。对于 canary-watch 来说，最有价值的信息通常在 SKILL.md 里的用法和阈值逻辑，尤其是 watch 模式、告警阈值，以及技能把什么算作有意义的回归。通常读到这里就足够调整工作流，不必过度展开整个仓库。

选择合适的 watch 模式

一次性 smoke test 用 quick check；需要覆盖发布窗口、持续一段时间监控时，用 sustained watch；想比较 staging 和 production 时，用 diff mode。对于 canary-watch 这类监控场景来说，模式比措辞更重要：一定要提前定义间隔、时长和比较目标，这样 agent 才不会替你凭空编排监控方案。

canary-watch 技能 FAQ

canary-watch 只适合生产环境吗？

不是。canary-watch 也适用于 staging，而在把高风险变更推到生产之前，staging 往往是更安全的验证场景。关键要求是：你要有一个已部署的 URL，而且它的行为能和已知基线进行比较。

canary-watch 和普通提示词有什么区别？

普通提示词也可以让它去检查，但 canary-watch 的使用方式是围绕明确的 watch 模式、阈值和回归信号组织起来的。这样可以减少歧义，在你需要决定继续发布还是停止时，结果也更可执行。

我不是专家也能用吗？

可以。只要你能说明 URL、时间窗口，以及你最关心的主要失败信号，初学者也能用 canary-watch。最常见的问题不是不会用，而是对“什么算正常”说得太模糊，最后得到的结果就会噪声很多，或者不完整。

它可能会漏掉什么？

canary-watch 不太适合那种只发生在后端、但不会在 HTTP、控制台、网络或页面内容信号中表现出来的故障。它也不能替代完整的性能或事件响应工作流，尤其是在你需要历史趋势或多服务关联分析时。

如何改进 canary-watch 技能

给它更清晰的基线

提升效果最大的办法，是告诉 canary-watch 什么叫“正常”：精确 URL、预期页面状态，以及必须保持健康的关键元素或端点。如果你知道基线本身就有噪声，也要直接说明；否则技能可能会把无害变化误判成异常。

指定阈值，不要只描述症状

不要只说“慢了告诉我”，而要用具体限制，比如“LCP 超过 4 秒就标记”“CLS 超过 0.1 就警告”或者“出现新的 5xx 响应就告警”。当你给出的边界能够直接对应发布决策时，canary-watch 的表现最好。

第一次运行后收紧提示词

如果第一次 canary-watch 的输出范围太宽，就缩小到更少的端点、更少的元素，或者更短的监控窗口。如果它漏掉了问题，就补充具体的用户路径、页面状态或失败的 API，让下一次运行去检查正确的表面。

把它当作发布门禁，而不是好奇心检查

最好的 canary-watch 用法，是每次运行后都能落到一个明确决定：继续发布、暂停，还是开始排查。把每次结果都当成发布检查点，并把结果反馈进下一次提示词里，这样这个技能会越来越贴合你的环境。