SuperAPI AI 工具集

cloud-native-readiness

部署与运维

查看项目

更新于 10-16 02:06

技能介绍

用途

cloud-native-readiness 是一个云原生就绪度评估技能,用于判断一个代码仓库是否适合进行云原生微服务部署。它通过三阶段工作流给出量化评分与后续建议,帮助在容器化之前识别无状态性、配置管理、扩展能力等方面的差距。

主要能力

阶段一:云原生就绪度评估

按六个维度评估,每个维度 0-2 分:

  • 无状态性:应用是否在本地存储状态(如内存中的会话、本地文件写入)。
  • 配置外置:配置是硬编码,还是由环境变量或配置文件驱动。
  • 水平扩展:多个实例能否无冲突地同时运行。
  • 启动/关闭:应用是否启动快,并能优雅处理 SIGTERM。
  • 可观测性:是否具备健康检查、结构化日志、指标。
  • 服务边界:是聚焦的单一服务,还是紧耦合的单体。

评分区间:

  • 10-12:优秀,完全具备云原生就绪条件。
  • 7-9:良好,做少量调整即可就绪。
  • 4-6:一般,容器化前需要一定重构。
  • 0-3:较差,需要大量返工,当前不建议容器化。

输出为结构化就绪报告,包含评分、发现与建议。

阶段二:已有制品检测

检查仓库中是否已存在:

  • Dockerfile / Dockerfile.*(多阶段、多服务)
  • docker-compose.yml / docker-compose.yaml / compose.yml
  • .dockerignore
  • DOCKER.md 或 Docker 相关文档
  • 容器镜像仓库引用(ghcr.io、docker.io、ECR、GCR、ACR)
  • Kubernetes 清单(k8s/、kubernetes/、deploy/、helm/、charts/)
  • 含 Docker 构建步骤的 CI/CD 流水线(.github/workflows/、.gitlab-ci.yml)

输出为已有 Docker/K8s 制品清单及其质量评估。

阶段三:路由决策

根据就绪度评分与制品存在情况决定下一步:

  • 评分 ≥ 7 且制品完整:报告现有配置,结束。
  • 评分 ≥ 7 且制品部分存在:报告缺口并建议改进,结束。
  • 评分 ≥ 7 且无制品:调用 dockerfile-skill 生成。
  • 评分 4-6:报告问题与修复步骤,可选继续调用 dockerfile-skill。
  • 评分 0-3:报告阻塞项,不调用 dockerfile-skill。

使用方式

命令形式:

  • /cloud-native-readiness:评估当前目录
  • /cloud-native-readiness <path>:评估指定路径
  • /cloud-native-readiness <github-url>:克隆并评估

调用时始终按顺序执行:读取并执行 modules/assess.md(就绪度评估)、modules/detect.md(已有 Docker 制品检测)、modules/route.md(决策路由)。

报告格式

最终输出使用固定格式,包含:摘要(项目名、评分 x/12、结论)、评估详情(优势、关注点、阻塞项)、各维度评分表、已有 Docker 制品清单、建议。

与 dockerfile-skill 的集成

当路由到 dockerfile-skill 时,会传递评估上下文:就绪报告结论影响 Dockerfile 生成决策;检测到的外部服务直接映射为 docker-compose.yml 服务;识别出的关注点成为 Dockerfile 注释或 DOCKER.md 注意事项;配置外置评估结果驱动 ENV/ARG 设置。交接时包含:检测到的语言/框架/包管理器、外部服务依赖、配置外置状态、特殊关注点(有状态组件、启动慢等)。

适用场景

  • 在容器化或微服务改造前,快速判断项目现状与差距。
  • 需要量化评分来向团队说明改造优先级。
  • 已有部分 Docker 制品,想评估其完整性与质量。
  • 作为 dockerfile-skill 的前置评估环节。

限制

  • 评分基于六个维度的主观判断,具体评分细则见 knowledge/criteria.md。
  • 评分 0-3 时不会自动生成容器化配置。
  • 具体支持的编程语言、框架范围暂未提供。
  • 安装方式与运行环境要求暂未提供。