用途:将全部未暂存与未跟踪的改动按逻辑关注点分组,每个关注点一个原子提交;单一关注点即一次提交。该技能不执行推送,推送属于 /ship 流程。
提交信息风格:匹配仓库 log 中既有提交模式;极度简洁,可牺牲语法换简短;聚焦“为什么”而非“做了什么”;使用祈使语气;仓库使用 Conventional Commits 时采用 feat/fix/refactor/docs/chore 加 scope。
工作流:查看完整 diff 与 status;从 log 分析近期提交风格;识别改动文件间的逻辑分组,常见分组包括功能或缺陷修复(实现同一件事的 src 文件)、对应测试、配置变更(package.json、tsconfig 等)、纯格式化改动、文档或 README 更新、资源变更(图片、字体、public 文件)。对每个分组:按文件名显式暂存(禁止 git add . 或 -A);编写符合仓库风格的提交信息;用 HEREDOC 格式提交;运行 git status 确认暂存区干净后再处理下一组。最后运行 git status 确认工作区干净。
分组规则:纯格式化改动(空白、引号、缩进)单独成一次提交,与逻辑改动分开;若同一文件同时含逻辑与格式化改动,则一并放入逻辑提交;测试与其被测代码可共用一次提交。
规则:绝不推送;绝不使用 git add . 或 -A,必须按名称显式暂存;除非被要求否则绝不 amend;绝不跳过钩子;绝不提交密钥。
错误处理:pre-commit 钩子失败时,修复问题、重新暂存并创建新提交(绝不使用 --amend);若不确定某文件如何分组,提交前先询问用户。
限制:资料未提供安装方式、平台支持、收费与价格等信息。