用途
该技能用于对 AWS 工作负载执行系统化的 AWS Well-Architected Framework(WA 框架)评审。其目标是根据框架的全部问题与最佳实践(BP),结合工作负载的代码和 IaC 证据,产出一份按风险排序、并经艾森豪威尔矩阵划分优先级的评审报告。
主要能力
- 评审模式:支持完整评审(full)、快速评审(quick)、按支柱限定(pillar-scoped)和评分(score)四种模式,由用户的表述触发。
- 实时框架语料:在评审时从 AWS 官方文档实时获取框架内容,而非使用内置快照。推荐使用 AWS MCP 服务器的文档读取器(aws___read_documentation);不可用时可通过 HTTPS 抓取同一 docs.aws.amazon.com 页面;若完全无文档访问能力,则基于内部知识进行并需声明框架清单无法实时验证。不依赖任何非公开或内部的 WA/最佳实践 MCP。
- 发现过程:包括基础设施发现与应用架构发现,并在评估前设有内部完整性门禁。
- 语料冻结(ACQUIRE_CORPUS):通过有界、只读的方式遍历框架规范页面,生成问题与最佳实践的清单(questions.jsonl、best-practices.jsonl、manifest.json),并在校验通过(valid: true)后才进入评估。此步骤为所有模式共有,不可跳过。
- 逐条评估:对冻结清单中的每一条 BP 使用五值状态(Implemented、Partially Implemented、Not Implemented、Not Applicable、Cannot Determine)并给出证据、差距、风险,按支柱分批执行并做覆盖审计。
- 风险与优先级:使用影响 × 可能性矩阵评估风险,处理跨支柱权衡,并生成艾森豪威尔划分(Do First / Plan / Delegate / Defer)的整改计划及 SMART 目标。
- 报告输出:以 Markdown 形式内联交付完整报告,首行为
# Well-Architected Review:,包含覆盖审计、支柱评分卡、逐问题评估表、完整 BP 台账、风险分级发现及整改计划等强制章节。 - Lens 支持:当工作负载匹配某个实时 Lens 时,可应用 Well-Architected Lens 指导;若用户仅指定某个 Lens 且未要求完整框架评审,则输出独立的 Lens 报告。
- 后续选项:交付报告后提供深入某支柱、生成修复用 IaC 模板、制定迁移计划、对照特定 Lens 详细比较、生成自动检查(Config 规则、自定义指标)、生成 WA Tool 导入等跟进选项。
使用方式
用户发起评审请求并提供足够范围后,该技能默认以非交互方式执行,依次完成:定义工作负载范围 → 基础设施发现 → 应用架构发现 → 获取并冻结实时语料清单 → 逐条评估全部 BP → 风险评估 → 生成报告 → 提供后续选项。步骤间设有转换门禁,前一步未通过不得进入下一步。发现与风险评估中的检查点为内部验证门禁,由技能自行验证后继续;仅在用户明确要求交互式检查点或存在无法推断的必要范围决策时才暂停询问。
工作负载范围包括:名称与简要描述、需分析代码包/目录(IaC、应用代码、CI/CD 配置)、业务关键性(critical/high/standard/low)、当前痛点(可选)。若用户已提供架构细节或当前代码库含 IaC,则直接进行发现;若无代码或 IaC,则基于用户的描述作为证据,并将无法在代码中验证的发现标注为“Based on description — verify in code”。
适用场景
- 需要对照 AWS Well-Architected 框架对现有工作负载进行完整或限定范围的架构评审。
- 希望从代码与 IaC 中自动发现架构并生成结构化报告。
- 需要按风险与优先级排序的整改建议,并计划在 AWS 控制台中跟踪。
- 需要将工作负载与特定 WA Lens 对照分析。
限制与注意事项
- 语料获取为强制且不可跳过的步骤;若无法生成某个规范 ID,应作为错误上报,严禁自行编造
PILLAR##-BP##ID。 - 全部评估必须针对冻结的清单进行;不得在清单不完整或未通过校验时开始评估。
- 完整评审须为清单中每一条 BP 给出唯一状态,且报告模板的全部章节必须齐备,不得以“见文件”或附件形式替代。
- 不得凭空制造 Critical 发现;每个发现必须有代码证据;无法从代码判断时须标注“Cannot Determine”并说明需要哪些运行时或访谈数据。
- 安全方面要求:秘密信息脱敏、仅经 HTTPS 获取、最小权限、机密性处理;这些须在操作工作负载代码或评审工具前载入。
- 本技能在受支持运行时中不依赖非公开或内部的 WA/最佳实践 MCP。
关于具体收费、价格、平台支持范围等信息,现有资料未提供。