用途:规划提交策略并判断何时提交,通过小而聚焦的提交讲述开发过程。主要能力:倡导“早提交、勤提交”;强调原子提交,即一次提交只代表一个逻辑变更(一个新功能、一个 bug 修复、一次重构、一次文档更新);把提交组织成故事线,分为搭建、开发、优化、打磨四阶段;提供提交信息前缀约定:feat、fix、refactor、test、docs、style、perf、chore;列出应提交与不应提交的情形。使用方式:完成一个逻辑单元、测试通过、即将切换任务或休息、重构后、修复 bug 后、新增文件或模块、更新文档、到达稳定检查点时提交;代码无法编译、测试失败、混入无关改动、存在调试代码或临时注释、包含密钥或敏感数据时不要提交。可在功能分支上做小提交,合并时保留清晰历史;也建议用交互式 rebase 在推送前清理本地提交,将 wip、fix、typo 等合并或改写为逻辑提交,常用命令有 git rebase -i origin/main、git log origin/main..HEAD --oneline、git reset HEAD^、git add -p、git rebase --continue,出错时用 git rebase --abort 或 git reflog 恢复。限制:仅可清理尚未推送的本地提交;已推送到共享分支或他人已基于其分支工作的提交不应 rebase,除非确定是个人分支;rebase 后需重新运行测试。资料未提供该技能的安装方式、收费与平台支持等信息。
git-storytelling-commit-strategy
通用与其它
更新于 10-16 03:04