chore: add ci-pr-helper skill

beinan · beinan · commit 0eba62218ea4 · 2026-01-17T01:57:24.000-08:00
diff --git a/.codex/skills/ci-pr-helper/SKILL.md b/.codex/skills/ci-pr-helper/SKILL.md
@@ -0,0 +1,51 @@
+---
+name: ci-pr-helper
+description: Run local test/style checks and open GitHub PRs for lance-context. Use when asked to run CI-equivalent checks (uv pytest, ruff/pyright, cargo fmt/clippy/test) and then create a PR with a proper title/body.
+---
+
+# CI PR Helper
+
+## Overview
+Run project checks locally, then prepare and open a PR with a clear title and summary.
+
+## Workflow
+
+1. Ensure you are on a feature branch (not `main`).
+2. Run local checks via the script in `scripts/`.
+3. Draft a PR title/body using the template below.
+4. If `gh` is available and authenticated, run `gh pr create` with the draft.
+
+## Local checks
+
+Run:
+
+```bash
+./.codex/skills/ci-pr-helper/scripts/run_ci_checks.sh
+```
+
+If it fails due to missing tools, install `uv`, `cargo`, or Python deps, then rerun.
+
+## PR creation
+
+Draft a conventional title (e.g., `feat:`/`fix:`/`ci:`) and use:
+
+```
+## Summary
+- ...
+
+## Testing
+- uv run pytest
+- cargo test --manifest-path rust/lance-context/Cargo.toml
+- cargo fmt --manifest-path rust/lance-context/Cargo.toml -- --check
+- cargo clippy --manifest-path rust/lance-context/Cargo.toml --all-targets -- -D warnings
+- ruff format --check python/
+- ruff check python/
+- pyright
+```
+
+If possible, run:
+
+```bash
+gh auth status
+gh pr create --title "<title>" --body "<body>"
+```
diff --git a/.codex/skills/ci-pr-helper/scripts/run_ci_checks.sh b/.codex/skills/ci-pr-helper/scripts/run_ci_checks.sh
@@ -0,0 +1,26 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+root="$(git rev-parse --show-toplevel)"
+
+if ! command -v uv >/dev/null 2>&1; then
+  echo "uv not found; install uv to run Python checks."
+  exit 1
+fi
+
+if ! command -v cargo >/dev/null 2>&1; then
+  echo "cargo not found; install Rust to run Rust checks."
+  exit 1
+fi
+
+cd "$root"
+
+cargo fmt --manifest-path rust/lance-context/Cargo.toml -- --check
+cargo clippy --manifest-path rust/lance-context/Cargo.toml --all-targets -- -D warnings
+cargo test --manifest-path rust/lance-context/Cargo.toml
+
+cd "$root/python"
+uv run pytest
+uv run ruff format --check python/
+uv run ruff check python/
+uv run pyright
