SuperAPI AI 工具集

wa-review

部署与运维

查看项目

更新于 10-15 13:37

技能介绍

用途

wa-review 用于对工作负载执行 AWS Well-Architected Framework 评审。它通过分析代码、IaC 和配置,评估 6 大支柱下的全部 57 个问题,并产出结构化报告。

主要能力

  • 覆盖 6 大支柱:运营卓越(OPS 1–11)、安全(SEC 1–11)、可靠性(REL 1–13)、性能效率(PERF 1–5)、成本优化(COST 1–11)、可持续性(SUS 1–6)。
  • 完整评审会评估全部 307 个最佳实践(BP),每条 BP 获得五种状态之一:已实现、部分实现、未实现、不适用、无法确定。
  • 支持识别专用 WA Lens:SaaS、Serverless、Data Analytics、Machine Learning、IoT、Containers、Games、Financial Services、Healthcare。
  • 基础设施发现覆盖 CDK、CloudFormation、Terraform、SAM/Serverless Framework、CI/CD 管道定义、监控配置、部署配置。
  • 应用架构发现覆盖入口点、服务通信模式、数据访问模式、错误处理与韧性模式、认证/授权逻辑、可观测性埋点。
  • 生成 PlantUML 架构图,展示主要组件、数据流、外部依赖、信任与网络边界。
  • 提供证据充分性门控:省略或不确定的信息记为“无法确定”,而非“未实现”。

使用方式

技能按步骤执行:

  1. 定义工作负载范围:询问工作负载名称与描述、要分析的代码包/目录、业务关键性、当前痛点。若已提供架构细节或处于含 IaC 的代码库中,则跳过提示直接进入发现。
  2. 基础设施发现:分析代码库中所有 IaC 与部署配置,记录资源类型、逻辑名称、配置、文件路径与行号、安全相关配置、韧性配置、成本相关配置,并创建 PlantUML 架构图。
  3. 应用架构发现:分析应用代码中的架构模式。
  4. 检查点:在评估前呈现发现结果,等待用户明确确认后再继续。
  5. 评估全部 57 个问题,每条 BP 给出状态、证据、差距、风险。

评审深度:

  • 完整评审(默认):评估全部 57 个问题,加载各支柱参考文件,引用具体 BP ID。
  • 快速评审:仅在问题级别评估全部 57 个问题,不加载单个 BP 参考文件。
  • 支柱范围评审:仅评估指定支柱的问题,加载对应支柱 playbook,应用完整评审深度。
  • 评分模式:快速扫描全部 57 个问题,仅输出结构化评分卡与筛选后的发现。

评分模式输出格式包含:WA Score 总览、各支柱评分与严重性计数表、发现表(编号、支柱、严重性、发现、证据)、总结。

覆盖策略采用三层参考语料:

  • references/manifest.md(约 24 KB):全部 BP ID 与一行标题的轻量目录,完整评审时首先加载。
  • references/pillars/{pillar-slug}.md(6 个文件,每个约 150–580 KB):按支柱合并的参考,含全部问题与完整 BP 内容。
  • references/pillar-playbooks/{pillar}.md(6 个文件,每个约 3–5 KB):按支柱的领域特定证据收集指南。

完整评审的强制加载模式:先加载 manifest,再并行派发 6 个支柱子代理,每个子代理返回结构化 markdown 表格(列:BP ID | Status | Severity | Evidence | Recommendation),每行对应一条 BP。

适用场景

  • 需要对 AWS 工作负载进行完整 Well-Architected 评审。
  • 需要快速了解架构在各支柱上的整体状况。
  • 需要针对特定支柱(如安全、可靠性、成本)进行深入评审。
  • 需要获得评分卡与优先发现列表。

限制

  • 当没有代码或 IaC 可分析时,基于用户提供的架构描述进行评审,将省略的细节视为未知而非控制缺失,无法验证的实现细节标记为“无法确定”。
  • 证据充分性门控要求:仅当有明确证据证明控制缺失,或已检查权威且足够完整的来源而控制未出现时,才记为“未实现”。
  • 完整评审必须评估全部 307 个 BP;若 BP 引用少于 200 条,则评审未完成。
  • 检查点要求:在用户明确确认前不得进入评估阶段。
  • 评分模式仅输出评分卡与筛选后的发现,不输出完整叙述报告。
  • 关于收费、价格、平台支持等具体信息,资料中暂未提供。