1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | support-cases-aws-samples-sample-devops-agent-tools（AWS DevOps Agent Tools 子技能） |
| 项目自述名称 | Support Cases Skill — AWS DevOps Agent Skill |
| 作者/维护者 | AWS（GitHub 组织 aws-samples；该子技能提交者为 AWS 内部工程师 udid-aws） |
| 来源链接 | https://github.com/aws-samples/sample-devops-agent-tools/tree/main/skills/support-cases |
| 许可证 | Apache-2.0（仓库根 LICENSE 文件明确；来自 GitHub API 交叉核实） |
| GitHub Stars / Forks | 30 / 29（整仓库口径，来自 GitHub API；该仓库内含十余个不同 AWS 服务的技能，不代表本技能自身独立热度） |
| 最新版本 | 1.0.0（CHANGELOG.md 记录初始发布） |
| 安装方式 | 从 GitHub 仓库导入 / 打包为 zip 后上传至 AWS DevOps Agent / 复制到任意兼容 Agent Skills 规范的 skills 目录 |
2. 功能介绍与亮点
该技能在事故排查开局阶段自动检索 AWS Support 历史工单（含未结与已结案例），按受影响服务、时间窗口、严重级别与错误关键词过滤，定位症状相似的既往事故。核心能力包括：读取工单通讯记录、从中提炼 AWS 支持工程师给出的根因结论与修复步骤；用一套 pattern matching 清单与三级相关性打分（High/Medium/Low）把历史工单与当前事故做关联；最终产出结构化总结——命中工单数量、最相关工单、历史根因、过往修复措施是否为永久方案，以及“同一问题反复出现”的复发提醒。
技术设计上三点值得注意：① 决策树式检索策略——先判断是否已知具体 case ID，再判断受影响服务是否明确，据此从窄到宽逐层扩大搜索范围，避免无谓的全量检索；② 与同仓库姊妹技能显式协同——同一仓库的 aws-health-events 技能负责判断“是不是 AWS 基础设施自身在出问题”，本技能负责检索“我们自己是否踩过同样的坑”，两者共同覆盖事故排查的外部/内部两条线索；③ 自带正式评测框架——evals/ 目录含完整评测报告，官方 Agent Skill Eval 总分 0.94（Grade A），其中触发查询 5 条全部命中（pass_rate 1.0）。仓库整体最近一次提交在 2026-08-10，但该子技能目录自身最近一次实质提交是 2026-06-21。
3. 适用场景
固定分类：DevOps 与基础设施
面向已购买 AWS Business Support+、Enterprise Support 或 Unified Operations 支持计划的运维/SRE 团队：事故调查刚开始时快速核实是否发生过相似症状的历史工单、按季度或年度汇总某服务的历史支持记录做复盘、追溯“某个具体工单当初是怎么解决的”。对需要频繁处理生产事故、又依赖历史案例沉淀作为排查捷径的团队尤其实用。
4. 跨 Agent 兼容性
该技能是标准 SKILL.md + YAML front matter 格式，遵循开放的 Agent Skills 规范（agentskills.io），本身不含平台专属二进制或脚本依赖。
- Claude Code：⚠️ 需适配。可直接复制到
~/.claude/skills/使用，但正文的数据采集统一走 AWS DevOps Agent 原生的 AWS Support API 调用能力，需自备等效的只读调用方式（如 AWS CLI 或对应 MCP 服务器）。 - Codex：⚠️ 需适配，理由同上——技能面向 AWS DevOps Agent 这一独立产品编写，非 Codex 原生技能，但格式兼容。
- OpenClaw：❓ 未验证，抓取材料中未见相关证据。
- Hermes Agent：❓ 未验证，抓取材料中未见相关证据。
5. 推荐理由
由 AWS 官方团队维护，把“先查有没有踩过同样的坑”这一常被跳过的排查步骤固化为结构化流程：决策树式检索策略、通讯记录中根因提取的具体指引、pattern 匹配清单与三级相关性打分，让“是否发生过类似问题”从凭记忆判断变成可复用的方法论；自带正式评测验证（Grade A，触发查询 5/5 全部命中），可与同仓库 aws-health-events 组成“内部历史 + 外部事件”双线索的事故排查工具链。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | AWS 官方 samples 组织出品，属第一方发布；所属 AWS DevOps Agent 产品已于 2026 年 3 月正式 GA 并获行业媒体报道。仓库 30 Star/29 Fork，本技能自身暂无独立第三方讨论 |
| 可用性 | 6 | SKILL.md、README、2 份参考文档齐全，自带正式评测框架（总分 0.94，Grade A，触发查询 5/5 全部命中）；但 AWS Support API 强制要求 Business Support+/Enterprise Support/Unified Operations 支持计划（Basic/Developer 等级无法调用），这是在“需要 AWS DevOps Agent 产品”之上叠加的第二层准入门槛；该子技能目录自身最近一次实质提交在 2026-06-21（约七周前），晚于仓库内部分同期更新的技能 |
| 安全性 | 9 | SKILL.md 明确要求仅 support:DescribeCases 与 support:DescribeCommunications 两个只读 API 权限，不含任何写操作；License 清晰（Apache-2.0）；作者为 AWS 官方组织具名工程师 |
综合 = 三项均值 = 7.67
安全检查清单： ① Shell 命令/权限范围——仅调用两个只读 AWS Support API，无写操作； ② 联网外发——仅与用户自有 AWS API 通信，无第三方外发； ③ 凭据方式——依赖用户已配置的 AWS IAM 角色权限，非明文 API Key； ④ 可疑指令——未发现，全部为标准检索/分析步骤说明； ⑤ 作者信誉——AWS 官方组织，提交者为具名内部工程师； ⑥ License——Apache-2.0，明确； ⑦ 维护时间——仓库整体最近一次提交在 2026-08-10，该子技能目录自身最近一次实质提交在 2026-06-21，仍在近 3 个月维护窗口内。
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与本技能的差异 |
|---|---|---|
| aws-health-events（同仓库姊妹技能） | 检索 AWS Health 服务级事件，判断异常是否源自 AWS 基础设施本身 | 数据源是 AWS 官方事件公告，而非用户自己历史提交的支持工单；本技能查的是“我们自己过去踩过的坑”，对方查的是“AWS 那边是不是在出问题” |
| database-migration-service-expertise / rds-operation-review / msk-operations（同仓库姊妹技能） | 针对特定 AWS 服务（DMS/RDS/MSK）做结构化健康审查 | 定位是主动巡检单个服务实例的当前健康状态，而非检索历史工单找相似症状；服务对象窄但审查深度高 |
| investigation-cost-guardrail（同仓库姊妹技能） | 事故排查全程的成本护栏，估算并限制 API 调用花费 | 服务的是排查过程本身的经济性，与“查什么历史案例”无关，二者可同时启用互不冲突 |
8. 用户评价
该技能所属仓库与其自身在第三方平台尚无具名用户评价。其所服务的 AWS DevOps Agent 产品已于 2026 年 3 月正式 GA，获得 InfoQ 等行业媒体报道，但这些评价针对产品整体，未见专门提及本技能。
9. 其他补充
技能自带 evals/ 目录，含功能测试用例、触发查询集与完整评测报告（report.json）。官方 Agent Skill Eval 总分 0.94（Grade A）：规范审计维度满分 100（Grade A，0 项 critical/warning）；功能维度 0.88（Grade B，outcome 0.94/process 0.65/style 0.94/efficiency 1.0）；触发查询 5 条全部命中（pass_rate 1.0）。成本效益评测归类为 TRADEOFF——带技能执行相较不带技能可提升约 39% 的输出质量，但增加约 11% 的 token 成本。
10. 安装使用方式
- AWS DevOps Agent 官方渠道：在 Agent Space 的 Operator Web App 中，进入 Skills 页面，选择“Add skill” → “Upload skill”，上传按官方规则打包的 zip（排除
evals/、.skilleval.yaml、README.md、CHANGELOG.md，限 6MB）。 - GitHub 导入：若已在 Agent Space 配置 GitHub 连接，可直接从仓库导入，指向
skills/support-cases目录。 - 手动复制（其他兼容 Agent Skills 规范的工具）：克隆仓库后将该目录整体复制到目标 agent 的 skills 目录（如
~/.claude/skills/、~/.codex/skills/）。 - 前置条件：目标 AWS 账号需具备 Business Support+、Enterprise Support 或 Unified Operations 支持计划，并授予
support:DescribeCases、support:DescribeCommunications只读权限。 - 触发方式：安装后以自然语言请求如“Show me all support cases opened in the last 30 days for RDS”，或直接描述事故症状（如“We’re seeing 5xx errors on our ALB”）触发排查流程，无需显式提及技能名。
11. 注意事项
- 该仓库定位为 AWS 官方“示例代码”，非直接用于生产环境，涉及配置变更的建议均需先在非生产环境验证。
- 强制要求 Business Support+/Enterprise Support/Unified Operations 支持计划，Basic/Developer 等级账号无法使用，这是拉低可用性评分的主因，安装前需先确认账号支持等级。
- Support 工单数据仅可追溯 24 个月，超过 24 个月的历史工单无法通过 API 检索。
- 该子技能目录自身最近一次实质提交在 2026-06-21，若需要跟踪后续功能更新建议关注仓库整体 changelog。
- 版本为 1.0.0 初始发布，尚无迭代记录。