/commit

name: commit
description: Use when the user invokes /commit or asks to commit changes, after a code review has been completed and the changes are confirmed ready to stage and commit to git.

commit — Stage & Commit

Overview

在 Code Review 通过后，将有效的代码变更暂存并提交到本地 Git 仓库。

前置条件检查

1. 确认本次对话中已执行过 `/cr`（Code Review） 2. 若 Review 报告存在 **Critical** 问题，**停止执行**，提示用户先修复 3. 若未执行过 `/cr`，先调用 `cr` skill 完成 Review，再继续

执行步骤

1. 确认变更范围

git status
git diff --stat
git diff --cached --stat

2. 精确暂存文件

**不使用 `git add -A` 或 `git add .`**，逐文件或逐目录添加：

git add <具体文件或目录>

排除规则：

• `.env`、包含敏感信息的文件 → 不暂存，提示用户确认
• 与本次功能无关的临时文件 → 不暂存

3. 起草提交信息

参考以下格式（优先遵循仓库现有风格，通过 `git log --oneline -10` 判断）：

<type>: <简明描述>（50 字符以内）

<可选正文：说明 why，不是 what>

常用 `type`：`feat` / `fix` / `docs` / `refactor` / `test` / `chore`

**禁止**在提交信息中添加任何 AI 工具相关的署名，例如 `Co-Authored-By: Claude` 或类似内容。

4. 执行提交

git commit -m "$(cat <<'EOF'
<提交信息>
EOF
)"

5. 确认结果

git log --oneline -3   # 确认提交已记录
git status             # 确认工作区干净

输出提交的 hash 与摘要，告知用户提交成功。

常见错误

| 问题 | 处理 | |------|------| | pre-commit hook 失败 | 修复 hook 报告的问题，重新 `git add` 后创建**新** commit，不使用 `--amend` | | 暂存了不该提交的文件 | `git restore --staged <file>` 取消暂存，重新操作 | | 工作区已无变更 | 告知用户没有可提交的内容 |