prek 集成实战指南Docker 容器镜像与 Coding Agent 技能安装【免费下载链接】prek⚡ A fast Git hook manager written in Rust, designed as a drop-in alternative to pre-commit, reimagined.项目地址: https://gitcode.com/GitHub_Trending/pr/prek本文以 prek 官方集成文档 docs/integrations.md 为核心系统讲解在容器镜像与 Coding Agent 场景下使用 prek 的完整方案如何选择与拉取ghcr.io/j178/prek的各版本镜像、如何在自己的镜像中复用 prek 二进制、如何用 GitHub Attestations 验证镜像来源以及如何通过gh skill为 AI Agent 安装prek技能。读完本文你将能够在任何 CI/CD 容器环境中可靠地交付、运行与校验 prek并让代码助手原生掌握 prek 的使用方式。一、集成全景容器与 Agent 两大入口prek 是一个用 Rust 编写、与pre-commit配置完全兼容的快速 Git 钩子管理器发布为单个无运行时依赖的二进制文件。这种单二进制 零依赖的形态让它非常适合容器化交付——官方为此专门维护了一套 Docker 镜像同时为了让编码 Agent 能直接上手配置与运行钩子prek 还提供了官方的 Agent 技能skill通过 GitHub CLI 一条命令即可安装。集成文档明确指出容器镜像与 Agent 场景之外的CI/CD 工作流集成请参考 Continuous Integrationdocs/ci.md那里覆盖 GitHub Actions、prek run --all-files、revision range 检查、缓存与凭据管理等内容。也就是说docs/integrations.md聚焦的是把 prek 装进镜像和让 Agent 学会用它这两件事本文也严格围绕这两条主线展开。二、Docker 集成官方镜像与标签体系prek 将容器镜像发布在ghcr.io/j178/prek命名空间下通过docker pull ghcr.io/j178/prek:tag拉取。镜像分为两种基础变体标签规则如下| 标签 | 基础镜像 | 包含内容 | | -- | -- | -- | |X.Y.Z、X.Y、latest|scratch| 仅prek二进制 | |X.Y.Z-alpine、X.Y-alpine、alpine| 当前受支持的 Alpine 发行版 |prek、Git、CA 证书 | |X.Y.Z-alpine3.24、X.Y-alpine3.24、alpine3.24|alpine:3.24| 固定版本的 Alpine 变体 |几点需要特别留意镜像标签的版本前缀变更0.4.10之前的 Docker 镜像标签带前导v例如ghcr.io/j178/prek:v0.4.9而 Alpine 变体从0.4.10起才可用。也就是说老版本请使用vX.Y.Z形式新版本请使用X.Y.Z形式。滚动标签 vs 固定标签latest、alpine这类滚动标签会跟随最新版本变化适合快速试用生产环境建议按下文版本固定建议一节使用精确版本或镜像 digest。2.1 Minimalscratch镜像单二进制交付scratch是 Docker 提供的最小空镜像基础意味着该变体没有 shell、没有包管理器仅包含位于容器内/prek路径的 prek 二进制。这种镜像适合作为软件源复用最常见的模式是把二进制 COPY 进你自己的基础镜像FROM debian:bookworm-slim COPY --fromghcr.io/j178/prek:0.5.3 /prek /usr/local/bin/prekCOPY 完成之后prek就出现在目标镜像的PATH中可以直接作为任意镜像的组件使用。如果你偏好直接运行 distroless 风格镜像也可以不加任何改造直接执行docker run --rm ghcr.io/j178/prek:0.5.3 --version从仓库根目录的 Dockerfile 可以看出 scratch 镜像的实际构建方式多阶段构建中先以 Ubuntu uv rustup musl 目标交叉编译出静态二进制/prek最后阶段FROM scratch、COPY --frombuild /prek /并设置WORKDIR /io、ENTRYPOINT [/prek]。这正是单二进制、无运行时依赖承诺的容器化落地——静态链接的 musl 二进制可以在绝大多数 Linux 发行版上直接运行。2.2 Alpine 变体自带 Git 与证书的完整环境Alpine 变体在 scratch 基础上叠加了运行钩子所需的基础设施prek、Git、CA 证书外加 shell 和 Alpine 包管理器。这意味着你可以在容器内直接运行依赖 Git 命令或需要 shell 的钩子例如pre-commit-hooks系列中的可执行性检查、自定义 shell 钩子等。docker run --rm ghcr.io/j178/prek:0.5.3-alpine --version构建流程见 .github/workflows/build-docker.yml 的docker-publish-alpine作业会动态生成 Alpine Dockerfile以alpine:3.24为基底apk add --no-cache ca-certificates git安装 Git 与证书并执行git config --system --add safe.directory /io将默认工作目录/io标记为 Git 安全目录避免容器内运行 Git 命令时的 dubious ownership 报错随后把 prek 二进制复制到/usr/local/bin/prek作为入口。2.3 版本固定建议集成文档给出的两种固定方式各有侧重同时固定 prek 与 Alpine 版本使用X.Y.Z-alpine3.24这样的标签例如ghcr.io/j178/prek:0.5.3-alpine3.24两个维度都确定可复现性最强只固定 Alpine 版本、跟随 prek 最新版使用alpine3.24这样的标签它固定了基础系统、prek 本体跟随最新发布无数字后缀的标签如X.Y.Z-alpine、alpine使用的是当前受支持的 Alpine 发行版Alpine 大版本升级时内容会随之变化。结合仓库的实际发布流程.github/workflows/build-docker.yml 中通过docker/metadata-action同时生成{{ raw }}、{{ major }}.{{ minor }}及alpine{{ version }}等标签可以确认这套标签矩阵由 CI 自动维护多架构linux/amd64、linux/arm64同步推送并附带provenance: modemax、SBOM 与工件签名。三、镜像验证用 GitHub Attestations 确认来源所有 Docker 镜像变体都使用 GitHub Artifact Attestations 签名用于证明镜像由 prek 官方工作流构建、未经篡改。验证命令如下$ gh attestation verify --owner j178 oci://ghcr.io/j178/prek:latest Loaded digest sha256:xxxx... for oci://ghcr.io/j178/prek:latest Loaded 1 attestation from GitHub API ✓ Verification succeeded! - Attestation #1 - Build repo:..... j178/prek - Build workflow:. .github/workflows/build-docker.ymlrefs/tags/vX.Y.Z验证输出会显示加载的镜像 digest、来自 GitHub API 的 attestation 数量以及构建该镜像的仓库与工作流引用build-docker.ymlrefs/tags/vX.Y.Z。从构建侧看.github/workflows/build-docker.yml 中actions/attest步骤会对subject-name为ghcr.io/j178/prek、subject-digest为实际构建 digest 的产物执行push-to-registry: true的签名并推送注册表从而支撑上述验证。官方文档特别提示!!! tip验证时优先使用具体版本标签如ghcr.io/j178/prek:0.5.3或镜像 digest而不是latest。因为滚动标签指向的内容会随时间变化使用精确引用才能让验证通过与实际运行内容严格对应——这与镜像拉取时的固定建议一脉相承。四、prek skill for agents让编码 Agent 学会使用 prek4.1 安装方式从v2.90.0起的 GitHub CLI 支持gh skill子命令安装官方prek技能只需一条命令gh skill install j178/prek prek该命令会从j178/prek仓库安装名为prek的 skill对应仓库内的 skills/prek/SKILL.md之后支持 skill 的编码 Agent 便可在对话中调用 prek 完成钩子的配置与运行。4.2 技能内容与 Agent 可获取的能力从 skills/prek/SKILL.md 的 frontmatter 可以看到该 skill 的触发条件是在任何仓库中设置或运行 prek 钩子其能力覆盖检查/格式化/校验代码与仓库文件、安装pre-commit、pre-push、commit-msg等 Git 钩子垫片、复用pre-commit生态的钩子、管理多语言运行时与工具链、校验配置、更新固定修订版本等。skill 内部还内置了配置指引推荐新项目使用prek.toml并给出 remote /local/meta/builtin四类 repo 的最小示例与 TOML 1.1 内联表注意事项过滤模式正则files \\.rs$、globfiles { glob src/**/*.rs }、glob 列表exclude { glob [target/**, dist/**] }调度模型priority数值越小越先执行、相同priority可并发以及顶层priorities别名机制默认工作流检查是否已有.pre-commit-config.yaml→ 迁移时prek install -f重装垫片 →prek validate-config校验 →prek install --prepare-hooks准备环境 →prek run --all-files全量执行命令速查prek run --dry-run、prek run --skip hook-or-project、prek run -vvv调试、PREK_NO_FAST_PATH1对比内置快路径等。这些内容保证了 Agent 在面对配置钩子、迁移 pre-commit 配置、调试钩子匹配等任务时能直接给出符合官方最佳实践的答案而不是依赖训练数据里的泛化知识。五、容器环境下的配套配置锦上添花在容器里运行 prek 时以下来自 docs/reference/environment-variables.md 的环境变量值得一并掌握它们能让 prek 在受限的容器环境中行为更可控PREK_HOMEprek 的数据目录缓存、工具链、钩子环境、日志默认位于~/.cache/prekLinux/macOS或%LOCALAPPDATA%\prekWindows。在容器中若需持久化缓存、或挂载共享缓存卷以加速环境准备应显式设置该变量CI 缓存策略的详细说明见 docs/ci.md。PREK_CONTAINER_RUNTIME当配置中使用language: docker/language: docker_image的钩子时可指定容器运行时为auto默认自动探测、docker、podman或containermacOS 的 Apple Container 运行时——也就是说prek 不仅能被打包进容器还能在容器内调度其他容器钩子。PREK_DOCKER_NO_INIT容器环境中若无法运行运行时的 init 帮助程序可设为1禁用--init标志这是兼容性逃生门禁用后 Ctrl-C 时容器可能不会正确退出。PREK_NO_CONCURRENCY/PREK_CONCURRENT_HOOKS/PREK_CONCURRENT_BATCHES在 CPU 受限的容器如小规格 CI runner中可禁用或限制钩子并发避免资源争抢。GITHUB_TOKEN、HTTP_PROXY等容器内访问私有钩子仓库或受控网络时prek 会继承这些外部变量帮助完成 Git 凭据与代理配置。六、小结一条可落地的集成清单围绕 docs/integrations.md可以把 prek 的集成实践浓缩为三步容器化按用途选镜像——只要二进制选ghcr.io/j178/prek:verscratch需要 Git/证书/shell 选-alpine或-alpine3.24变体自己构建镜像时用COPY --from复用/prek验证用gh attestation verify --owner j178 oci://ghcr.io/j178/prek:精确版本校验来源与完整性避免使用滚动标签带来的内容漂移Agent 化在支持gh skillv2.90.0的环境中执行gh skill install j178/prek prek让编码 Agent 获得配置、运行、调试 prek 钩子的官方能力。CI 流水线侧的 GitHub Actions 与 autofix.ci 自动化修复方案则请进一步阅读 docs/ci.md与本文的容器与 Agent 集成共同构成 prek 的完整交付矩阵。【免费下载链接】prek⚡ A fast Git hook manager written in Rust, designed as a drop-in alternative to pre-commit, reimagined.项目地址: https://gitcode.com/GitHub_Trending/pr/prek创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考