1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | aws-health-events-aws-samples-sample-devops-agent-tools（AWS DevOps Agent Tools 子技能） |
| 项目自述名称 | AWS Health Events Skill |
| 作者/维护者 | AWS（GitHub 组织 aws-samples；该子技能提交者为 AWS 内部工程师 udid-aws） |
| 来源链接 | https://github.com/aws-samples/sample-devops-agent-tools/tree/main/skills/aws-health-events |
| 许可证 | Apache-2.0（仓库根 LICENSE 文件明确；来自 GitHub API 交叉核实） |
| GitHub Stars / Forks | 30 / 29（整仓库口径，来自 GitHub API；该仓库内含十余个不同 AWS 服务的技能，不代表本技能自身独立热度） |
| 最新版本 | 1.0.0（SKILL.md 元数据标注；CHANGELOG.md 仅记录初始版本） |
| 安装方式 | 从 GitHub 仓库导入 / 打包为 zip 后上传至 AWS DevOps Agent / 复制到任意兼容 Agent Skills 规范的 skills 目录 |
2. 功能介绍与亮点
该技能面向 AWS Health API，在故障排查与事故复盘时自动检索“AWS 侧”事件（服务中断、计划性变更、账号级通知），判断当前观察到的异常是否由 AWS 基础设施本身引起，而不是应用自身的问题。核心流程分七步：从事故上下文提取受影响服务/时间窗/资源标识 → 按服务与区域检索 Health 事件 → 过滤无关事件（丢弃超出时间窗的已关闭事件、非账号级的通知类事件）→ 拉取事件完整详情 → 对账号专属事件定位受影响资源 → 按“服务匹配+时间重叠+资源/区域匹配”打分为高/中/低相关度 → 输出结构化报告并给出下一步建议（如检查关联资源、复核配额、联系 AWS 支持）。
三点设计亮点：① 服务依赖图——内置一张“主服务→关联服务”映射表（如 ELB 关联 EC2/VPC/Route 53），当直接检索无结果时自动扩展到关联服务重试，避免遗漏跨服务级联故障；② 决策树式检索策略——区分“事故排查”与“账号健康报告”两种触发场景，各自有独立的时间窗扩展与降级路径；③ 9 类错误处理场景全覆盖——权限缺失、限流退避（1s→2s→4s）、超时、零结果、时间范围非法等均有明确的 agent 应对指令，而非停在“报错”层面。技能文档体量在同仓库中最完整（SKILL.md 正文约 18.5KB，另附独立的 Health API 参考文档），且与同仓库的 support-cases 技能显式互相引用（“如怀疑某 Health 事件导致中断，可用 support-cases 技能核对是否已有关联支持工单”），体现出一套协同设计的运维排查工具链而非孤立脚本。最近一次针对该技能目录的实质性提交在 2026-07-29（近日）。
3. 适用场景
固定分类：DevOps 与基础设施
适用于已在生产环境运行 AWS 工作负载、且持有 AWS Business Support+/Enterprise Support/Unified Operations 支持计划的运维/SRE 团队：事故发生时快速排除或确认“是否是 AWS 自身的问题”，避免在应用侧盲目排查一个实际由云厂商引起的故障；也适用于定期生成账号级 AWS Health posture 报告、盘点近期服务中断与计划维护窗口对自身资源的影响范围。
4. 跨 Agent 兼容性
该技能是标准 SKILL.md + YAML front matter 格式，遵循开放的 Agent Skills 规范（agentskills.io），本身不含平台专属二进制或脚本依赖（README 明确声明打包上传时不允许携带 scripts/ 目录）。
- Claude Code：⚠️ 需适配。可直接复制到
~/.claude/skills/使用，但正文的aws health describe-events等调用统一走 AWS DevOps Agent 的原生 API 调用能力，需自备等效的 AWS 只读调用方式（如 AWS CLI 或对应 MCP 服务器）。 - Codex：⚠️ 需适配，理由同上——技能本身面向 AWS DevOps Agent 这一独立产品编写，非 Codex 原生技能，但格式兼容。
- OpenClaw：❓ 未验证，抓取材料中未见相关证据。
- Hermes Agent：❓ 未验证，抓取材料中未见相关证据。
5. 推荐理由
由 AWS 官方团队维护，把“事故是不是 AWS 自己的问题”这一排查步骤固化成结构化流程：服务依赖图能在直接检索无果时自动扩展排查范围，决策树区分事故排查与常规报告两种场景，9 类错误处理让 agent 在权限不足、限流、超时等异常下仍有明确应对指令而不是卡住。对已购买高等级 AWS 支持计划、需要快速排除云厂商侧因素的运维团队，能省去手动翻 AWS Health Dashboard 的步骤。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | AWS 官方 samples 组织出品，AWS Health 是 AWS 自有的账号健康监控服务，属第一方发布；所属 AWS DevOps Agent 产品已于 2026 年 3 月 31 日正式 GA，获 InfoQ 等行业媒体报道。仓库创建约两个半月，30 Star/29 Fork 绝对值尚不高，本技能自身暂无独立第三方讨论 |
| 可用性 | 6 | SKILL.md 与独立参考文档齐全，前置 IAM 权限清单精确到 4 个具体 API 动作，错误处理覆盖 9 类场景，维护活跃（最近提交 2026-07-29）；但 AWS Health API 强制要求 Business Support+/Enterprise Support/Unified Operations 支持计划（Basic/Developer 等级无法通过 API 获取账号级事件），这是在“需要 AWS DevOps Agent 产品”之上叠加的第二层准入门槛，且该 API 仅在 us-east-1 端点可用 |
| 安全性 | 9 | 全流程仅调用 health:Describe* 只读 API（DescribeEvents/DescribeEventDetails/DescribeAffectedEntities/DescribeEventTypes），无任何写操作或状态变更；无第三方网络外发；凭据依赖用户已配置的 AWS IAM 角色而非明文密钥；License 清晰（Apache-2.0）；作者为 AWS 官方组织具名工程师 |
综合 = 三项均值 = 7.67
安全检查清单： ① Shell 命令/权限范围——仅只读 API 调用，无写操作； ② 联网外发——仅与用户自有 AWS API 通信，无第三方外发； ③ 凭据方式——依赖用户已配置的 AWS IAM 角色权限，非明文 API Key； ④ 可疑指令——未发现，全部为标准检索、过滤与报告生成说明； ⑤ 作者信誉——AWS 官方组织，提交者为具名内部工程师； ⑥ License——Apache-2.0，明确； ⑦ 维护时间——最近一次改动在 2026-07-29，处于活跃维护窗口内。
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与本技能的差异 |
|---|---|---|
| support-cases（同仓库姊妹技能） | 检索历史 AWS Support 工单，复用过往事故的根因与解决方案 | 数据源是人工支持工单而非 AWS 系统事件；两者设计为互补——本技能确认“是否是 AWS 侧问题”，support-cases 确认“过去是否有人报过同样的问题” |
| eks-operation-review / rds-operation-review / msk-operations / storage-s3-resiliency-expertise（同仓库姊妹技能） | 分别对 EKS/RDS/MSK/S3 做定期结构化运维审查 | 定位是主动式、周期性的资源健康巡检，而本技能是被动触发式、事故发生后的根因排除工具，两类场景互补但不重叠 |
| enrich-with-aws-security-agent（同仓库姊妹技能） | 查询 AWS Security Agent 的 CloudWatch 日志，把代码安全扫描发现关联到应用故障 | 排查角度是“这是不是代码安全漏洞导致的”，而非“这是不是 AWS 基础设施本身的问题”；且依赖的 AWS Security Agent 面向应用代码安全评审场景，与 AWS Health 面向账号级基础设施事件的定位不同 |
8. 用户评价
该技能所属仓库与其自身在第三方平台尚无具名用户评价。其所服务的 AWS DevOps Agent 产品已于 2026 年 3 月 31 日正式 GA，获 InfoQ、AWS 官方博客等报道，预览期数据显示可将平均故障恢复时间（MTTR）降低达 75%；但这些评价针对产品整体，未见专门提及本技能。
9. 其他补充
技能附带独立的 references/health-api-reference.md 参考文档，把 AWS Health API 的服务代码对照表等细节从主指令中拆分维护。README 明确要求打包上传时排除 scripts/、evals/、.skilleval.yaml 等目录，保持发布产物精简。
10. 安装使用方式
- AWS DevOps Agent 官方渠道：在 Agent Space 的 Operator Web App 中，进入 Skills 页面，选择“Add skill” → “Import from repository”或“Upload skill”（zip 上传，限 6MB），选择 agent 类型 Chat tasks 与 Incident RCA。
- zip 上传：克隆仓库后进入
skills/目录，按 README 给出的 zip 命令打包aws-health-events/目录（仅含.md/.txt/.json/.yaml等允许扩展名，排除scripts/、evals/）。 - 手动复制（其他兼容 Agent Skills 规范的工具）：克隆仓库后将该目录整体复制到目标 agent 的 skills 目录（如
~/.claude/skills/、~/.codex/skills/）。 - 前置条件：需具备目标 AWS 账号内
health:DescribeEvents、health:DescribeEventDetails、health:DescribeAffectedEntities、health:DescribeEventTypes只读 API 权限，且账号需持有 AWS Business Support+/Enterprise Support/Unified Operations 支持计划（否则 Health API 调用会被拒绝）。 - 触发方式：安装后以自然语言请求如“我们的 RDS 连接告警是不是 AWS 侧问题”“生成过去 30 天的账号健康报告”“us-west-2 这个月有哪些健康事件”即可触发，无需显式提及技能名。
11. 注意事项
- 该仓库定位为 AWS 官方“示例代码”，README 明确建议生产环境部署前先在非生产环境测试，并按自身组织的安全策略复核 IAM 权限配置。
- AWS Health API 仅在
us-east-1端点可用（无论受影响资源实际部署在哪个区域），所有调用必须指向该端点；事件数据仅保留 90 天，超期事件无法通过 API 检索。 - 完整使用前提是账号已持有 Business Support+ 及以上支持计划——这是比同仓库多数技能更高的一道门槛，标准/开发者级支持计划无法使用该技能。
- 完整体验依赖 AWS DevOps Agent 产品或自行搭建等效的 AWS 工具调用能力；同仓库内其他技能（如 support-cases、enrich-with-aws-security-agent）各自的前置条件不同，安装前需留意各自的 Prerequisites 章节。