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

DevOps 特工技能

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

什么是技能

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

每项技能都需要一个 Skill.md 文件，其中包含你要为特工提供的说明。 AWS DevOps 除了必需的 Skill.md 文件外，技能还可能包括：

为什么要使用技能

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

主要好处：

技能是如何运作的

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

技能结构

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

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/ .mdrds-metrics-reference:

# 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% |

创造技能

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

您可以通过两种方式创建技能，具体取决于您的工作流程偏好和技能复杂性：

在 UI 中创建技能

在 A AWS DevOps gent Operator Web 应用程序中创建的技能在一个 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 文件上传的技能必须包含 skill.md 中的前题，以及name和字段。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-investigation”，而不是通用名称。一个好的技能名称反映了它所涉及的特定场景或服务，因此可以更轻松地一目了然地识别出正确的技能。

管理技能

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

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

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

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

激活和停用技能-暂时禁用技能而不使用 Active/Inactive 切换按钮将其删除。打开技能详细信息视图并将开关切换到 “非活动”，以防止代理在保留所有内容和配置的同时加载技能详细信息以进行新的调查。正在进行的调查仍在继续使用该技能。切换回 “激活” 以使该技能立即再次可用。

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

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

从 Runbook 迁移

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

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