本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

DevOps 代理技能

AWS DevOps Agent Skills 是模块化指令集，通过为您的基础设施和操作工作流程量身定制的专业领域知识和调查方法，扩展代理人的能力。

什么是技能

技能是独立的目录，包含 Markdown 指令，可为代理提供专业功能。 AWS DevOps AWS DevOps 代理支持代理技能规范的子集（一种打包代理指令和资源的开放标准），仅支持不可执行的文档：Markdown 指令、PDF、图像和数据文件。

每项技能都需要一个 SKILL.md 文件，其中包含你要为 AWS DevOps 代理提供的指令。除了所需的 SKILL.md 文件外，技能还可能包括：

为什么要使用技能

技能将 AWS DevOps 代理从通用助理转变为基础设施和运营工作流程方面的专家。与聊天消息中提供的一次性说明不同，技能是可重复使用的功能，当与 AWS DevOps 代理执行的任务相关时，会自动加载。

主要好处：

技能是如何运作的

当 AWS DevOps 特工遇到相关任务时，它会加载相应的技能并按照指示进行调查。例如，“数据库性能调查” 技能可能包括分析 RDS 限制问题的分步程序，使代理能够系统地检查警报状态、分析连接指标和识别慢速查询。

技能结构

技能按目录进行组织，其中包含：

my-skill/
├── SKILL.md              # Main skill instructions
├── references/           # Optional: additional reference documentation
└── assets/               # Optional: images, diagrams, data files

SKILL.md

SKILL.md是唯一的必填文件。它包含以 Markdown 格式编写的核心指令。该文件应该：

前言

Frontmatter 是位于SKILL.md文件顶部的元数据块，包含在---分隔符之间。它包含name和description字段， AWS DevOps 代理在调查或任务期间使用这些字段来确定何时激活技能。

---
name: rds-performance-investigation
description: Investigation procedures for RDS performance issues including
  connection exhaustion, slow queries, replication lag, and storage capacity.
  Use this skill when investigating database latency, connection errors, or
  read/write performance degradation.
---

名称 — 技能的唯一标识符。仅使用小写字母、数字和连字符（最多 64 个字符）。不得以连字符开头或结尾。

描述 — 详细说明 AWS DevOps 代理应在何时及为何使用此技能。 AWS DevOps 代理评估此字段以确定该技能是否与当前任务相关。即使指令写得很好，模糊或缺失的描述也会导致代理完全跳过该技能。

重要 — 从代理的角度撰写描述。包括应触发技能的特定场景、服务、错误类型或症状。例如，“在调查 Amazon RDS 实例的数据库延迟、连接错误或查询超时时使用此技能” 比 “RDS 技能” 更有效。

当你在用户界面中创建技能时，系统会根据你提供的名称和描述自动生成 frontmatter。以 zip 文件形式上传的技能必须在文件中包含 frontmatter。SKILL.md

示例：完成技能

以下示例显示了调查 RDS 性能问题的完整、结构正确的技能。它演示了目录结构、 SKILL.md 前言、可操作的调查程序和补充参考文件。

目录结构：

rds-performance-investigation/
├── SKILL.md
├── references/
│   └── rds-metrics-reference.md
└── assets/
    └── rds-investigation-flowchart.png

SKILL.md:

---
name: rds-performance-investigation
description: Investigation procedures for RDS performance issues including
  connection exhaustion, slow queries, replication lag, and storage capacity.
  Use this skill when investigating database latency, connection errors, or
  read/write performance degradation.
---

# RDS Performance Investigation

Use this skill when customers report database latency, connection errors,
query timeouts, or read/write performance degradation.


## Step 1: Check alarm status

Query CloudWatch for active alarms on the affected RDS instance. Look for:
- `DatabaseConnections` exceeding 80% of max_connections
- `ReadLatency` or `WriteLatency` above 20ms
- `FreeStorageSpace` below 20% of total storage
- `ReplicaLag` above 30 seconds (read replicas only)


## Step 2: Analyze connection metrics

Retrieve `DatabaseConnections` over the past hour. If connections are near
the max_connections limit, check for connection pool misconfiguration or
long-running idle connections.


## Step 3: Identify slow queries

Use Performance Insights (`pi:GetResourceMetrics`) to retrieve the top SQL
statements by average active sessions. Focus on queries with high `db.load`
contribution or frequent I/O waits.


## Step 4: Summarize findings

Provide a summary with:
1. Current performance status (healthy / degraded / critical)
2. Root cause hypothesis with supporting metrics
3. Recommended remediation steps ranked by priority

references/rds-metrics-reference.md：

# RDS CloudWatch Metrics Reference


| Metric | Normal Range | Investigation Threshold |
|---|---|---|
| DatabaseConnections | < 70% max_connections | > 80% max_connections |
| ReadLatency | < 5ms | > 20ms |
| WriteLatency | < 5ms | > 20ms |
| FreeStorageSpace | > 30% total storage | < 20% total storage |
| ReplicaLag | < 5 seconds | > 30 seconds |
| CPUUtilization | < 70% | > 85% |

示例：事件过滤技能

针对 “事件分类” 代理类型的技能可以定义自动跳过事件的标准。使用它来筛选不需要调查的事件。当新事件符合跳过条件时， AWS DevOps 代理会将其标记为 “已跳过”。该系统提供了解释其被过滤的原因。

以下示例显示了在定期维护期间跳过低优先级事件的技能：

SKILL.md:

---
name: skip-scheduled-maintenance
description: Skip low-priority incidents during a scheduled maintenance window.
  Use this skill to automatically filter MEDIUM and LOW severity alarms that
  fire during planned maintenance, avoiding unnecessary investigations for
  expected disruptions.
---

# Skip Scheduled Maintenance

Skip all incidents that meet BOTH of the following criteria:

1. The incident arrived between **2025-03-15 02:00 UTC** and **2025-03-15 06:00 UTC**
2. Severity is MEDIUM or LOW

Do NOT skip HIGH or CRITICAL severity incidents, even during the maintenance window.

创建此技能时，选择 “事件分类” 作为代理类型。这样可以确保仅在分类阶段对技能进行评估。

创建技能

在创建技能之前，你必须有一个代理空间。有关更多信息，请参阅 创建代理空间。

根据工作流程偏好和技能复杂程度，您可以通过两种方式创建技能：

要通过 AWS CLI 或 AWS SDK 以编程方式管理技能，请参阅。管理资产

在用户界面中创建技能

在 AWS DevOps 代理操作员 Web 应用程序中创建的技能在单个 SKILL.md 文件中包含名称、描述和说明。

要在 UI 中创建技能，请执行以下操作：

系统会自动生成具有正确前端结构的 SKILL.md 文件。

要编辑在 UI 中创建的技能，请执行以下操作：

上传技能

以 zip 文件形式上传的技能包含 SKILL.md 文件以及其他资源，例如参考材料或资产。

技能结构：

my-skill.zip
├── SKILL.md              # Required: main skill instructions
├── references/           # Optional: reference documentation
│   ├── architecture.md
│   └── troubleshooting.md
└── assets/               # Optional: images, diagrams, data files
    ├── topology.png
    └── metrics.csv

SKILL.md 前端要求：

以 zip 文件形式上传的技能必须在 with name 和 fi description elds 中 SKILL.md 包含前端内容。 AWS DevOps 代理使用这些字段来确定何时激活技能。有关撰写有效前言的详细信息，请参阅本主题前面的 Frontmatter 部分。

---
name: rds-performance-analysis
description: Comprehensive RDS performance investigation procedures
  for connection exhaustion, slow queries, and storage capacity issues.
  Use when investigating database latency or read/write degradation.
---


# RDS Performance Analysis


[Your skill instructions here...]

要通过 zip 上传创建技能，请执行以下操作：

对以 zip 文件形式上传的技能的重要限制：

命名技巧的最佳实践：

使用清晰的描述性名称，例如 “rds-throttling-invessigation”，而不是通用名称。一个好的技能名称反映了它所针对的具体场景或服务，因此一目了然地更容易识别出正确的技能。

从存储库导入技能

您可以直接从 GitHub 存储库目录导入技能。 AWS DevOps 代理从存储库中获取技能内容，从头部提取名称和描述 SKILL.md ，然后在代理空间中创建技能。这使您可以管理版本控制中的技能，并通过一个操作将其导入。

先决条件：

存储库结构：

您导入的存储库目录必须遵循标准技能结构：

my-skill/
├── SKILL.md              # Required: must include name and description in frontmatter
├── references/           # Optional: reference documentation
│   └── runbook.md
└── assets/               # Optional: images, diagrams, data files
    └── architecture.png

要从存储库导入技能，请执行以下操作：

AWS DevOps 代理获取目录内容，读取 SKILL.md 前端内容以提取技能名称和描述，并将所有文件导入您的代理空间。

查看导入的技能：

导入的技能显示在 “自定义技能” 列表中，并带有指向源存储库的链接。在技能详细信息视图中：

同步导入的技能：

更新存储库中的技能文件时，您可以同步导入的技能以提取最新的更改：

您也可以通过在导入的技能行上选择 “同步”，从技能列表视图进行同步。

约束：

社区工具

GitHub 网站上的 AWS DevOps Agent Tools 存储库包含社区贡献的技能、自定义代理和 MCP 服务器，您可以按原样使用，也可以作为编写自己的技能的起点。存储库由 AWS DevOps 代理服务团队维护。所有贡献在添加之前都要经过相同的安全审查栏，因此您可以快速交付新功能，同时确保每个工具都符合 AWS 质量标准。要浏览可用内容，请参阅 GitHub 网站上的社区技能库。

可用技能包括：

要使用社区技能，请执行以下操作：

每项技能都包含一个自述文件，其中包含先决条件和使用说明。

该存储库还包括社区自定义代理和可部署的 MCP 服务器。有关详细信息，请参阅社区自定义代理和社区 MCP 服务器。

管理技能

AWS DevOps 代理通过操作员 Web 应用程序提供全面的技能管理功能：

列出技能 — 查看代理空间中的所有技能。知识页面的 “技能” 选项卡显示技能名称、“活动” 或 “非活动” 状态、创建日期、上次更新日期和可用操作。

查看技能 -选择任何技能以查看其详细视图。在 UI 中创建的技能会显示可编辑的内容，您可以在其中直接在 UI 中修改名称、描述或说明，然后选择 “保存” 进行更新。以 zip 文件形式上传的技能会显示一个文件树，其中显示了 SKILL.md 所有其他目录，如引用/ 和 assets/。在树中选择文件以只读模式查看其内容。

为技能选择代理 -配置哪些代理类型在创建或编辑每种技能时可以使用每种技能。在代理类型下拉列表中，使用复选框选择一种或多种代理类型：通用（默认-适用于所有代理类型）、 On-demand（对话式查询）、事件分类（初始事件评估）、事件 RCA（根本原因分析）、事件缓解（自动事件响应）或评估（主动建议）。默认情况下选择 “通用”，使所有代理类型均可使用该技能。针对特定代理的技能可减少上下文消耗，提高代理注意力。

激活和停用技能 -暂时禁用技能，但不使用 Active/Inactive 开关将其删除。打开技能详细信息视图并将开关切换到 “非活动”，以防止代理在保留所有内容和配置的同时加载技能详细信息以进行新的调查。 In-progress 继续使用该技能进行调查。切换回 “激活” 以使该技能立即再次可用。要以编程方式激活或停用技能，请参阅 “管理资产” 页面上的激活和停用技能。

更新技能 -根据创建方式修改现有技能。对于在用户界面中创建的技能，在技能详细信息视图中选择 “编辑”，修改名称、描述或说明，然后选择 “保存” 进行更新。对于以 zip 文件形式上传的技能，请在本地修改文件、创建新的 zip 文件并上传新版本。

删除技能 -从代理空间中永久移除技能。打开技能列表视图，选择更多选项菜单 () 并选择 “删除”，查看有关永久删除的警告，键入技能名称进行确认，然后选择 “删除技能”。删除无法撤消。 In-progress 如果调查人员尝试加载已删除的技能，则可能会受到影响。对于以 zip 文件形式上传的技能，请先下载 zip 文件，然后将其作为备份删除。如果您可能再次需要该技能，可以考虑停用该技能，而不是将其删除。

从 Runbook 迁移

现有的 Runbook 会自动迁移到 Skills，无需客户执行任何操作。当你的 Agent Space 过渡到技能模型时，所有运行手册都将转换为技能并显示在你的技能界面中。迁移后，您可以：

如果您在自动迁移的技能方面遇到任何问题或需要迁移后更新方面的帮助，请联系 AWS 支持部门。