用途:按 Conventional Commits 格式暂存并提交 Git 变更,适用于被要求 commit、创建提交或保存改动时。不负责推送或创建 PR,这些交给 gh 技能处理。
主要能力与流程:先并行运行 git status、git diff HEAD、git log --oneline -5;随后依次理解改动原因、按文件名精确暂存(禁止 git add -A 或 git add .)、起草提交信息、通过 heredoc 提交、用 git status 验证。提交信息格式为 type(scope): short description(≤72 字符),必要时可加正文,类型包括 feat、fix、refactor、chore、docs、test、style,重点写“为什么”而非“改了什么”。Co-Authored-By 尾注可选,按运行环境提供的代理身份填写,项目不需要时可省略。
规则与限制:除非明确要求,否则不 amend,应创建新提交;不使用 --no-verify 跳过钩子;不向 main/master 强制推送;不推送、不建 PR;钩子失败时修复问题、重新暂存并创建新提交而非 amend;不提交 .env、凭据或大型二进制文件,并提醒用户。
注意事项:含反引号或 $ 的 heredoc 提交信息需用单引号定界符(<<'EOF');prek 钩子失败意味着提交未发生,修复后应新建提交;暂存后 git diff HEAD 为空说明没有新增内容,应改用 git diff --cached 检查。