创建规范清晰的 Git 提交

在多人协作或 AI 编码助手参与的开发场景中，commit message 经常出现风格不统一、类型缺失、消息含糊等问题。codename-11-commit 是一个面向 Claude、Codex 与 Claude Code 的轻量级 Skill，专门解决"提交信息不一致、改动意图不清晰"这两类痛点，让每一次 git commit 都符合 Conventional Commits 规范，并且能如实反映本次改动的真实意图。

技能简介

该技能由 GitHub 用户 Codename-11 维护，采用 MIT 许可证，已通过 Skillstore 完整审计，质量评分 78 分。它不需要启动任何额外服务，只要在 Claude、Codex 或 Claude Code 会话中调用该技能，模型就会按照约定式提交（Conventional Commits）规范自动审阅本次改动、整理提交信息，并提示用户是否需要拆分 commit。

核心能力

• 仓库状态预检：提交前自动执行 git status、git diff --staged、git log -n 5 --oneline，确保模型了解完整上下文。
• 变更意图识别：根据 diff 内容判断本次改动属于 feature、fix、docs、refactor、test、chore 中的哪一类，并据此选择前缀。
• 历史风格学习：自动读取仓库近 5 条 commit message，模仿已有的标题长度、动词时态、模块命名习惯，让新提交与历史风格一致。
• 智能 stage 选择：若用户尚未 git add，技能会推荐需要纳入本次提交的文件，避免无关文件混入。
• 规范式信息生成：最终输出形如 feat(auth): add OAuth2 callback handler 的提交标题，并在正文里给出改动摘要、影响范围、关联 Issue。
• 拆 commit 建议：当 diff 涉及多个不相关模块时，主动提示"建议拆分为多个独立 commit"，让 history 更清晰。
• 凭据走审提醒：在生成 commit 前扫描 staged 文件名，发现 .env、*.pem、id_rsa 等敏感命名时给出告警。

安装配置

• 一行安装：执行 npx skillstore add codename-11/commit，Skillstore 会自动拉取该 Skill 到本地 .claude/skills/commit 目录。
• 手动安装：将仓库 https://github.com/Codename-11/Stash-Downloader/tree/main/.claude/skills/commit 下的 SKILL.md 复制到任意 Claude / Codex / Claude Code 项目根目录的 .claude/skills/ 下即可。
• 权限需求：依赖 external_commands 与 network 风险因子，使用时需要授予 Skill 调用 git 子命令的权限。
• 前置依赖：环境中需要安装 Git 2.20+ 与 npx（Node.js 16+），无需额外数据库或服务端。

使用步骤

1. 进入项目目录：在 Claude Code 对话框中 cd 到要提交的项目根目录，确保 .git 目录存在。
2. 加载技能：直接说"使用 create-clear-git-commits 技能"，或在 prompt 模板里以 skill 名显式引用。
3. 描述改动：用一句话告诉模型"我刚才完成了 xxx 改动，请按规范创建 commit"，也可以粘贴关键 diff 段落。
4. 审阅生成结果：模型会输出推荐的 commit title 与 body，并列出涉及的文件清单，请逐项确认。
5. 确认提交：回复 yes 后模型自动 git add + git commit；如需拆分则按提示多次确认。

适用场景

• AI 编码助手完成功能开发后：让 Claude / Codex 把刚写完的代码按规范提交，避免遗留 WIP 提交。
• 多人协作项目标准化：统一团队成员（含人类与 AI）的 commit message 写法。
• 开源项目维护：遵循 Conventional Commits 规范可让 release-please、semantic-release 自动生成 CHANGELOG。
• 重构 / 文档批量改动：当一次提交涉及多类文件时主动建议拆分。

适用人群

• 在 Claude Code / Codex 中日常编码的全栈与全栈工程师
• 需要规范 commit history 的开源项目维护者
• 团队技术负责人，希望统一团队提交规范
• 借助 AI 编程助手快速完成 MVP 的独立开发者

工作原理

该技能读取仓库的 git status、git diff、git log 三类命令输出，结合 Conventional Commits 规范与历史 commit 风格，生成结构化提交信息。模型不会直接修改远程仓库，所有 commit 操作都需要用户最终确认，避免误提交。敏感文件扫描基于文件名前缀匹配（.env、credentials、*.key 等），命中后会要求用户显式确认是否纳入。

官方链接

• Skill 详情页：https://skillstore.io/skills/codename-11-commit
• Manifest 接口：https://skillstore.io/api/skills/codename-11-commit/manifest
• 源码仓库：https://github.com/Codename-11/Stash-Downloader/tree/main/.claude/skills/commit