Husky 提交钩子配置

为什么需要 Pre-Commit Hooks

在多人协作或高频提交的仓库中，常见的痛点是「格式化代码忘了跑」或「类型报错没看见就推上去」。靠 CI 拦截虽然可行，但反馈链路太长。更直接的做法是在 git commit 执行前，本地先跑一遍校验，把低级错误拦在进入 Git 历史之前。

核心能力与工作流

该技能扮演工程配置助手的角色，专注于在当前仓库落地一套基于 Husky + lint-staged + Prettier 的预提交体系，不涉及业务逻辑改动。

核心能力：

• 提交前自动格式化暂存文件
• 提交前自动执行类型检查与测试
• 自动识别包管理器与初始化配置

关键步骤：

• 通过锁文件识别项目使用的包管理器（如 package-lock.json 或 pnpm-lock.yaml），不明则默认 npm
• 在 devDependencies 中安装所需依赖
• 运行 npx husky init 初始化 .husky/ 目录并配置 prepare 脚本
• 编写 .husky/pre-commit，调用 lint-staged 及项目的 typecheck/test 脚本（Husky v9+ 不再需要 shebang）
• 配置 .lintstagedrc 对所有暂存文件执行 prettier --ignore-unknown --write
• 如缺失 Prettier 配置，则生成一套通用默认规则
• 执行 npx lint-staged 验证配置有效性，并完成首次提交

适用边界与注意点

• 脚本缺失处理：如果仓库没有 typecheck 或 test 脚本，技能会自动省略对应行并给予提示，不强行添加空脚本
• 非 Node 项目：本技能基于 Node 生态，非 Node 项目需自行替换为等价工具
• 职责限定：只负责配置钩子环境，不修改具体的业务代码逻辑