Menú
Run every lint-class CI gate locally. Codex equivalent of the Claude /lint command.
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
Scaffold a new ADR in `docs/decisions/`. Codex equivalent of the Claude /adr-new command.
Enumerate the active Spring Voyage `area:*` taxonomy and the owning umbrella for each. Codex equivalent of the Claude /areas command.
Build all .NET projects and the Next.js portal. Codex equivalent of the Claude /build command.
Format the codebase. If $ARGUMENTS is provided, format only that target. Codex equivalent of the Claude /format command.
Run the OpenAPI contract drift check locally — mirrors CI's `openapi-drift` job. Codex equivalent of the Claude /openapi-diff command.
Draft or refresh the human-written release notes for a version in `docs/releases/`. Codex equivalent of the Claude /release-notes command.
| name | lint |
| description | Run every lint-class CI gate locally. Codex equivalent of the Claude /lint command. |
Codex equivalent of the Claude /lint command. Follow the same project workflow, using any provided user request as the command arguments.
Run every lint-class CI gate locally.
This skill mirrors the CI jobs that block merge for formatting / static-quality
reasons. CI failures on these gates are common because the .NET formatter
(dotnet format) and the web-side linters live in different toolchains and
"my change is small" doesn't excuse skipping any of them — dotnet format
catches trailing-newline / whitespace errors that no .NET unit test will surface.
The pre-push hook (eng/ci/ci-local.sh) runs these for you; you can also run
them by hand from the repository root. Each command must exit 0; fix and re-run
any that don't.
# .NET — formatting + whitespace + final-newline (CI: "Format check")
dotnet format SpringVoyage.slnx --verify-no-changes
# Web — ESLint, Knip dead-code, tsc typecheck (CI: "Lint web", "Dead-code check (knip)", "Typecheck web (tsc)")
npm run lint
npm --workspace=spring-voyage-dashboard run knip
npm --workspace=spring-voyage-dashboard run typecheck
# Python agents — ruff lint + format check (CI: "Lint Python agents")
# Run unconditionally; cheap (~10s) and CI runs it whenever any agents/ file changes.
# If ruff is not installed: pip install ruff (CI pins no version; takes the latest)
ruff check agents/spring-voyage-agent/
ruff check agents/spring-voyage-agent-sdk/
ruff format --check agents/spring-voyage-agent/
ruff format --check agents/spring-voyage-agent-sdk/
If dotnet format reports issues, fix them with:
dotnet format SpringVoyage.slnx
If ruff format --check reports issues, fix them with:
ruff format agents/spring-voyage-agent/ agents/spring-voyage-agent-sdk/
Re-run the --verify-no-changes / --check variants to confirm. ESLint auto-fix is npm run lint:fix.
Ruff version skew: CI installs ruff via pip install ruff (no pinned version) so the canonical format can drift across CI runs. If ruff format --check passes locally but CI disagrees, install the version CI is using into a temp venv (e.g. python3 -m venv /tmp/ruff && /tmp/ruff/bin/pip install ruff==<ci-version>) and re-run.
Other CI lint jobs that are NOT in this skill because they are narrowly scoped or run only when their files actually change — invoke explicitly when touching the relevant area:
Lint agent definitions — script in .github/workflows/ci.yml job
lint-agent-definitions (when editing agents/*/agent.yaml)Lint connector web submodules — eslint src/Cvoya.Spring.Connector.*$web
(already covered by npm run lint above on most setups)Lint docs (evergreen framing) — script under scripts/lint-docs.sh
(when editing docs/)OpenAPI contract drift — see the $openapi-diff skill (when editing
API endpoints or DTOs)EF Core model drift — see /ef-drift if it exists, or rebuild the
solution and check git status on Migrations/ (when editing entities)The $build and $test skills are separate; CI and the merge queue enforce them.