repo-native-alignment: Skill for Claude Code

oh-ci

Fix CI failures on a pull request. Work in an isolated worktree, diagnose failures from check run logs, apply fixes, verify, and push.

Invocation

/oh-ci <pr-number>

• <pr-number> - the pull request number with failing CI

Prerequisites

• Repo context: Run from the repo root where the PR exists
• GitHub issue PR: The PR should be from an oh-task session (branch issue/<number>)

Flow

1. Load project background from AGENTS.md, relevant .oh/ artifacts, and RNA MCP context when available.

2. Get PR branch info and create worktree:

   # Save original directory for cleanup
   ORIGINAL_DIR=$(pwd)
   
   # Get the PR branch name
   BRANCH=$(gh pr view <pr-number> --json headRefName -q .headRefName)
   
   # Fetch and create worktree tracking the remote branch
   git fetch origin
   git worktree add .worktrees/ci-<pr-number> -B $BRANCH origin/$BRANCH
   cd .worktrees/ci-<pr-number>
   

3. Fetch CI check run details and logs:

   # Get the head SHA
   HEAD_SHA=$(gh pr view <pr-number> --json headRefName,commits -q '.commits[-1].oid')
   
   # List all check runs for this commit
   gh api repos/{owner}/{repo}/commits/${HEAD_SHA}/check-runs --jq '.check_runs[] | select(.conclusion == "failure") | {name: .name, id: .id, conclusion: .conclusion}'
   
   # For each failed check run, inspect annotations separately
   gh api repos/{owner}/{repo}/check-runs/{check_run_id}/annotations
   
   # Resolve the failed workflow run non-interactively, then fetch its logs
   RUN_ID=$(gh run list --commit "$HEAD_SHA" --status failure --limit 1 --json databaseId --jq '.[0].databaseId')
   test -n "$RUN_ID"
   gh run view "$RUN_ID" --log-failed
   

4. Diagnose failures:

   • Parse the CI logs to identify the root cause
   • Common categories: type errors, test failures, lint violations, build errors
   • If multiple failures, identify if they share a root cause
   • Read the relevant source files to understand context

5. Fix the code:

   • Apply targeted fixes for each failure
   • Stage changes (git add)
   • Run the repo-local /review skill on staged changes
   • Handle review findings:
     • P1-P3 trivial: fix inline, re-stage
     • P1-P3 non-trivial: create GitHub issue as descendant
     • P4: discard