SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场aio2-review

aio2-review

部署与运维

查看项目

更新于 10-16 10:53

技能介绍

用途

AIO2（AI Operations & Optimization）多框架评审是一个面向 AWS GenAI 工作负载的评审编排技能，用于对照以下三类框架检查工作负载：

  • AWS Well-Architected GenAI Lens
  • NIST AI 风险管理框架（AI RMF）及 GenAI Profile
  • FinOps for AI

主要能力

技能支持三种评审范围：

  • Code Review：分析工作区代码，包括 IaC 模板、Lambda 处理器、系统提示、SDK 调用、测试与 CI/CD 配置，不调用 AWS 资源评估 API。
  • Cloud Review：查询实时 AWS 环境，包括已部署资源、IAM 策略、护栏、日志、网络与告警，不检查代码。
  • Full Review：同时覆盖代码与云环境。

框架可选择 AWS Well-Architected、NIST AI RMF、FinOps for AI，或全部三者。

使用方式

技能通过短语“aio2-review”“AIO2 review”或“AIO2”激活。执行流程为：先询问用户评审范围与目标框架并等待回答；云环境或全量评审时，继续选择 AWS CLI 配置文件和区域、收集云资源输入（Bedrock Agent ARN、CloudFormation 栈 ARN 或 Terraform 项目目录、AppRegistry 应用 ARN、Resource Group ARN 之一）、运行 discover-resources.sh 发现资源；代码或全量评审时，扫描工作区构建代码清单；然后拉取所选框架的检查定义并生成报告。

云优先规则要求：当 CLOUD_ACCESS = true 时，必须先完成配置文件/区域选择、云资源输入收集与资源发现，再开始代码清单或代码分析。

资源发现脚本会通过 sts get-caller-identity 验证 AWS 凭据，失败时以清晰错误退出；随后创建 aio2-data-<solution>-<date>/ 目录，写入原始 JSON（含 sts-get-caller-identity.json）、manifest.json 与 report.md 骨架，并在 stdout 末行输出数据目录路径。

下游支柱/框架脚本直接从 manifest.json 读取资源 ID，调用契约统一为：

${SKILL_ROOT}/scripts/<pillar-script>.sh \
  --region "$AWS_REGION" \
  --data-dir "$DATA_DIR" \
  [--profile "$AWS_PROFILE"]

安全与执行约束

该技能仅执行只读操作，所有 AWS CLI 命令均为只读（get-、list-、describe-），不创建、修改或删除资源；唯一写入的是评审数据目录 aio2-data-/ 下的原始 JSON、摘要文件以及 report.md 和 report.html。

代理被定位为工作流执行器而非脚本作者：允许调用 ${SKILL_ROOT}/scripts/ 中列出的脚本及其文档化参数、用 IDE 文件读取工具读取 JSON/YAML/JSONL、在 $DATA_DIR/_work/ 下编写 JSONL 发现文件、使用 IDE 的 grep/搜索工具检查代码、仅按文档所示模式使用 jq；禁止自行组合 shell 管道或单行命令、禁止调用 python/node/perl/awk/sed 等解释器、禁止抑制脚本 stderr、禁止在文档未逐字展示的情况下用 &&、||、| 链接命令、禁止在调用脚本前更改工作目录、禁止传入未文档化的参数、禁止以未规定方式包装或并行化脚本调用、禁止直接运行 aws CLI 命令（所有 AWS 访问都经过支柱脚本或 dynamic-cli.sh）。

检查定义与报告结构

每个框架子技能文件包含权威检查 ID，必须只使用其中或 check-registry.json 定义的 check_id，不得自行编造。检查定义分两部分：check-registry.json 是每个 check_id 的结构化索引（框架归属、规范所有者、严重级别、AI Ops 支柱映射、默认适用性），不含规范问题文本；lens JSON 文件（generative-ai-lens.json、nist-ai-rmf-lens.json、finops-ai-lens.json）承载每个检查的规范标题、显示文本与文档 URL。渲染器生成报告时进行连接，代理只编写每条发现的 finding、remediation、reason 或 question 文本。

报告按 WA 支柱 → 子类别（lens 问题）分组，每个子类别在 report.md 和 report.html 中各成一段；段内按严重级别（CRITICAL → HIGH → MEDIUM → LOW）排序，同一严重级别内按状态（FAIL → PARTIAL → PENDING → PASS → N/A）排序，顶部摘要表链接到每个子类别详情段。

适用场景

适用于对部署在 AWS 上的 GenAI 工作负载进行跨框架的运营与优化评审，可覆盖仅代码、仅云环境或两者兼顾的场景。

限制

  • 所有操作只读，不会创建、修改或删除资源。
  • 云评审需要有效的 AWS 凭据；Terraform 场景需要有效的 AWS 凭据与已配置的 Terraform 后端（本地或远程）。
  • 代理执行受上述允许/禁止清单严格约束。
  • 关于具体检查项数量、各检查的详细内容、报告的完整字段、计费方式与价格、支持的平台范围等信息，资料中暂未提供完整说明。