---
title: "Gitmoji"
type: entity
tags: ["tool", "git", "commit-standards"]
last_updated: 2026-04-25
---

## Aliases
- gitmoji
- Gitmoji

## Type
Commit Standard Tool

## Description

Gitmoji 是一个标准化 Emoji 提交规范工具，通过在 Git commit message 前缀标准化的 Emoji，使开发团队能够在 git log 中通过视觉标签快速识别变更类型和意图。

## Official References

- **Primary**: [gitmoji.dev](https://gitmoji.dev/) — 当前 emoji 目录和标准含义
- **Source of truth**: [github.com/carloscuesta/gitmoji](https://github.com/carloscuesta/gitmoji) — 上游项目和最佳实践模型

## Key Gitmojis

| Emoji | 含义 | Gitmoji 官方定义 |
|-------|------|----------------|
| ✨ | 新功能 | Introducing new features |
| 🐛 | 缺陷修复 | Fixing a bug |
| ♻️ | 重构 | Refactoring code |
| 📚 | 文档 | Updating docs |
| 🧪 | 测试 | Adding tests |
| 💄 | 样式 | Updating UI/style |
| 🔧 | 配置 | Changing config files |
| 📦 | 依赖 | Updating packages |
| 🚀 | 部署 | Deploying stuff |

## Usage in The Agency

[[Jira Workflow Steward]] Agent 使用 Gitmoji 作为 [[Gitmoji-Commit]] 规范的视觉层：
- 格式：`<Gitmoji> JIRA-ID: short description`
- 选择依据：变更的实际类型，而非个人偏好
- 新增新 agent（catalog 功能）→ 优先 `✨`（因为 Gitmoji 定义为新功能）
- 仅更新现有文档 → 使用 `📚`

Gitmoji 同时用于 commit-msg hook 的正则表达式验证，不符合规范的提交会被拒绝。

## Sources
- [[project-management-jira-workflow-steward]]（主要来源）