用途：帮助把其他平台的 CI/CD 流水线迁移到 Woodpecker CI。Woodpecker 是 Docker 优先、社区驱动的 CI 引擎（源自 Drone 分支），每个步骤都在隔离容器中运行，因此没有 runner 或 agent 概念，而是为每个步骤指定镜像。
主要能力：讲解 .woodpecker.yml 结构，包括 steps、image、commands、settings、secrets、when、environment 等；支持单文件根目录配置或多文件 .woodpecker/ 目录（每个文件为一个工作流并行运行）；提供 GitHub Actions 与 Semaphore CI 的迁移对照表；支持 depends_on 构建 DAG、matrix 矩阵构建、services 链接容器、volumes 缓存、labels 选择 agent、clone 定制与全局 when 条件。
必要用法：每个步骤必须指定 image；commands 在容器内运行 shell 命令；settings 仅用于插件并转为 PLUGIN_* 环境变量；Woodpecker 默认自动克隆仓库，通常无需 checkout 步骤；多工作流间共享文件需借助存储插件；容器内引用运行时变量需写成 $${VAR}。可用 woodpecker-cli exec .woodpecker.yml 本地测试。
限制：GitHub Action 与 Woodpecker 插件不兼容，需找对应插件或改写为命令；environment 不能展开变量；资料未提供收费、价格或平台部署细节。