task-debugger
调试和修复Taskcluster任务中的故障。当用户要求调试任务、修复失败任务或调查任务错误/故障时使用此技能。此技能使用Taskcluster CLI获取任务日志和定义,分析错误,并使用`taskgraph load-task --develop`在本地重现和调试问题。在涉及Taskcluster任务调试、任务故障或给定要调查的任务ID的任何请求时调用。
📖 中文导读:调试和修复Taskcluster任务中的故障。当用户要求调试任务、修复失败任务或调查任务错误/故障时使用此技能。此技能使用Taskcluster CLI获取任务日志和定义,分析错误,并使用`taskgraph load-task --develop`在本地重现和调试问题。在涉及Taskcluster任务调试、任务故障或给定要调查的任务ID的任何请求时调用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: task-debugger description: Debug and fix Taskcluster task failures
Setup
Taskcluster CLI:
taskcluster version # check if installed
export TASKCLUSTER_ROOT_URL=https://firefox-ci-tc.services.mozilla.com
If not installed: https://github.com/taskcluster/taskcluster/releases/latest/
Commands:
taskcluster task log <task-id>- Get logstaskcluster task def <task-id>- Get definition (optional)
Debug Process
- Extract task ID from message or URL
- Fetch logs:
taskcluster task log <task-id> - Analyze errors (tracebacks, test failures, build errors)
- If fix is obvious → apply it. Otherwise → reproduce locally:
- Docker-worker tasks:
taskgraph load-task --develop <task-id>(Firefox:./mach taskgraph, others: check virtualenv oruv run taskgraph) - Flags:
--interactive,--volume,--root,--image,--keep - Non-docker: extract command from task def and run locally
- Docker-worker tasks:
- For non-obvious issues: add debug statements → iterate → fix
- Verify fix using same reproduction method
- Clean up debug artifacts (don't re-verify after cleanup)
- Report: root cause, fix, verification, files changed