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

DevOps 特工技能

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

什么是技能

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

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

为什么要使用技能

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

主要好处：

技能是如何运作的

当 AWS DevOps Agent 遇到相关任务时，它会加载相应的技能，并按照说明指导其调查。例如，“数据库性能调查” 技能可能包括用于分析 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 frontmatter、可操作的调查程序和补充参考文件。

目录结构：

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 以编程方式管理技能，请参阅。管理资产

在用户界面中创建技能

在 A AWS DevOps gent Operator Web App 中创建的技能在一个 SKILL.md 文件中包含名称、描述和说明。

要在用户界面中创建技能，请执行以下操作：

系统会自动生成一个具有适当前题结构的 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 和 fortmatt SKILL.md er 中的内容description。 AWS DevOps 代理使用这些字段来确定何时激活技能。有关撰写有效 frontmatter 的详细信息，请参阅本主题前面的 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-investivity”，而不是通用名称。一个好的技能名称反映了它所涉及的特定场景或服务，因此可以更轻松地一目了然地识别出正确的技能。

从仓库导入技能

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

先决条件：

存储库结构：

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

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 代理获取目录内容，读取 f SKILL.md rontmatter 以提取技能名称和描述，并将所有文件导入您的代理空间。

查看导入的技能：

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

同步导入的技能：

当你更新仓库中的技能文件时，你可以同步导入的技能以提取最新的更改：

您也可以通过单击导入的技能行上的 “同步” 按钮从技能列表视图进行同步。

约束：

技能示例

上的DevOps 技能库 GitHub 包含社区贡献的技能，你可以按原样使用或作为编写自己的技能的起点。可用样本包括 Healt AWS h 事件调查技能、S AWS upport 案例分析、EKS 运营审查和 RDS 运营审查。要浏览可用技能，请参阅社区技能库。

要使用示例技能，请执行以下操作：

每项技能都包含一份包含先决条件和使用说明的自述文件。

管理技能

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

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

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

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

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

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

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

从 Runbook 迁移

现有 Runbook 会自动迁移到技能，无需客户采取任何行动。当你的 Agent Space 过渡到技能模型时，所有 Runbook 都将转换为技能并出现在你的技能用户界面中。迁移后，您可以：

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