---
name: commit-msg
description: 分析当前 Git 工作区或暂存区的真实变更，生成一个或多个 Conventional Commit 提交信息及对应文件范围。适用于提交前整理信息；暂存、提交、推送或修改仓库不应由本 Skill 执行。
---

# 生成提交信息

只读检查 Git 变更，给出可复核的 Conventional Commit 建议。不得执行 `git add`、`git commit`、`git push` 或其他会改变仓库状态的命令。

## 收集变更

1. 运行 `git status --short --branch` 确认仓库、分支以及 staged、unstaged、untracked 状态。
2. 分别运行 `git diff --cached --name-status` 和 `git diff --name-status`，不要把两类变更混为同一范围。
3. 先根据文件名识别敏感路径，例如 `.env`、凭据、令牌、私钥和本地配置。对这些路径只报告风险，不读取或回显差异内容。
4. 对其余相关路径分别读取 staged 或 unstaged diff。差异很大时先看 `--stat`，再按逻辑模块分段检查。
5. 未跟踪文件默认不纳入建议范围；只有用户明确要求评估时，才读取已确认且不敏感的文件。

## 形成建议

- 依据变更意图选择 `feat`、`fix`、`refactor`、`docs`、`test`、`build`、`ci`、`chore`、`perf`、`style` 或 `revert`。
- `scope` 只有在能从模块或职责明确判断时才使用；不能确定时省略，不从来源目录机械截取。
- 描述应简洁说明本组变更实现的结果，使用用户或仓库约定的语言。
- 互相依赖、共同完成一个目的的文件可归为一组；目的、模块或风险不同的变更应建议拆分。
- staged 与 unstaged 都存在时，明确标注每条建议基于哪一种状态。
- 不把敏感文件、未确认的未跟踪文件或明显无关的改动列入建议范围。

## 输出格式

对每个逻辑分组给出：

1. 建议提交信息：`<type>(<scope>): <description>`，无明确 scope 时省略括号。
2. 建议范围：列出对应文件，并注明 staged 或 unstaged。
3. 排除项：列出未纳入的未跟踪、敏感或无关文件。
4. 风险提示：说明混合状态、潜在凭据、二进制文件或尚未检查的内容。

若没有变更，直接说明无需生成提交信息。若证据不足以判断意图，先说明缺口并请求用户补充，不根据文件名编造业务目的。