// Use when the user wants help analyzing current repository changes, generating a Chinese Conventional Commits message, or committing current work safely.
| name | commit-helper |
| description | Use when the user wants help analyzing current repository changes, generating a Chinese Conventional Commits message, or committing current work safely. |
这个 skill 用于分析当前仓库工作区改动，生成中文 Conventional Commits 提交信息，并在改动主题单一时帮助完成自动提交。
核心原则：
git add -A 和 git commitgit push当用户表达以下意图时使用：
如果用户只想要提交信息建议而没有要求实际提交，可以生成信息但不执行 git commit。
先运行脚本：
.agents/skills/commit-helper/scripts/collect_commit_context.sh
该脚本只负责输出：
git status --short必要时，再补充读取关键 diff：
git diff -- <path>
git diff --cached -- <path>
出现以下情况时，必须停止自动提交：
停止时要明确说明原因，不得伪称已完成。
满足以下多数特征时，可视为单一主题：
以下情况通常判定为混杂改动：
如果是混杂改动：
git addgit commit格式：
<type>(<scope>): <中文描述>
要求：
type 使用英文 Conventional Commits 关键字scope 可选，但如果能识别模块，优先补上优先考虑的 type：
featfixrefactordocsstyletestchoreperfbuildci示例：
feat(blog): 新增博客精选文章展示区fix(auth): 修复后台登录态校验异常docs(skill): 新增提交助手技能设计文档只有在以下条件同时成立时才自动提交：
执行顺序固定为：
git add -A
git commit -m "<生成的提交信息>"
注意：
push如果成功提交，应输出：
如果未提交，应输出：
.gitignore 调整同时存在遇到以下情况，直接返回真实状态：
git add 失败git commit 失败不要说“已经提交”或“应该没问题”。必须以实际命令结果为准。