AgentSkillsCN

vi-prek

在仓库中设置并配置 prek（Rust 的预提交替代方案）：创建/更新 `.pre-commit-config.yaml`，安装/卸载 Git 钩子（`uvx prek install` / `uvx prek uninstall`），从 `pre-commit` 迁移，并添加最简 CI（例如 GitHub Actions）。当项目需要通过 prek 配置预提交风格的钩子时使用。

SKILL.md
--- frontmatter
name: vi-prek
description: "Set up and configure prek (Rust drop-in replacement for pre-commit) in repositories: create/update `.pre-commit-config.yaml`, install/uninstall git hooks (`uvx prek install` / `uvx prek uninstall`), migrate from `pre-commit`, and add minimal CI (e.g., GitHub Actions). Use when a project needs pre-commit-style hooks wired up via prek."

Prek Setup

Set up prek in a repo with minimal, reviewable changes.

Workflow

1) Identify the scenario

  • •Migration: repo already has .pre-commit-config.yaml / .pre-commit-config.yml.
  • •New setup: no pre-commit config yet.

2) Ensure prek is available

Always run prek via uvx (so commands look like uvx prek ...).

Verify with uvx prek --version. If uvx is missing, install uv first.

3) Create or keep the config

Prefer .pre-commit-config.yaml at the repo root.

If migrating, keep the existing config unchanged unless the user asks to modify hooks.

Optional generator: uvx prek sample-config -f .pre-commit-config.yaml.

4) Run hooks and wire into git

  • •Run locally: uvx prek run (staged files) or uvx prek run --all-files.
  • •If hooks auto-fix files, uvx prek may exit non-zero with “files were modified”. Stage/commit the fixes and re-run until clean.
  • •Install git hook: uvx prek install.
  • •Migration from pre-commit: run uvx prek install -f once to overwrite the existing hook.
  • •Undo: uvx prek uninstall.

5) Add minimal CI (GitHub Actions)

If the repo uses GitHub Actions, add a minimal workflow (see references/ci.md).

6) Monorepos (only if relevant)

Use workspace mode (see references/workspace.md).

7) Sanity checks

  • •Validate config(s): uvx prek validate-config.
  • •Keep diffs minimal and explicit; do not add extra hooks unless requested.

References (load only if needed)

  • •references/quickstart.md — Migration vs new setup checklist
  • •references/installation.md — Install/update/completions
  • •references/configuration.md — Config patterns + prek-only keys
  • •references/cli.md — Commands, flags, selectors
  • •references/workspace.md — Monorepos + workspace discovery
  • •references/ci.md — GitHub Actions + Docker usage
  • •references/languages.md — language / language_version / toolchains
  • •references/builtin.md — repo: builtin and fast path
  • •references/debugging.md — Verbose mode + log file
  • •references/faq.md — prek install --install-hooks explanation

Skill maintenance

  • •Validate this skill locally: uvx --from pyyaml python /Users/vi/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/vi-prek