用途:该技能聚焦“任务到达构建机后,Worker 如何真正执行”,用于修改 Worker 启动和执行流程、处理任务领取、任务工厂与任务执行器,排查插件在 Worker 内部的下载、执行和回传问题,以及修改日志上报、环境变量、归档和 API 调用,优化 Worker 生命周期或执行稳定性。
主要能力与结构:Worker 是执行器,不是调度器,也不负责插件定义。任务执行、日志、变量、归档属于同一条运行链上的不同环节。技能按问题类型提供参考文档:生命周期与执行主链路见 reference/1-runtime-flow.md;插件执行、日志与制品见 reference/2-task-plugin-log-artifact.md;环境变量、API 与排查见 reference/3-env-api-debug.md。
使用方式:先判断问题属于契约层还是执行层。若现象是插件定义不对,应转向 pipeline-plugin-development;若任务根本没被派到该机器执行,应转向 dispatch-module-architecture 或 agent-module-architecture。
适用场景:修改 Worker 启动和执行流程、处理任务领取与执行器、排查插件下载执行回传、修改日志上报与环境变量、归档和 API 调用、优化生命周期与执行稳定性。
限制与不适用:不适用于仅开发插件本体或修改 task.json、仅修改 Agent 守护心跳与升级逻辑、仅修改 Dispatch 调度配额或队列策略、仅修改流水线模型定义。
关键规则与陷阱:Worker 主职责是执行,不做资源调度决策;执行链路改动需优先考虑幂等、失败恢复和日志可诊断性;避免把调度问题误判为 Worker 问题,避免只改执行逻辑而不同步变量、日志和结果回传,避免输出变量与日志混用,避免在任务工厂或执行器中堆过多分支。