commitlisted

## 目标 完成一次干净的 git 提交：信息格式统一、语言与风格跟随本仓库、范围精确、带协作署名 ## 前置（动手前必做） 1. `git log --oneline -10` —— 看本仓库 commit 的**既有语言**（中 / 英）与风格，对齐而非自创 2. `git status --short` + `git diff --staged --stat` —— 核对将要提交的文件范围 3. 仅在**用户明确要求**时 commit / push；未要求则只给命令或先问 ## 提交信息格式（Conventional Commits） `<type>(<scope>): <subject>` - **type**：`feat`（新功能）/ `fix`（修 bug）/ `docs` / `style`（纯格式，不改逻辑）/ `refactor` / `perf` / `test` / `chore`（杂项 / 依赖）/ `build` / `ci` / `revert` - **scope**：可选、小写，标明影响模块，如 `fix(nvim):`、`feat(loader):` - **subject**：祈使句、简洁、≤ 50 字、结尾不加句号；语言**跟随仓库历史**（无历史则中文） ### 正文（改动稍大时才写） - 与 subject 空一行隔开 - 用 `-` 列点说明**做了什么 + 为什么**，why 优先，不复述 diff 一眼能看到的细节 - 行宽约 72 字符 ### Trailer - 关联 issue 用 `Closes #123` / `Refs #123` ## 范围与暂存纪律 - 只提交与本次任务相关的文件，**不擅自 `git add` 无关改动** - 用户说「提交」但暂存区为空 → 先确认要提交的文件集，再 `add` - 用户已自行暂存 → 默认只提交已暂存内容，不擅自补 add 其它文件 - 危险 / 不可逆 git 操作（`reset` / `rebase` / `push -f` / `clean` 等）一律先确认 ### 用户指定文件提交（pathspec 直提） 用户明确点名「只提交某几个改动 / 别动我的暂存区」时，用 **`git commit -- <路径…>`** 按路径直提， 取这些文件的**工作区版本**成一个 commit，**不碰 index 中其它已暂存内容**（也无需先 `git add`）： ```bash git commit -m "标题" -m "正文" -- 文件1 文件2 ``` - **选项必须写在 `--` 之前**：`--` 之后一律按路径解析，把 `-m`/`-F` 放到后面会报 `pathspec '-m' did not match any file(s)` - 长信息用 `-F -` 从 stdin 读，避免 heredoc 与 pathspec 混在一起： ```bash git commit -F - -- 文件1 文件2 <<'EOF' fix(scope): 标题 - 说明 EOF ``` - 适用：用户已有一批无关暂存改动，只想把本次任务的文件单独拎出来提交 ## 分支 - 跟随仓库习惯：线性 `main` 历史的本地 ## 执行步骤 1. 前置检查（`git log` / `status` / `diff`） 2. 归纳改动 → 选 type / scope → 写 subject（