diff --git a/.gitmessage b/.gitmessage
new file mode 100644
index 0000000..287cd39
--- /dev/null
+++ b/.gitmessage
@@ -0,0 +1,33 @@
+
+# ─────────────────────────────────────────────────────────────
+# 提交信息格式：<类型>(<范围>): <一句话说明>
+#
+# 类型只有六种：
+#   feat      新增能力
+#   fix       修缺陷
+#   refactor  不改行为的重构
+#   docs      文档与接口契约
+#   chore     构建、依赖、配置、仓库杂务
+#   revert    回退
+#
+# 范围写模块名，不写人名：
+#   internal   /internal/** 五个接入接口
+#   contract  docs/contract 下的接口契约
+#   migration Flyway 迁移脚本
+#   auth      鉴权、权限、加解密
+#   alarm     告警引擎与状态机
+#   command   命令下发与结果回收
+#   demo      演示前端与设备模拟器
+#   repo      仓库级文件（.gitignore、README、规范）
+#
+# 示例：
+#   fix(internal): I-12 原文缺失返回 404 而不是 500
+#   feat(alarm): 解除事件按 dev_id + rule_key 关闭组合规则
+#   docs(contract): J-00 升级 1.8.1，OpenAPI 与正文同步
+#   chore(migration): 新增 V1.0.29 补充 alarm_source_event 索引
+#
+# 正文写"为什么这么改、代价是什么"，不复述代码本身。
+# 一条提交只做一件事；不写"按某人要求修改"。
+#
+# 以 # 开头的行不会进入提交信息。保存退出即完成。
+# ─────────────────────────────────────────────────────────────