01
这个 skill 做什么
当 staged changes 已准备好但 commit 文案需要更精确时使用此 skill。它检查 staged status、staged stats 和 staged diff,再根据即将提交的真实行为推断正确的 Conventional Commit 类型和消息,不会修改仓库。
02
什么时候使用
- 信号从当前 staged 批次生成清晰的 subject 和 body。
- 信号检查 staged 工作是否混杂到不适合一个诚实的 commit。
- 信号让 commit 文案扎根于即将提交的内容,而不是分支名或意图。
03
如何工作
- 01
检查 `git status --short`、`git diff --cached --stat` 和 `git diff --cached`。
- 02
如果没有 staged 内容则停止,而不是退回去看 unstaged work。
- 03
根据 staged 行为推断 commit 类型,而不是只看分支名或意图。
- 04
起草 Conventional Commit subject 和 body,准确命名用户可见或结构性变化。
- 05
只返回消息文本,不运行 `git commit`。
04
你会得到什么
- 信号一份 Conventional Commit 消息建议。
- 信号当 staged 批次混杂或有误导性时给出警告。
- 信号不修改仓库。
05
重要边界
- 信号只检查 staged changes。
- 信号不要 stage 文件、读取 unstaged diff 或创建 commit。
- 信号不要发明 staged diff 中看不见的产品上下文。
06