investigate-build-failure

v2026.06.03

Investigate why a OneDev build failed or misbehaved by reading its metadata, log, referenced files, and recent changes via the `tod` CLI. Use when the user asks to debug, diagnose, or triage a failing or suspicious OneDev build.

GitHub
Install command
npx skhub add theonedev/investigate-build-failure
Markdown
SKILL.md

Investigate OneDev build failure

This skill walks the agent through a systematic investigation of a failing OneDev build using the tod build subcommands.

Prerequisites

  • tod is installed and on PATH with a configured tod config file (run tod config set if needed).
  • The current working directory is inside a git repository pointing at the OneDev project that owns the build (or the build uses a reference that includes the project, e.g. 42, myproject#42)

Workflow

Given a <build-reference> (e.g. 789, #789, myproject#789, or PROJ-789):

  1. Get build metadata — overall status, job name, commit, trigger:
    tod build get <build-reference>
    
  2. Get the build log — scan for errors and the exact failing step:
    tod build get-log <build-reference>
    
  3. Inspect referenced files — for any file mentioned in the log, fetch the exact version used by the build:
    tod build get-file-content <build-reference> <path>
    
    Always start with the build spec if there is any doubt about configuration:
    tod build get-file-content <build-reference> .onedev-buildspec.yml
    
  4. Look at recent changes — compare the failing build's commit against the previous successful similar build to see what changed:
    tod build get-changes-since-success <build-reference>
    
  5. Form a hypothesis — combine the log output, the referenced source, and the recent diff to identify the likely cause. Call out specific lines in the log and specific hunks in the diff when explaining the failure.

Tips

  • If the log is very long, scan it from the bottom up — the first error message is usually the highest-signal clue.
  • Compare the failing job definition in .onedev-buildspec.yml (from step 3) with any recent changes to that file (step 4) — spec regressions are a common cause of sudden failures.
Discovery
Tags

No tags published for this skill.

Version
Latest version metadata

Version

v2026.06.03

Published

Jun 3, 2026

Category

Uncategorized

License

MIT

Source path

skills/investigate-build-failure

Default branch

main

Latest commit

eea5808

Tree SHA

713478a