CloudWatch 告警运行手册生成器

问题：告警触发后，响应手册往往落后于配置

CloudWatch 告警能告诉我们某个信号越过了阈值，但值班同学真正需要的是另一份上下文：这是哪个指标、属于哪个命名空间、有哪些维度、告警状态和触发原因是什么，以及有没有关联的 Systems Manager 修复文档。如果这些信息散落在监控面板、wiki 和个人笔记里，告警配置一旦更新，运行手册很容易失真。

技能如何工作

• 通过 DescribeAlarms API 读取目标 CloudWatch 告警配置，把告警名称、状态、触发原因、指标、命名空间、维度、阈值和评估周期等字段整理出来。
• 将告警与其关联的 AWS Systems Manager 文档对应起来，生成结构化的修复指引，而不是只给一句“请检查服务”。
• 输出运行手册时保留告警配置到修复程序的链路，方便工程师从告警快速定位到可执行的 SSM 文档。
• 适合把已有 CloudWatch 告警沉淀为可维护的事件响应材料，减少每次值班时重新拼凑上下文的成本。

适用边界与注意点

• 它负责生成告警运行手册并链接修复程序，不会自动执行 SSM Automation，也不会代替监控系统持续采集指标。
• 调用方需要具备读取 CloudWatch 告警和 Systems Manager 文档所需的 IAM 权限；权限不足时可能只能得到部分配置。
• 如果告警关联的 SSM 文档被删除、改名，或文档参数与当前账号/Region 不匹配，生成的运行手册会缺少有效修复入口。
• 对于参数化 SSM 文档，运行手册仍应保留运行前需要确认的参数和上下文，避免把参考文档误当成已经验证的自动化剧本。