configure-pre-commit（配置预提交）

/configure:pre-commit

Check and configure pre-commit hooks against project standards.

When to Use This Skill

Context

• Pre-commit config:!find. -maxdepth 1 -name \'.pre-commit-config.yaml\'
• Project standards:!find. -maxdepth 1 -name \'.project-standards.yaml\'
• Project type in standards:!grep -m1 "^project_type:".project-standards.yaml
• Has terraform:!find. -maxdepth 2 \(-name '*.tf' -o -type d -name 'terraform' \) -print -quit
• Has helm:!find. -maxdepth 2 -type d -name 'helm' -print -quit
• Has package.json:!find. -maxdepth 1 -name \'package.json\'
• Has pyproject.toml:!find. -maxdepth 1 -name \'pyproject.toml\'

Parameters

Parse from $ARGUMENTS:

• --check-only: Report status without offering fixes
• --fix: Apply all fixes automatically without prompting
• --type <type>: Override project type detection (frontend, infrastructure, python)

Execution

Execute this pre-commit compliance check:

Step 1: Detect project type

1. Read .project-standards.yaml for project_type field if it exists
2. If not found, auto-detect:

- infrastructure: Has terraform/, helm/, argocd/, or *.tf files - frontend: Has package.json with vue/react dependencies - python: Has pyproject.toml or requirements.txt

1. Apply --type flag override if provided

Step 2: Check configuration file

1. If .pre-commit-config.yaml is missing: report FAIL, offer to create from template
2. If it exists: read and parse the configuration

Step 3: Verify hook versions against latest releases

CRITICAL: Before flagging outdated hooks, verify latest releases using WebSearch or WebFetch:

1. pre-commit-hooks: GitHub releases
2. conventional-pre-commit: GitHub releases
3. biome: GitHub releases
4. ruff-pre-commit: GitHub releases
5. gitleaks: GitHub releases

Step 4: Analyze compliance

Compare existing configuration against project standards (from pre-commit-standards skill):

Required Base Hooks (All Projects):

• pre-commit-hooks v5.0.0+ with: trailing-whitespace, end-of-file-fixer, check-yaml, check-json, check-merge-conflict, check-added-large-files
• conventional-pre-commit v4.3.0+ with commit-msg stage

Frontend-specific:

• biome (pre-commit) v0.4.0+
• helmlint (if helm/ directory exists)

Infrastructure-specific:

• tflint, helmlint (gruntwork v0.1.29+)
• actionlint v1.7.7+
• helm-docs v1.14.2+
• gitleaks v8.22.1+

Python-specific:

• ruff-pre-commit v0.8.4+ (ruff, ruff-format)
• gitleaks v8.22.1+

Step 5: Generate compliance report

Print a report in this format:

Pre-commit Compliance Report
================================
Project Type: [type] ([detected|override])
Config File: .pre-commit-config.yaml ([found|missing])

Hook Status:
  [hook-name]     [version]   [PASS|WARN|FAIL] ([details])

Outdated Hooks:
  - [hook]: [current] -> [standard]

Overall: [N] issues found

Step 6: Apply fixes (if requested)

If --fix flag is set or user confirms:

1. Missing config file: Create from standard template for detected project type
2. Missing hooks: Add required hooks with standard versions
3. Outdated versions: Update rev: values to standard versions
4. Missing hook types: Add default_install_hook_types with pre-commit and commit-msg

After modification, run pre-commit install --install-hooks to install hooks.

Step 7: Update standards tracking

Update or create .project-standards.yaml:

standards_version: "2025.1"
project_type: "[detected]"
last_configured: "[timestamp]"
components:
  pre-commit: "2025.1"

Agentic Optimizations

Flags

Error Handling

• No git repository: Warn but continue (pre-commit still useful)
• Invalid YAML: Report parse error, offer to replace with template
• Unknown hook repos: Skip (do not remove custom hooks)
• Permission errors: Report and suggest manual fix

See Also

• /configure:all - Run all compliance checks
• /configure:status - Quick compliance overview
• pre-commit-standards skill - Standard definitions