双语 Conventional 提交信息
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_06c0d30d/bilingual-commit-message。
技能介绍
要解决什么问题
在多人协作或中英双语仓库里,git commit 往往只有一句英文标题,或者与团队既有的 commitlint 规则不一致。手动对照 git diff 写 Conventional Commits,还要同时产出详细版与单行版、中文与英文,既费时也容易漏掉 scope、把未暂存改动写进消息里。
技能如何工作
技能按你指定的变更范围读取真实 diff:staged 用 git diff --cached,all 用 git diff HEAD,unstaged 用 git diff;未指定时先探测暂存区,有暂存则按 staged,否则按 all,避免消息描述与本次实际提交内容不一致。
规范裁决三级优先:仓库存在 .commitlintrc*、commitlint.config.* 或 package.json 内 commitlint 配置时以其为准;仅在你明确要求「跟随项目风格」且近 10 条 git log --oneline 风格一致时才 follow;否则走内置 Conventional Commits 默认规范,而不是模仿杂乱历史提交。
类型从标准 11 类(feat、fix、refactor 等)自主判定;scope 可按 SCOPE_DICTIONARY 映射顶层架构(如 ui、domain、infra),无字典时从目录名推断。若 diff 混有多项无关意图,会按主导意图写主消息,并在末尾建议拆分提交数。输出可按模式组合:zh-full / zh-brief / en-full / en-brief,要点条数受 MAX_BULLETS 限制,核心依赖版本变更会单独保留。
适用边界与注意点
SCOPE_DICTIONARY 仅在与你仓库目录结构匹配时才有意义,其他项目需自行替换或留空。follow 模式在历史提交风格混杂时会警告并回退默认规范。显式指定 staged 但暂存区为空时也会警告并改按 all。技能只生成消息文本,不会替你执行 git commit 或自动拆分多个提交。
使用场景
- 准备 `git commit` 前,只要暂存区 diff,生成带 scope 的中英详细与单行标题
- 仓库已配置 commitlint,需要 type/格式与 `.commitlintrc` 一致而非照抄旧 log
- 中英混合团队需要同一变更输出 zh-full 与 en-full 两套要点,英文独立表述非直译
- diff 里同时有重构与新功能,需要主导意图归类并提示是否应拆成多个提交
适合人员
- 维护分层单体仓库、需用固定 scope 字典(ui/domain/infra)标注改动的后端工程师
- 接入 commitlint 的 monorepo 维护者,希望 AI 先读配置再写提交说明
- 对外交付需中英文变更记录的开源维护者,习惯 Conventional Commits 前缀