JunhuaLiu1 目标
- 在当前 Git 仓库里完成一次可控的提交：检查变更 →（必要时）暂存 → 生成中文 commit message →
git commit→ 输出结果。 - 提交信息遵循 Conventional Commit 形式，subject 用中文：
feat: 完成注册功能。
工作流（按顺序执行）
1) 侦测变更
运行以下命令收集信息（不要臆测）：
git rev-parse --is-inside-work-treegit status --porcelain=v1git diff --statgit diff --cached --stat
2) 暂存策略（安全优先）
- 若存在 staged 变更：默认只提交 staged（使用
git diff --cached生成信息）。 - 若没有 staged 但工作区有变更：
- 若用户明确说“全部提交/提交所有/直接提交工作区变更”，执行
git add -A。 - 否则只问 1 个问题确认：是否执行
git add -A再提交（默认推荐确认后再做）。
- 若用户明确说“全部提交/提交所有/直接提交工作区变更”，执行
3) 生成提交信息（中文）
优先用脚本生成候选提交信息（基于 staged diff）：
python3 codex-skills/git-commit-auto/scripts/suggest_commit_message.py --cached
若希望一键执行（先暂存再提交），可用：
python3 codex-skills/git-commit-auto/scripts/auto_commit.py --stage auto --yes
若脚本无法给出清晰描述（例如“更新项目变更”过于笼统），只问 1 个问题让用户补一句中文摘要（例如“完成注册功能 / 修复播放页崩溃”），并保留脚本推断出的类型前缀（feat/fix 等）。
类型选择（启发式）
- 仅
docs/或*.md：docs - 仅测试相关（如
*_test.go、*.spec.ts、*.test.ts）：test - 仅配置/工程化（如
package.json、go.mod、CI 配置等）：chore - 无明确证据时默认：
feat - 用户明确“修复/bug/崩溃/异常”：
fix
Message 约束
- subject 使用半角冒号：
feat: ... - subject 尽量 ≤ 50 字符（太长时压缩）
- body 可选：列 3–8 条要点或主要文件（不要堆满 diff）
4) 提交
- 提交前输出变更概览（文件列表 + stat），避免“盲提交”
- 执行：
git commit -m "<subject>"（有 body 则用第二个-m） - 提交后校验：
git status --porcelain=v1
默认交互策略（尽量少问）
- 能自动推断就直接提交（用户明确“直接提交/commit -y/不用确认”时不再二次确认）。
- 不确定会不会把不该提交的内容带上时（比如 unstaged 很多、含敏感文件、或变更跨度过大）必须先确认。