菜单
当用户要求"提交代码 / commit / git commit / 帮我提交 / 提交当前修改 / 审查并提交"时使用本技能。它会探测暂存区、运行项目自适应的预检（格式化/lint/敏感信息扫描）、学习项目提交风格、生成符合规范的提交信息，并在用户确认后执行 `git commit`。通用实现，不绑定特定语言或框架。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | git-commit |
| description | 当用户要求"提交代码 / commit / git commit / 帮我提交 / 提交当前修改 / 审查并提交"时使用本技能。它会探测暂存区、运行项目自适应的预检（格式化/lint/敏感信息扫描）、学习项目提交风格、生成符合规范的提交信息，并在用户确认后执行 `git commit`。通用实现，不绑定特定语言或框架。 |
| allowed-tools | ["Bash","AskUserQuestion","mcp__memory__open_nodes","mcp__memory__search_nodes","mcp__memory__create_entities","mcp__memory__add_observations","mcp__sequential-thinking__sequentialthinking"] |
智能化 Git 提交助手：检查变更 → 预检 → 识别规范 → 生成信息 → 确认 → 提交。仅在用户明确要求时 commit；其他自动化场景（如 保存、build）不触发。
保存、格式化、跑测试）git status --porcelain
git diff --cached --stat
git diff --stat # 暂存区为空时追加看工作区
判定：暂存区非空 → 直接使用；暂存区为空 → 进入第 2 步。
用 AskUserQuestion 列出 git status --short 结果，让用户选择「全部 / 特定文件 / 取消」。禁止自动 git add -A 或 git add .（避免误提交 .env、凭证等，详见 references/safety-rules.md#2）。根据用户选择执行 git add <显式文件列表>。
优先调用预检脚本（自动探测 Rust/Node/Python/Go 并运行对应 fmt/lint + 通用敏感信息扫描）：
bash "${CLAUDE_PLUGIN_ROOT}/skills/git-commit/scripts/precheck.sh"
退出码：0 通过 / 1 阻断（必须修复）/ 2 告警（让用户确认）。
脚本不可用时的手动最小检查：
git diff --cached --check # 空白符 / 冲突标记
git diff --cached | grep -En '(AKIA|sk-|-----BEGIN.*PRIVATE KEY)' || true
命中敏感信息必须停下，不要自作主张绕过（详见 references/safety-rules.md#5--6）。
git log --oneline -10
git log --format="%s" -20
分析：常用 type/scope、subject 语言（中/英）、是否带 body / footer。
按优先级查找（见 references/commit-conventions.md#规范识别优先级推荐）：
{
"name": "mcp__memory__open_nodes",
"parameters": {"names": ["project:<repo>:commit-convention"]}
}
<repo> 取 basename "$(git rev-parse --show-toplevel)"。.gitmessage 模板：git config --get commit.template.commitlintrc* / commitlint.config.*：若存在默认套用 Conventional Commits使用 mcp__sequential-thinking__sequentialthinking（6–8 步）分析 git diff --cached：
不要在消息里写「Co-Authored-By: Claude」、「Generated with ...」等广告语，除非项目规范明文要求。
📊 变更摘要
- 修改文件：<数量>
- +<新增> / -<删除>
- 暂存区：<文件列表>
📝 提交信息
<subject>
<body，如有>
✅ 预检：<通过 / 有告警，详情…>
确认提交？回复"确认" / "改成：<新文案>" / "取消"。
强制使用 HEREDOC 以保留多行格式、规避 shell 转义：
git commit -m "$(cat <<'EOF'
<subject>
<body>
EOF
)"
'EOF' 带引号是关键——阻止 $ / 反引号展开。
验证：
git log -1 --oneline
不自动 git push，除非用户消息中同时包含"提交"与"推送"（见 references/safety-rules.md#8）。
| 红线 | 动作 |
|---|---|
| 只在用户明示要 commit 时才执行 | 模糊时用 AskUserQuestion 确认 |
禁止 git add -A / . / --all | 按显式文件名 stage |
禁止 --no-verify / --no-gpg-sign | 除非用户显式要求并已告知风险 |
| Hook 失败 → 新建 commit | 不要 --amend 覆盖上一次成功的提交 |
| 敏感文件名命中 → 停下询问 | .env、*.pem、id_rsa* 等 |
| diff 命中密钥正则 → 停下询问 | 真密钥拒绝；占位符需用户显式确认 |
| 不向 main/master 做破坏性操作 | push --force、reset --hard 等 |
提交信息用 HEREDOC + 'EOF' | 不要用单行 -m "..." 处理多行 |
| 场景 | 处理 |
|---|---|
| 暂存区为空且用户选"取消" | 回复"已取消提交"，不执行任何 git 命令 |
| 预检阻断 | 展示失败项，询问用户是修复还是放弃；不要绕过 |
| Hook 失败 | 读取报错 → 修复 → 重新 stage → 新建 commit |
| 签名失败 | 提示用户 git config commit.gpgsign 与密钥问题；禁止 --no-gpg-sign 绕过 |
| 提交信息不符合 commitlint | 按报错调整信息重试，不改 hook |
--quick 秒级模式跳过工具链仅做安全扫描用户首次提供规范时保存到 Memory，供后续会话复用：
{
"name": "mcp__memory__create_entities",
"parameters": {
"entities": [{
"name": "project:<repo>:commit-convention",
"entityType": "convention",
"observations": ["..."]
}]
}
}