用途:为仓库提供统一的 pre-commit 钩子标准与配置规范(版本 2025.1),用于配置提交前钩子、检查钩子合规性,以及配合约定式提交(conventional commits)。
主要能力:给出标准钩子清单与固定版本,包括 pre-commit-hooks v6.0.0(trailing-whitespace、end-of-file-fixer、check-yaml、check-json、check-merge-conflict、check-added-large-files 等)、conventional-pre-commit v4.4.0(commit-msg 阶段校验提交信息)、biome v2.4.16(JS/TS/JSON 格式化与 lint)、gruntwork pre-commit v0.1.30(helmlint、tflint,仅基础设施)、actionlint v1.7.12、helm-docs v1.14.2、gitleaks v8.30.1(密钥扫描,推荐)。
按项目类型提供配置模板:前端应用(Vue/React)使用 pre-commit-hooks、conventional-pre-commit、biome,可选 helmlint;基础设施仓库(Terraform、Helm、ArgoCD)使用 pre-commit-hooks、conventional-pre-commit、tflint、helmlint、actionlint、helm-docs、gitleaks;Python 服务使用 pre-commit-hooks、conventional-pre-commit、ruff(--fix 与 ruff-format)、gitleaks。
合规检查:所有仓库必须包含基础钩子(pre-commit-hooks v6.0.0+ 的上述钩子,以及 commit-msg 阶段的 conventional-pre-commit v4.4.0+)。状态分为 PASS(存在且版本合规)、WARN(存在但版本过旧)、FAIL(缺少必需钩子)、SKIP(不适用于该项目类型)。版本比较规则:完全一致或更新为 PASS,仅补丁版本落后为 WARN,完全缺失为 FAIL。
排除模式:前端应用从 YAML/prettier 检查中排除 Kubernetes/Helm 模板,如 exclude: ^(helm/templates/|skaffold/|k8s/).*.ya?ml$;基础设施排除 ArgoCD 与 Helm 模板,如 exclude: argocd/.*templates/|helm/[^/]+/templates/;标准 Python 项目无需特殊排除。
使用方式:配置 .pre-commit-config.yaml 后执行 pre-commit install 与 pre-commit install --hook-type commit-msg,或直接 pre-commit install --install-hooks;更新全部钩子用 pre-commit autoupdate,再核对版本是否符合项目标准。
适用场景:需要统一提交前检查、审计或安装 pre-commit 钩子、校验 .pre-commit-config.yaml 是否符合标准、按项目类型选择钩子集合,或引用标准钩子版本与规则集。
限制:本技能侧重标准与合规检查;若需实际创建或修复 pre-commit 配置,应改用 configure-pre-commit。资料未提供收费、平台支持范围等更多信息。