用途:将现有 CI/CD 配置迁移到 GitHub Actions,按固定流程执行,避免凭空生成工作流。
主要能力:五阶段流程——Phase 1 源文件(必须提供真实源文件,如 Jenkinsfile、azure-pipelines.yml、.circleci/config.yml、.gitlab-ci.yml、.travis.yml、bitbucket-pipelines.yml、bamboo-specs.yml、.drone.yml,否则拒绝继续);Phase 2 分析(结构、触发条件、执行器映射、凭据、缓存、制品、矩阵等);Phase 3 转换(仅转换源中已有内容,使用平台映射表,仅用已验证创建者的动作);Phase 4 校验(按 actionlint 技能安装并运行,解决全部问题并记录真实输出);Phase 5 文档(生成 .github/ci-archive/MIGRATION-README.md,归档并删除原文件,通过 PR 交付报告)。
安全护栏:禁止无源文件生成、禁止添加源中不存在的功能、禁止自写动作或脚本、禁止使用未验证或已弃用动作;动作须用最新稳定版并固定到提交 SHA,附 SHA 与版本对应注释,应用最小权限,记录所有密钥与变量。
动作版本验证:先查 pinned-actions.json 目录中的已验证 SHA;未覆盖时用 gh auth status 探测网络,可用则通过 gh api 解析最新发布标签与提交 SHA,不可用则停止并告知用户需解析的动作,不得猜测。
交付与归档:产出可运行的 .github/workflows/*.yml、密钥变量说明、转换注释、真实 actionlint 输出、归档后的源文件与完整 MIGRATION-README.md,并通过 PR 交付。归档使用 mkdir -p .github/ci-archive/ 后移动而非复制源文件,并确认原位置已清空。
限制:必须提供真实源文件;离线时无法解析未收录动作的 SHA;完成需满足 10 项清单,否则视为未完成。