用途：本技能是 Woodpecker CI 的操作手册，覆盖服务器与代理配置、对接 Forgejo/Gitea 等 forge、编写工作流，以及从安装到生产故障排查的全过程。它只负责 Woodpecker CI 本身的配置与运行，不安装或管理 Forgejo/Gitea，也不配置 Forgejo Actions runner。
主要能力：按任务分流到对应参考文档，包括安装与后端选择（references/setup.md）、工作流 YAML 语法与事件条件（references/pipeline-syntax.md）、并行与缓存等高级模式（references/advanced-patterns.md）、密钥/升级/备份/指标等运维（references/operations.md）、故障排查与症状对照（references/troubleshooting.md、references/failure-signatures.md）、安全与信任边界（references/security.md）、CLI（references/cli.md）。附带模板 docker-compose.yml、woodpecker.yml、forgejo.env.example，清单与诊断脚本 scripts/woodpecker-doctor.py。
用法：生成共享密钥 openssl rand -hex 32；复制 compose 模板并 docker compose config --quiet、docker compose up -d、docker compose ps、docker compose logs -f --tail=100 woodpecker-server woodpecker-agent；本地检查用 woodpecker-cli lint .woodpecker.yml 与 woodpecker-cli exec .woodpecker.yml；诊断用 python3 scripts/woodpecker-doctor.py --url https://ci.example.com --server agent-host:9000 --json。代理需 WOODPECKER_SERVER 与相同的 WOODPECKER_AGENT_SECRET。
适用场景：新部署、工作流编写、升级备份、CI 故障定位、多租户信任决策。
限制：技能不绑定具体版本，需按所装主版本核对版本敏感命令；doctor 探针只报连通性与配置信号，不代表 OAuth、调度或镜像拉取正常；不读取仓库级状态；lint/exec 不能替代服务器运行；docker compose config 或 lint 通过只证明语法有效。未提供具体收费与价格信息。