clean-commits

生成干净、符合仓库既有风格的 git commit message。当用户要提交代码、让你写/改 commit message、拆分提交,或要求提交历史保持干净时使用。只写改动本身——不加 AI 共同作者署名,不加任何生成工具水印。

SKILL.md

GitHub

Clean Commits

帮用户写出只描述改动本身的 commit message:主题行准确、正文讲清动机、零噪音。

输入

  • 已暂存或未暂存的代码改动(自己用 git 命令读取,不需要用户描述)
  • 用户可能附带的上下文(关联 issue、改动动机);没有就从 diff 推断

工作流

  1. git diff --staged 读实际改动(无暂存内容则看 git diff)
  2. git log --oneline -15 观察仓库既有风格:是否用 Conventional Commits 前缀(feat:/fix:…)、中文还是英文——跟随既有风格,不要另起一套
  3. 从改动的效果(而非代码机制)提炼主题行
  4. 动机不明显时补正文,说明为什么改,而不是复述 diff
  5. 若暂存区混入多个不相关改动,先建议拆分再提交

输出格式

  • 主题行:祈使语气,≤ 72 字符,无句号
  • 正文(可选):与主题行空一行,每行 ≤ 72 字符,只写动机与取舍
  • 禁止出现:
    • Co-Authored-By: 等 AI 共同作者署名
    • 🤖 Generated with ... 等任何工具水印
    • 仓库没在用的 issue 标签、emoji 前缀等额外噪音

示例:

fix: 配置缺 timeout 字段时回退默认值

v0.3 写出的配置文件完全没有 timeout 键,加载时直接崩溃。
改为缺键时应用默认值,而不是假设键一定存在。
add retry with backoff to webhook delivery