用途:这是一个 Git 提交工作流技能,目标是把请求范围内的改动按目的分组,生成多个语义清晰的提交。范围可由路径、目录、glob、文件名或主题(如“仅登录相关”)指定;未指定范围时以全部变更文件为对象。若指定范围内无匹配文件,则停止提交并报告,不会退化为全量提交。
主要能力:先用 git status --short、git diff --stat、git diff --cached --stat、git log --oneline -3 收集当前状态;仅分析目标文件(含未跟踪文件用 git diff --no-index -- /dev/null <新文件> 查看);按改动意图而非文件位置或扩展名分组,实现与其测试、文档同目的时归为一组,无关目的拆分为多组,一个文件只归一组。每组指定一个类型:feat、fix、docs、style、refactor、test、chore。全量单一目的时只生成一个提交,不强行拆分。
使用方式:范围确定前不暂存任何内容;对每组先 git add -- <该组未暂存文件>,再 git commit -m "..." -- <该组全部路径>(pathspec 提交只提交指定路径)。已全部暂存的组可跳过 add。不使用 git add .、git add -A、git commit -a 等无路径命令。提交信息格式为 <type>(<scope>): <subject>,必须用韩文书写,动词用命令式现在时,subject 在 50 字内且末尾无句号,必要时用 body 补充。禁止在提交信息中加入 Co-Authored-By 或 Generated with 等生成工具署名。为防止韩文乱码,macOS/Linux 用 HEREDOC 方式 git commit -m "$(cat <<'EOF' ... EOF )" -- <路径>;Windows PowerShell 用 chcp 65001 配合 UTF-8 临时文件 git commit -F commit_msg.txt -- <组文件> 后删除该文件。最后用 git log --oneline 与 git status --short 验证,确认范围外改动仍保留,并报告已建提交与未提交文件清单。
适用场景:需要在一次会话中把混杂改动整理成按目的分类的多次提交、并保持范围隔离的仓库。
限制:依赖本地 Git 与终端环境;韩文提交信息在部分终端可能乱码需按上述方式规避;具体安装或调用方式、支持平台等资料未提供。