用途:按规范完成 git 提交,使提交易于审查、可安全发布。仅包含预期改动,提交按逻辑范围划分,必要时拆分;提交信息需说明改了什么和为什么,正文必须为项目符号列表,不能写成段落。需先询问:单次还是多次提交(不确定且改动无关时默认拆分为多个小提交)、提交风格(要求使用 Conventional Commits)、是否有最长主题长度或必需 scope 等规则。
工作流程:提交前用 git status、git diff 检查工作区,改动多时用 git diff --stat;按功能与重构、前后端、格式与逻辑、测试与生产代码、依赖升级与行为变更等划分提交边界,同一文件混有改动时用补丁暂存;用 git add -p 仅暂存属于本次提交的内容,撤销暂存可用 git restore --staged -p 或 git restore --staged <path>;用 git diff --cached 复查暂存内容,确认无密钥、无调试日志、无无关格式变动。提交前用 1-2 句话描述改动(什么+为什么),写不清楚说明提交过大或过杂。提交信息格式:type(scope): short summary,空行后仅写项目符号正文,每条对应一个逻辑改动,说明意图而非文件名;不要在提交信息中添加 Co-authored-by: Cursor 等 trailer。多行信息建议用 git commit -v 在编辑器中编写,也可用 git commit -m "Subject line" -m "- Bullet one\n- Bullet two"。提交前运行项目格式化与 lint 命令(如 npm run format、prettier --write、ruff format、cargo fmt、npm run lint、ruff check、eslint、cargo clippy),并运行最小相关验证(单元测试或构建)。最后交付最终提交信息、每次提交的简短说明以及使用的暂存/复查命令(至少含 git diff --cached 和运行的测试)。具体命令示例与项目配置以实际环境为准;其余细节暂未提供。