chinese-commit-conventions
中文 commit 与 changelog 配置参考——Conventional Commits 中文适配、commitlint/husky/commitizen 中文模板、conventional-changelog 中文配置。仅在用户显式 /chinese-commit-conventions 时调用，不要根据上下文自动触发。
npx skills add jnMetaCode/superpowers-zh --skill chinese-commit-conventions --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# 中文 Git 提交规范 ## 1. Conventional Commits 中文适配 基于 Conventional Commits 1.0.0 规范，针对中文团队的实际使用习惯进行适配。 ### 类型（type）定义 | 类型 | 说明 | 示例场景 | | ---------- | ---------------------------- | -------------------------- | | `feat` | 新功能 | 添加用户注册模块 | | `fix` | 修复缺陷 | 修复登录页白屏问题 | | `docs` | 文档变更 | 更新 API 接口文档 | | `style` | 代码格式（不影响逻辑） | 调整缩进、补充分号 | | `refactor` | 重构（非新功能、非修复） | 拆分过长的服务类 | | `perf` | 性能优化 | 优化首页列表查询速度 | | `test` | 测试相关 | 补充用户模块单元测试 | | `chore` | 构建/工具/依赖变更 | 升级 webpack 到 v5 | | `ci` | 持续集成配置 | 修改 GitHub Actions 流程 | | `revert` | 回滚提交 | 回滚 v2.1.0 的登录重构 | ### 原则 - type 保留英文关键字（工具链兼容性好） - scope 和 description 使用中文 - body 使用中文完整描述 ## 2. 中文 commit message 模板 ``` <type>(<scope>): <subject> <body> <footer> ``` ### 完整示例 ``` feat(用户模块): 添加手机号一键登录功能 - 接入运营商一键登录 SDK - 支持移动、联通、电信三网 - 登录失败自动降级到短信验证码 Closes #128 ``` ``` fix(订单): 修复并发下单导致库存超卖的问题 在高并发场景下，原有的库存扣减逻辑存在竞态条件。 改用 Redis 分布式锁 + 数据库乐观锁双重保障。 影响范围：订单服务、库存服务 测试确认：已通过 500 并发压测验证 Closes #256 ``` ## 3. Subject 行规范 ### 格式 ``` <type>(<scope>): <description> ``` ### 规则 - **type**: 必填，从上方类型表中选取 - **scope**: 选填，表示影响范围，使用中文模块名 - 示例：`用户模块`、`订单`、`支付`、`基础组件` - **description**: 必填，中文简述，不超过 50 个字符 - 使用动宾短语：「添加 xxx」「修复 xxx」「优化 xxx」 - 不加句号结尾 - 不要写「修改了代码」这种无意义描
- 1. Conventional Commits 中文适配
- 类型（type）定义
- 原则
- 2. 中文 commit message 模板
- 完整示例
- 3. Subject 行规范
- 格式
- 规则
- 好的示例
- 反面示例
- 4. Body 编写规范
- 编写要点
- Body 模板
- 5. Breaking Changes 标注
npm install -D conventional-changelog-cli conventional-changelog-conventionalcommits npm install -D @commitlint/cli @commitlint/config-conventional npm install -D husky lint-staged npx husky init npx --no -- commitlint --edit "$1" npx lint-staged npm install -D commitizen cz-conventional-changelog package.json 中添加
What does the chinese-commit-conventions skill do?
中文 commit 与 changelog 配置参考——Conventional Commits 中文适配、commitlint/husky/commitizen 中文模板、conventional-changelog 中文配置。仅在用户显式 /chinese-commit-conventions 时调用，不要根据上下文自动触发。
How do I install it?
Run `npx skills add jnMetaCode/superpowers-zh --skill chinese-commit-conventions --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From jnMetaCode/superpowers-zh, a repository with 7,457 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.