/commit - Git 提交

执行 Git 提交操作，遵循 Conventional Commits 规范。

提交流程

1. 检查状态
   └─ git status 查看变更文件
   └─ git diff 查看具体变更

2. 暂存文件
   └─ git add <files>

3. 生成提交信息
   └─ 分析变更内容
   └─ 选择合适的类型前缀
   └─ 编写简洁的描述

4. 执行提交
   └─ git commit -m "type: description"

Conventional Commits 规范

类型前缀

提交信息格式

<type>(<scope>): <subject>

[optional body]

[optional footer]

示例

# 简单提交
git commit -m "feat: 添加语音识别功能"

# 带范围的提交
git commit -m "fix(auth): 修复 token 过期处理"

# 带详细说明的提交
git commit -m "$(cat <<'EOF'
feat(audio): 实现实时音频处理

- 添加 AudioProcessor 类
- 支持 PCM 和 WAV 格式
- 集成 FunASR 进行识别

Closes #123
EOF
)"

禁止操作

• 禁止 git push --force
• 禁止 git reset --hard（已推送的提交）
• 禁止 git commit --amend（已推送的提交）
• 禁止 在 commit message 中添加 Co-Authored-By

最佳实践

1. 原子提交 - 每个提交只做一件事
2. 清晰描述 - 说明做了什么，而不是怎么做的
3. 及时提交 - 完成一个小功能就提交
4. 检查暂存 - 提交前确认暂存的文件正确

提交后下一步

提交完成后根据当前状态决定下一步：

在 /iterate 模式中：
  ├─ 还有待办任务 → 更新 progress.md → 执行下一任务
  ├─ 所有任务完成 → /cc-best:checkpoint 保存检查点
  └─ 上下文较长   → /cc-best:compact-context 压缩后继续

参考

• 完整 Git 工作流规范请参考 skills/git/SKILL.md

记住: 好的提交是原子的、清晰的，每个提交只做一件事，message 说明"为什么"而非"做了什么"。