Commit Work 的目标是让提交易于审查且可安全发布:只包含预期变更、提交按逻辑拆分、提交信息说明改了什么以及为什么。适用场景包括日常提交、混合改动拆分、规范化提交信息。
使用前需确认:单次还是多次提交(若有不相关改动,默认拆成多个小提交);提交风格必须使用 Conventional Commits;是否有最大主题长度、必需 scope 等规则。
工作流程:先检查工作树,运行 git status、git diff,改动多时用 git diff --stat。再决定提交边界,按功能与重构、后端与前端、格式化与逻辑、测试与生产代码、依赖升级与行为变更等维度拆分;同一文件混合改动用补丁暂存,运行 git add -p;取消暂存用 git restore --staged -p 或 git restore --staged <path>。随后审查将提交的内容 git diff --cached,检查无密钥或令牌、无意外调试日志、无无关格式变动。先用一两句话描述暂存的改动(改了什么、为什么),若无法清楚描述,说明提交过大或混杂,需返回拆分。然后写提交信息,格式为 type(scope): short summary,空行后写正文(说明改什么与为什么,而非实现日记),必要时加 footer 如 BREAKING CHANGE;多行信息建议用 git commit -v。完成后运行最小相关验证(单元测试、lint 或构建)。重复直至工作树干净。
交付物包括最终提交信息、每个提交的简短说明(改了什么与为什么)以及用于暂存和审查的命令(至少 git diff --cached 及所运行的测试)。限制:资料未提供对平台、安装方式、定价或更多自动化能力的信息。