Kiro 生成 commit message 如何使用简体中文

兰亭古墨2026-07-16 17:07

Kiro 生成中文 Commit Message

背景

Kiro 默认生成的 commit message 是英文。如果你需要使用简体中文，需要通过以下两种机制配合实现。

配置方法

1. Steering 文件（核心）

在 .kiro/steering/ 目录下创建一个 markdown 文件，设置 inclusion: auto 让规则在每次会话中自动加载。

文件路径：.kiro/steering/commit-message.md

markdown 复制代码

---
inclusion: auto
---

# Git Commit Message 规范

当需要生成 Git 提交信息时，必须严格遵守以下规则：

1. 遵循 Conventional Commits 格式：
   `<type>(<scope>): <subject>`
2. type 使用 feat、fix、docs、refactor、test、chore、perf、ci 等英文类型前缀。
3. scope 使用英文模块名称（可选）。
4. **subject 和正文必须使用简体中文，禁止使用英文描述。**
5. subject 不超过 50 个汉字，不以句号结尾。
6. 正文使用中文列表概括主要修改。
7. 不输出分析过程、Markdown 代码块或其他解释，只输出最终提交信息。

示例：
- `feat(auth): 添加用户登录功能`
- `fix(api): 修复数据加载异常问题`
- `chore: 升级依赖版本并更新配置`

关键点 ：inclusion 必须设为 auto。如果设为 manual，规则只有在聊天中手动用 # 引用时才会生效，这就是之前一直生成英文的原因。

2. Hook 文件（辅助强化）

在 .kiro/hooks/ 目录下创建一个 JSON 钩子文件，每次用户发送消息时额外注入中文指令。

文件路径：.kiro/hooks/chinese-commit-msg.json

json 复制代码

{
  "version": "v1",
  "hooks": [
    {
      "name": "中文提交消息",
      "description": "强制所有 git commit message 使用简体中文",
      "trigger": "UserPromptSubmit",
      "action": {
        "type": "agent",
        "prompt": "当用户请求生成 git commit message 时，你必须使用简体中文书写提交消息。commit message 的标题和正文都必须使用简体中文，不要使用英文。格式遵循常规 commit 规范，但内容全部用中文表达。例如：「feat: 添加用户登录功能」「fix: 修复数据加载异常问题」。"
      },
      "enabled": true
    }
  ]
}