devtools-ci

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:

1. Locate Depot Tools: Run which gerrit_client.py to find your local depot_tools root.
2. 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:
  1. The build failed so early (e.g., bot setup) that no artifacts were produced.
  2. The build is too old and logs have been purged.
  3. 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:

1. Locate depot_tools as described above.
2. Read the relevant SKILL.md file from depot_tools.
3. Follow the instructions in that file to execute the Python scripts (e.g., bb_wrapper.py or luci_triage.py) using their absolute paths.