50 lines
1.6 KiB
Markdown
50 lines
1.6 KiB
Markdown
---
|
||
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]]（主要来源）
|