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

自定义

什么是 AWS 改造自定义？

AWS Transform custom 使用代理人工智能对软件、代码、库和框架进行大规模现代化改造，以减少技术债务。它可以处理各种场景，包括语言版本升级、API 和服务迁移、框架升级和迁移、代码重构以及特定于组织的转换。

通过持续学习，代理可以根据每次执行和开发人员反馈进行改进，无需专业的自动化专业知识即可提供高质量、可重复的转换。

关键功能

AWS 自定义转换提供以下功能：

变换模式

AWS Transform custom 支持多种转型模式，以满足您的现代化需求。根据所需更改的范围和性质，每种模式都有不同的复杂性特征。

操作方法 AWS 改造自定义作品

AWS Transform custom 通常用于转换多个代码库或模块的大型项目。团队通常遵循四个阶段的工作流程：

定义转换-向生成初始转换定义的代理提供自然语言提示、文档和代码示例。可以通过聊天或直接编辑来迭代完善此定义。使用 AWS管理的转换时，可以跳过此阶段。

P@@ ilot or Proof-of-Concept-在示例代码库上测试转换，并根据结果进行优化。此验证阶段有助于估算全面转型的成本和工作量。在此阶段，持续学习可以提高质量。

扩展执行-使用 CLI 设置自动批量执行，由开发人员查看和验证结果。使用 Web 应用程序监控进度并跟踪多个存储库之间的转换。

监控和审查-持续学习可自动提高转换质量。查看从前几次运行中提取的经验教训，确保它们符合质量标准，并将任何无用的内容存档。

了解主要 概念

本节介绍使用自定义 AWS 转换的关键概念。

转换定义

转换定义包含执行特定代码转换所需的指令和知识。它被表示为一项技能，包括：

AWS 在执行、检查或修改需要时，Transform CLI 会自动将转换定义下载到当前目录。

转换定义类别

转换定义可以有一个类别，说明它是如何使用的：

使用atx custom def publish或--category选项设置类别atx custom def save-draft：

atx custom def publish -n <transformation-name> --description "Description" --sd <directory> --category analysis
atx custom def publish -n <transformation-name> --description "Description" --sd <directory> --category remediation
atx custom def list    # The Category column shows each transformation definition's category

AWS 变换使用类别来决定可以在何处使用转换定义。

在提交自定义分析、计划或修正之前，Trans AWS form 会检查转换定义的类别。

要更改转换定义的类别，请使用不同的--category值重新发布它。如果您发布不带新版本的新版本--category，则新版本将保留先前版本的类别。

有关如何运行analysis转换定义，请参阅自定义分析。

编写用于分析的变换定义

要获得有用的发现，请编写转换定义，使其描述要查找的内容、如何对每个问题进行分类以及不该做什么。我们建议在中使用以下章节SKILL.md。

以下示例查找仍以 17 之前的 Java 版本为目标的 Java 项目。

---
name: java-version-detector
description: Report where a repository still targets a Java version earlier than 17, in build files, Dockerfiles, toolchain files, and CI workflows. Analysis only - no code is modified.
---

# Java Version Detector

Find where the repository targets a Java version earlier than Java 17. This is a
read-only analysis: report findings, and do not modify any files.

## Entry Criteria

The repository contains a Java build file (`pom.xml`, `build.gradle`,
`build.gradle.kts`, or `gradle.properties`), or a file that selects a JDK
(`.java-version`, `.tool-versions`, `.sdkmanrc`, a `Dockerfile`, or a file under
`.github/workflows/`).

## Scope

- Inspect build files, toolchain files, Dockerfiles, and CI workflow files.
- Skip build output (`build/`, `target/`) and vendored dependencies.

## What to Report

Report one finding for each place that selects a Java version earlier than 17:

1. A compile target, such as `maven.compiler.source`, `maven.compiler.release`,
   `java.version`, `sourceCompatibility`, or a Gradle toolchain `languageVersion`.
2. A Dockerfile base image that ships a JDK or JRE earlier than 17, such as
   `openjdk:8` or `amazoncorretto:11`.
3. A CI job or toolchain file that selects a JDK earlier than 17.

For each finding, include the file path, the line number, and the version you found.

## Categories

- `outdated-compile-target` - a build file compiles for an old Java version
- `outdated-runtime-image` - a Dockerfile uses an old JDK or JRE image
- `outdated-ci-jdk` - a CI workflow or toolchain file selects an old JDK

## Severity Criteria

- **high** - the project compiles for Java 8 or earlier
- **medium** - the project compiles for Java 9 through 16
- **low** - only the runtime image or CI uses an old JDK, and the compile target is 17 or later

## Exit Criteria

1. Every in-scope file has been inspected.
2. Every finding has a file path, line number, category, and severity from the lists above.
3. No file in the repository has been modified.
4. If nothing is found, state that the repository targets Java 17 or later.

当此转换定义针对其pom.xml集合的项目运行时<source>1.8</source>，它会在该outdated-compile-target类别中生成high严重性发现，并以此AWS/java-version-upgrade作为修复方法。

编写分析变换定义的技巧

在发布转换定义之前，在已知包含问题的存储库上对其进行测试。将其另存为草稿atx custom def save-draft，或使用在本地运行atx ct analysis run（参见自定义分析）。

转换注册表

转换注册表是您 AWS 账户的集中存储库，用于存储和管理转换定义。注册表中的转换可以是：

草稿与已发布的转换

AWS 自定义转换支持注册表中的两种转换状态：

草稿转换是正在进行或未经测试的转换定义。它们另存为特定版本，引用该特定版本的用户可以检索、更新和执行。在转换准备好与团队共享之前，草稿对于迭代开发、测试和完善非常有用。草稿还与特定的对话相关联。如果重新启动 CLI，则可以使用atx --conversation-id {id}恢复之前的 CLI。

已发布的转换可在您账户的转换注册表中找到，供具有所需 IAM 权限的其他用户执行。可以使用atx custom def list发现已发布的转换。

典型的工作流程是：

您也可以直接发布转换，而不必将其另存为草稿。

参考文献与教训

AWS 自定义转换使用两种类型的知识来提高转换质量：

参考文献是用户提供的文档，存储在转换定义的references/文件夹中。参考文献仅支持文本文件（所有文件的最大总容量为 10MB），通常包含文档、API 规范、迁移指南和代码示例。在转换执行期间，会根据需要加载引用。在交互模式下创建或更新转换定义时，可以添加引用。

课程是从之前的转换运行中自动提取的。持续学习系统根据执行轨迹、开发者反馈以及转换过程中遇到的代码修复生成它们。它将相关的课程分为几类，以便您可以一起复习。与您预先提供的参考不同，当您在不同的代码库中运行转换时，经验会随着时间的推移而累积，系统会自动应用这些经验来改进 future 的运行。您可以通过交互方式复习和管理课程。atx custom def learnings

生成和验证命令

生成或验证命令是一个可选参数，用于指定在转换过程中如何验证代码。为了确保代码的完整性，此命令在转换过程中的不同时刻执行。

提供一个命令来验证结果并在验证失败时返回问题，对于通过持续学习提高转换质量非常重要。如果不需要构建或验证，请在输入中省略。

有关示例和详细指导，请参阅 “工作流程” 部分中的生成和验证命令。

持续学习

持续学习是一种自动捕获每次转换执行中的反馈并随着时间的推移提高转换质量的系统。系统通过以下方式收集信息：

持续学习系统处理这些信息以创建经验教训，将其添加到转型定义中，从而改进 future 的转型。转换完成后，系统会自动运行学习过程，无需您额外输入。

管理课程

系统会自动生成课程，但您可以控制将哪些课程应用于 future 的运行。该atx custom def learnings命令会打开一个交互式终端会话，用于查看和整理转换所积累的经验教训。

在此会话中，您可以：

如需分步指导，请参阅 持续学习。

Client-Side 技能

Client-side 技能是在转换执行期间扩展代理的附加能力。与定义要执行什么转换的转换定义不同，客户端技能提供了辅助工具、脚本和指令，代理可以在任何转换过程中与其内置功能一起使用这些工具、脚本和指令。

Client-side 技能是从项目级和用户级目录中发现的。当技能强制执行特定于存储库的标准时，将技能放在项目级别，当这些标准适用于您的所有项目时，则将其置于用户级别。 Project-level 只有在提供了代码存储库路径时，技能才可用。有关详细的配置和用法，请参阅Client-Side 技能。

自定义转换命令简介

以下是一些可用于自定义转换的命令。命令的完整列表位于AWS 转换自定义转换命令参考中。