/git-commit-convention

写 git 提交信息、整理提交历史时使用——Conventional Commits 的格式、类型选择和拆分原则。

Boost this skill

7-e1even@7-e1even

GitHub

From plugin

learn-agent

2822 skills

Install

$ npx -y skills add 7-e1even/learn-agent --skill git-commit-convention --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.
You can call itInvoke it directly when you want it.
Slash command/git-commit-convention

Context preview

The summary Claude sees to decide when to auto-load this skill.

写 git 提交信息、整理提交历史时使用——Conventional Commits 的格式、类型选择和拆分原则。

SKILL.md

git-commit-convention.SKILL.md

name: git-commit-convention
description: 写 git 提交信息、整理提交历史时使用——Conventional Commits 的格式、类型选择和拆分原则。

Git 提交规范

格式

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

<body>

<footer>

`type` 必选，`scope` 可选（改动涉及的模块/目录名），`subject` 必选。
subject 用祈使句（"add" 不是 "added"），不加句号，不超过 50 字符。
body 讲**为什么改**，不复述 diff 里能看到的"改了什么"。
一次提交只做一件事：重构和功能修改不混在同一个提交里。

type 怎么选

| type | 用于 | |---|---| | feat | 新功能（用户可感知的行为变化） | | fix | 修 bug（引用 issue 编号写进 footer） | | refactor | 不改行为的结构调整 | | test | 只增改测试 | | docs | 只改文档/注释 | | chore | 构建、依赖、CI 等工程杂务 |

拿不准 feat 还是 fix：问"用户之前的预期是什么"——之前就该这样但没做到 = fix；之前没有这个预期 = feat。

footer

不兼容变更：以 `BREAKING CHANGE:` 开头，说明迁移方法。
关联 issue：`Closes #123`。

提交前自查

1. `git diff --staged` 过一遍：有没有混进无关文件（调试代码、锁文件意外变更）？ 2. 这个提交单独 revert 时，代码库还能编译/测试通过吗？不能 → 拆分方式有问题。 3. subject 能让三个月后的自己一眼看懂吗？

Read it on GitHub ↗

Ships withlearn-agent

开发桌面 agent Reina 过程中记下的笔记，讲 coding agent（Claude Code、Codex、opencode 这类工具）的内部实现机制。每篇讲一个机制，把 Reina 里的生产实现简化成零依赖、单文件、可直接运行的 Node 程序——所以这些做法不是照 API 文档推想的，是实际产品里验证过的。仓库分三块：notes/ 是正篇笔记（s01–s23，每篇一个机制，配可运行 demo）；agent_analysis/ 是其他 agent（pi、Kimi

Get the whole plugin

Stats

JavaScript Node Git GitHub Anthropic

+1 tag

OpenAI

284

Stars

Forks

Active

Maintenance

JavaScript

Language