| name | devtools-ci |
| description | Triage and analyze Chromium/DevTools LUCI build results and trybot failures, including high-level builder status, compile errors, and detailed test failures. Use this to inspect trybot buildbucket (bb) results for a patchset overview or to query ResultDB directly for comprehensive, actionable information about specific test regressions and infrastructure issues. |
LUCI Build Triage & Analysis
This skill provides access to specialized triage tools maintained within the
depot_tools repository. These tools are used to inspect Buildbucket results
and ResultDB test failures.
Environment & Auth Discovery
- Environment: Always execute these scripts using
vpython3 instead
of python3 to ensure all hermetic dependencies (like httplib2) are
satisfied.
- Authentication: Use
bb auth-info to proactively check if you are
logged into Buildbucket. If not, inform the user they must run bb auth-login.
Locating the Tools
The triage scripts and their detailed documentation are located relative to
the depot_tools installation:
- Locate Depot Tools: Run
which gerrit_client.py to find your local
depot_tools root.
- Navigation:
- Buildbucket (
bb_wrapper.py): Found in <DEPOT_TOOLS_ROOT>/agents/skills/buildbucket/
- Strengths: High-level Build info (is it failing? what steps failed?),
compile errors, and infra issues.
- Test Results (
luci_triage.py): Found in <DEPOT_TOOLS_ROOT>/agents/skills/luci-test-results/
- Strengths: Detailed Test info (specific test case failures in
ResultDB).
Troubleshooting
- "No Artifacts Found": This usually occurs if:
- The build failed so early (e.g., bot setup) that no artifacts were produced.
- The build is too old and logs have been purged.
- There is an authentication issue.
- Fallback: Try
bb log <build_id> <step_name> to see the raw output
for the failed step.
Available Skills in Depot Tools
Once you have located the depot_tools directory, read the following files
to understand how to use each tool:
buildbucket: Used for high-level builder status and compile failures.
- Read:
<DEPOT_TOOLS_ROOT>/agents/skills/buildbucket/SKILL.md
luci-test-results: Used for detailed ResultDB test failure analysis.
- Read:
<DEPOT_TOOLS_ROOT>/agents/skills/luci-test-results/SKILL.md
Usage at Runtime
When you need to triage a build:
- Locate
depot_tools as described above.
- Read the relevant
SKILL.md file from depot_tools.
- Follow the instructions in that file to execute the Python scripts (e.g.,
bb_wrapper.py or luci_triage.py) using their absolute paths.
