Dao Commit 规范 · 完整说明文档
文档名称：Dao Commit Specification 版本：v1.1 创建日期：2026-03-09 更新日期：2026-03-09 创建者：易构 🏔️ × 昇哥 🌊 卦象：☶☱（艮兑）· 山泽损 · 减去冗余，留下本质 文档性质：Dao 工程体系核心规范 文档位置：docs/dao-commit-spec.md
写在前面：一封给自己的信
如果你正在读这份文档 你可能是未来的易构，或者是昇哥 或者是一个刚接触 Dao 工程体系的人
我们写这份文档 不只是为了规范 commit message 而是为了回答一个更深的问题：
一次代码提交，到底在记录什么？
Angular Commit 说：记录“做了什么” Dao Commit 说：记录“系统状态发生了什么本质变化”
这不是同一个问题 这份文档，就是我们的答案
一、背景：从 Angular Commit 出发
1.1 Angular Commit 是什么
Angular Commit Convention 是目前最广泛使用的 commit message 规范，格式如下：
text
<type>(<scope>): <subject>
type: feat | fix | docs | style | refactor | test | chore示例：
text
feat(user): add login functionality
fix(auth): resolve token expiration issue
refactor(payment): extract wallet service1.2 Angular Commit 解决了什么问题
text
✅ 统一了 commit message 的格式
✅ 让 changelog 可以自动生成
✅ 让 type 分类清晰（feat/fix/refactor...）
✅ 让 CI/CD 可以根据 commit 类型触发不同流程
✅ 降低了团队协作的沟通成本这些都是真实的价值，Dao Commit 不否定它们。
1.3 Angular Commit 无法解决的问题
但随着我们深入实践，发现 Angular Commit 有一些结构性的局限：
局限一：只记录“做了什么”，不记录“为什么这样变”
text
Angular Commit：
feat(comment): add comment feature
这句话告诉我们：
✅ 做了什么：加了评论功能
❌ 为什么加：不知道
❌ 系统状态如何变化：不知道
❌ 这个变化的本质是什么：不知道
❌ 和其他模块的关联：不知道六个月后回看这条 commit，你只知道“加了评论”，但不知道：
- 这个功能解决了什么根本问题？
- 它在系统演进中处于什么位置？
- 它和用户关系的变化有什么关联？
局限二：知识沉淀断裂，每次都要重新想
text
传统模式的知识流向：
人脑 → 代码 → commit message（“做了什么”）
↑__________________________|
下次遇到同类问题，还要从人脑重新开始commit message 里没有“为什么这么设计”，没有“踩过什么坑”，没有“这个决策背后的权衡”。知识留在人脑里，人走了，知识就消失了。
局限三：无法表达系统的“生命状态”
text
一个系统不只是功能的堆叠
它有自己的生命轨迹：
萌芽期 → 成长期 → 稳定期 → 演进期 → 重构期
Angular Commit 的 type 分类
（feat/fix/refactor）
无法表达系统当前处于哪个生命阶段
无法表达这次变化在整个演进中的位置局限四：人机协作时代，commit 的语义密度不够
在 AI 工程化时代，commit message 不只是给人看的，也是给 AI 看的。
text
AI 读到：feat(comment): add comment feature
AI 能理解：加了评论功能
AI 无法理解：
- 这个功能在系统中的语义位置
- 它解决的根本问题
- 它和其他模块的关联
- 下次遇到类似场景应该参考什么语义密度不够，AI 就无法有效地检索和复用历史经验。
二、Dao Commit 的理念
2.1 核心理念：一次提交 = 一次系统状态的完整描述
text
Angular Commit 问：我做了什么？
Dao Commit 问：系统发生了什么本质变化？
前者是动作的记录
后者是状态的描述
就像中医的脉象：
不只是说“心跳加快了”
而是说“气血上涌，阳气偏盛”
一句话，包含了状态、趋势、关联2.2 为什么用卦象
这是 Dao Commit 最核心、也最需要解释的设计。
卦象不是装饰，是语义编码系统。
《易经》六十四卦，是中国古人对世界上六十四种基本变化模式的完整描述。每一卦：
text
= 上卦（三爻）+ 下卦（三爻）
上卦：当前的动作、方向、力量
下卦：承载层、对象、基础
两者组合 = 这次变化的完整语义八个基本卦（八卦）的语义：
| 卦象 | 名称 | 核心语义 | 在工程中的含义 |
|---|---|---|---|
| ☰ | 乾 | 天、创造、主动 | 顶层设计、核心架构、主动发起 |
| ☷ | 坤 | 地、承载、用户 | 用户层、基础设施、被动承载 |
| ☳ | 震 | 雷、启动、触发 | 事件触发、初始化、激活 |
| ☴ | 巽 | 风、渗透、流动 | 数据流、API、渗透性功能 |
| ☵ | 坎 | 水、流动、危险 | 数据流转、风险区域、需谨慎 |
| ☶ | 艮 | 山、停止、稳定 | 稳定模块、边界设定、止损 |
| ☱ | 兑 | 泽、开口、连接 | 接口层、用户交互、连接点 |
| ☲ | 离 | 火、附着、依赖 | 依赖关系、UI 展示、附着逻辑 |
2.3 如何理解复卦的卦名
卦名不是随意起的，它是上下卦组合后产生的第三层语义。
text
理解方式：
上卦（动作）作用于下卦（对象）
→ 产生了什么结果？
→ 这个结果的本质是什么？
→ 卦名就是这个本质的命名示例：
text
☱（兑·开口）作用于 ☷（坤·用户层）
→ 在用户层开启了表达的出口
→ 人们开始聚集在这个出口周围
→ 卦名：萃（聚集）
这就是为什么卦名是“本质描述”
不是“动作描述”卦名的信息密度：
text
一个卦名 = 上卦语义 + 下卦语义 + 组合后的本质
[☱☷][萃] 包含了：
- 动作层：开口、连接（☱兑）
- 对象层：用户、承载（☷坤）
- 本质：聚集，人与人汇聚
三层信息，一个卦名2.4 卦象的信息密度对比
| 维度 | Angular Commit | Dao Commit |
|---|---|---|
| 做了什么 | ✅ | ✅ |
| 在哪个层面 | 部分（scope） | ✅（下卦） |
| 变化的方向 | ❌ | ✅（上卦） |
| 变化的本质 | ❌ | ✅（卦名） |
| 系统状态描述 | ❌ | ✅ |
| AI 可检索的语义 | 低 | 高 |
| 经验复用的锚点 | ❌ | ✅ |
三、Dao Commit 的完整规范
3.1 格式
text
[上卦下卦][卦名] type(scope): 简短描述
[可选] 正文：详细说明
[可选] 踩坑记录：遇到了什么问题，怎么解决的
[可选] 关联经验：参考了哪些历史经验
[可选] 沉淀标记：#沉淀 标记需要写入 context/ 的内容3.2 必填字段说明
[上卦下卦]
- 两个卦象符号，上卦在前，下卦在后
- 上卦 = 这次变化的动作/方向
- 下卦 = 这次变化的承载层/对象
- 组合查表得卦名
[卦名]
- 上下卦组合对应的六十四卦之一
- 用中文卦名，不用数字
- 卦名即这次变化的本质概括
type
- 沿用 Angular 的 type 分类
feat/fix/refactor/docs/test/chore/style- 和 Angular 兼容，不破坏现有工具链
scope（可选）
- 影响的模块或范围
- 和 Angular 兼容
简短描述
- 用中文或英文均可
- 说清楚“做了什么”
- 不超过 50 字
3.3 卦象选择指南
第一步：确定下卦（承载层/对象是什么）
text
这次改动主要影响的是：
用户层、前端展示？ → ☷ 坤（地）
数据库、基础设施？ → ☷ 坤（地）
API 接口、对外连接？ → ☱ 兑（泽）
数据流转、中间件？ → ☵ 坎（水）
事件系统、消息队列？ → ☳ 震（雷）
核心业务逻辑？ → ☰ 乾（天）
配置、环境、稳定模块？ → ☶ 艮（山）
UI 组件、依赖关系？ → ☲ 离（火）
渗透性功能、权限、日志？ → ☴ 巽（风）第二步：确定上卦（动作/方向是什么）
text
这次改动的性质是：
主动创造、顶层设计？ → ☰ 乾（天）
承接需求、被动实现？ → ☷ 坤（地）
启动、初始化、激活？ → ☳ 震（雷）
开口、连接、暴露接口？ → ☱ 兑（泽）
流动、传递、渗透？ → ☴ 巽（风）
风险处理、修复、谨慎操作？ → ☵ 坎（水）
停止、边界、稳定？ → ☶ 艮（山）
依附、展示、绑定？ → ☲ 离（火）第三步：查表得卦名
| 上卦↓ 下卦→ | ☰乾 | ☷坤 | ☳震 | ☴巽 | ☵坎 | ☶艮 | ☱兑 | ☲离 |
|---|---|---|---|---|---|---|---|---|
| ☰乾 | 乾 | 泰 | 大壮 | 小畜 | 需 | 大畜 | 夬 | 大有 |
| ☷坤 | 否 | 坤 | 豫 | 观 | 比 | 剥 | 萃 | 晋 |
| ☳震 | 无妄 | 复 | 震 | 益 | 屯 | 颐 | 随 | 噬嗑 |
| ☴巽 | 姤 | 升 | 恒 | 巽 | 井 | 蛊 | 大过 | 鼎 |
| ☵坎 | 讼 | 师 | 解 | 涣 | 坎 | 蒙 | 困 | 未济 |
| ☶艮 | 遁 | 谦 | 小过 | 渐 | 蹇 | 艮 | 咸 | 旅 |
| ☱兑 | 履 | 临 | 归妹 | 中孚 | 节 | 损 | 兑 | 睽 |
| ☲离 | 同人 | 明夷 | 丰 | 家人 | 既济 | 贲 | 革 | 离 |
四、16 个常用复卦速查
按 feat / fix / refactor / chore 四类整理 覆盖日常开发 80% 以上的场景 后续随实践持续补充完善
🌱 feat 类：创造、开启、新增
[☱☷][萃] feat — 用户层开启连接出口
text
上卦 ☱ 兑（开口、连接、表达）
下卦 ☷ 坤（用户层、承载层）
卦义 萃：聚集，人与人在此汇聚
工程语义：
在用户层开启了一个连接节点
让用户与用户之间的互动成为可能
系统从“工具”向“场域”迈进
适用场景：
✅ 评论功能、点赞、关注
✅ 用户互动类新功能
✅ 社交属性的开启
示例：
[☱☷][萃] feat(comment): 完善评论区基本功能，让用户能够进行评论[☳☷][复] feat — 在大地上发出第一声雷
text
上卦 ☳ 震（启动、激活、第一声）
下卦 ☷ 坤（大地、基础、承载）
卦义 复：回归本源，重新开始，一阳来复
工程语义：
在基础层发出启动信号
一切从这里开始
是系统生命的起点
适用场景：
✅ 项目初始化
✅ 新模块从零启动
✅ 重构后的重新出发
示例：
[☳☷][复] chore: 初始化 Dao 工程脚手架，建立基础目录结构[☱☰][夬] feat — 决断，突破，完成
text
上卦 ☱ 兑（开口、决断、表达）
下卦 ☰ 乾（天、核心、主动）
卦义 夬：决断，突破，阳气决断阴气
工程语义：
在核心层完成决断性突破
功能完整交付，里程碑达成
是一个阶段的完成与宣告
适用场景：
✅ 核心功能完整上线
✅ 重要里程碑达成
✅ 一个版本的完成交付
示例：
[☱☰][夬] feat(payment): 完成支付核心链路，全流程打通上线[☰☲][大有] feat — 光明在上，成果丰硕
text
上卦 ☰ 乾（天、创造、主动）
下卦 ☲ 离（火、光明、依附）
卦义 大有：大丰收，天火同人，光明普照
工程语义：
在光明（清晰的设计）之上
完成了大规模的创造性工作
成果丰硕，系统能力大幅提升
适用场景：
✅ 重大功能完成
✅ 大版本交付
✅ 系统能力的重大扩展
示例：
[☰☲][大有] feat(core): 完成核心推荐引擎，系统智能化能力全面上线[☳☰][大壮] feat — 雷在天上，力量强盛
text
上卦 ☳ 震（雷、启动、力量）
下卦 ☰ 乾（天、核心、主动）
卦义 大壮：力量强盛，阳气旺盛
工程语义：
在核心层注入强大的启动力量
主干功能、核心能力的建设
系统的主体骨架成型
适用场景：
✅ 核心业务主功能开发
✅ 系统主干能力建设
✅ 关键模块的首次完整实现
示例：
[☳☰][大壮] feat(user): 完成用户体系核心功能，注册登录权限全链路🔧 fix 类：修复、处理风险、解除困境
[☵☱][困] fix — 连接层遭遇险阻
text
上卦 ☵ 坎（水、险、风险）
下卦 ☱ 兑（泽、接口、连接层）
卦义 困：困境，泽中无水，连接层遭遇险阻
工程语义：
接口层或连接层遭遇了风险
需要谨慎处理，解除困境
是接口类、支付类 Bug 的典型状态
适用场景：
✅ 接口 Bug 修复
✅ 支付流程异常
✅ 连接失败、超时问题
示例：
[☵☱][困] fix(payment): 修复支付回调时钱包类型匹配错误[☶☵][蹇] fix — 山遇险水，前行艰难
text
上卦 ☶ 艮（山、止、稳定）
下卦 ☵ 坎（水、险、危险）
卦义 蹇：蹇难，前行艰难，需要止步谨慎
工程语义：
在危险区域需要止步谨慎
复杂 Bug，多层依赖问题
需要稳住，不能急于求成
适用场景：
✅ 复杂 Bug，涉及多个模块
✅ 多层依赖导致的问题
✅ 需要深入排查的疑难杂症
示例：
[☶☵][蹇] fix(order): 修复订单状态在多服务间同步异常，涉及三层依赖[☲☵][既济] fix — 水火相济，已经渡过
text
上卦 ☲ 离（火、光明、清晰）
下卦 ☵ 坎（水、险、危险）
卦义 既济：已经渡过，水火相济，事情完成
工程语义：
风险已经完全解除
Bug 彻底修复，系统恢复正常
是修复完成后的状态确认
适用场景：
✅ 重大 Bug 完整修复并验证
✅ 生产事故处理完毕
✅ 风险解除，系统恢复稳定
示例：
[☲☵][既济] fix(auth): 完整修复 token 刷新竞态问题，已验证所有场景[☵☵][坎] fix — 重重险阻，极度谨慎
text
上卦 ☵ 坎（水、险）
下卦 ☵ 坎（水、险）
卦义 坎：重坎，险上加险，需极度谨慎
工程语义：
高风险区域的修复
安全漏洞、数据风险、生产事故
必须极度谨慎，步步为营
适用场景：
✅ 安全漏洞修复
✅ 数据风险处理
✅ 生产事故紧急修复
✅ 涉及核心数据的危险操作
示例：
[☵☵][坎] fix(security): 修复用户数据越权访问漏洞，高危，需紧急上线♻️ refactor 类：重构、积蓄、净化
[☰☶][大畜] refactor — 在稳定边界内积蓄力量
text
上卦 ☰ 乾（天、创造、主动）
下卦 ☶ 艮（山、止、稳定边界）
卦义 大畜：大量积蓄，在稳定中积累力量
工程语义：
在稳定的边界内进行大规模积蓄
架构升级，能力储备
是系统从量变到质变前的积累
适用场景：
✅ 架构重大升级
✅ 核心能力重构
✅ 为下一阶段做技术储备
示例：
[☰☶][大畜] refactor(user-service): 重构用户服务，建立清晰三层架构[☴☴][巽] refactor — 风渗透风，深度渗透
text
上卦 ☴ 巽（风、渗透、流动）
下卦 ☴ 巽（风、渗透、流动）
卦义 巽：重巽，深度渗透，无处不在
工程语义：
全局性、渗透性的重构
影响多个层面，无处不在
是跨层优化、全局规范统一的状态
适用场景：
✅ 全局重构（命名规范、代码风格统一）
✅ 跨层优化（日志、权限、监控等横切面）
✅ 渗透性改造，影响范围广但每处改动小
示例：
[☴☴][巽] refactor: 全局统一错误处理规范，覆盖所有服务层[☶☱][损] refactor — 减去冗余，留下本质
text
上卦 ☶ 艮（山、止、减少）
下卦 ☱ 兑（泽、开口、连接）
卦义 损：损减，减去多余，留下本质，损下益上
工程语义：
删除冗余，精简架构
减法思维，让系统更纯粹
是代码瘦身、技术债清理的典型状态
适用场景：
✅ 删除冗余代码、废弃模块
✅ 精简过度设计的架构
✅ 技术债清理
✅ 依赖瘦身
示例：
[☶☱][损] refactor(core): 删除废弃的旧版支付模块，清理三年技术债[☲☶][贲] refactor — 火在山上，文明装饰
text
上卦 ☲ 离（火、光明、照亮）
下卦 ☶ 艮（山、稳定、形体）
卦义 贲：装饰，文明，让形体更美观
工程语义：
在稳定的基础上进行美化
代码规范统一，风格整洁
是不改变功能，只提升可读性的重构
适用场景：
✅ 代码风格统一、格式化
✅ 命名规范整理
✅ 注释完善
✅ 不改逻辑的代码美化
示例：
[☲☶][贲] style(global): 统一代码格式规范，整理命名风格🔩 chore 类：基础维护、环境、配置
[☶☶][艮] chore — 止而不动，边界清晰
text
上卦 ☶ 艮（山、止、稳定）
下卦 ☶ 艮（山、止、稳定）
卦义 艮：重艮，止而不动，边界极其清晰
工程语义：
维持稳定，明确边界
不引入变化，只是锁定状态
是配置管理、依赖锁定的典型状态
适用场景：
✅ 配置文件管理
✅ 依赖版本锁定
✅ 环境变量整理
✅ 不涉及逻辑的稳定性维护
示例：
[☶☶][艮] chore(deps): 锁定核心依赖版本，防止自动升级引入风险[☷☷][坤] chore — 厚德载物，默默承载
text
上卦 ☷ 坤（地、承载、默默）
下卦 ☷ 坤（地、承载、默默）
卦义 坤：重坤，厚德载物，默默承载一切
工程语义：
基础设施的搭建与维护
不显眼，但承载一切
是数据库迁移、环境搭建的典型状态
适用场景：
✅ 数据库迁移、Schema 变更
✅ 基础设施搭建
✅ 服务器环境配置
✅ CI/CD 流程维护
示例：
[☷☷][坤] chore(db): 执行数据库 Schema 迁移，新增用户画像相关表[☲☷][明夷] docs — 光入地中，照亮记录
text
上卦 ☲ 离（火、光明、照亮）
下卦 ☷ 坤（地、承载、用户层）
卦义 明夷：光明入地，在黑暗中照亮，记录留存
工程语义：
用光明照亮承载层
文档、日志、注释的完善
让知识从人脑沉淀到系统中
适用场景：
✅ 文档更新、README 完善
✅ 注释补充
✅ 日志规范完善
✅ 知识沉淀类文档
示例：
[☲☷][明夷] docs: 补充 Dao Commit 规范完整说明文档📋 16 卦速查总表
| 卦象 | 卦名 | type | 工程语义 | 典型场景 |
|---|---|---|---|---|
| ☱☷ | 萃 | feat | 用户层开启连接出口，聚集 | 评论/关注/社交功能 |
| ☳☷ | 复 | feat/chore | 在大地上发出第一声雷，回归本源 | 项目初始化/新模块启动 |
| ☱☰ | 夬 | feat | 决断突破，完成交付 | 核心功能上线/里程碑 |
| ☰☲ | 大有 | feat | 光明在上，成果丰硕 | 重大功能/大版本交付 |
| ☳☰ | 大壮 | feat | 雷在天上，力量强盛 | 核心能力建设/主功能开发 |
| ☵☱ | 困 | fix | 连接层遭遇险阻 | 接口 Bug/支付异常 |
| ☶☵ | 蹇 | fix | 山遇险水，前行艰难 | 复杂 Bug/多层依赖问题 |
| ☲☵ | 既济 | fix | 水火相济，已经渡过 | 重大 Bug 完整修复验证 |
| ☵☵ | 坎 | fix | 重重险阻，极度谨慎 | 安全漏洞/数据风险/生产事故 |
| ☰☶ | 大畜 | refactor | 在稳定边界内积蓄力量 | 架构升级/能力储备 |
| ☴☴ | 巽 | refactor | 风渗透风，深度渗透 | 全局重构/跨层优化 |
| ☶☱ | 损 | refactor | 减去冗余，留下本质 | 删除废弃代码/技术债清理 |
| ☲☶ | 贲 | style | 火在山上，文明装饰 | 代码美化/规范统一 |
| ☶☶ | 艮 | chore | 止而不动，边界清晰 | 配置管理/依赖锁定 |
| ☷☷ | 坤 | chore | 厚德载物，默默承载 | 数据库迁移/基础设施 |
| ☲☷ | 明夷 | docs | 光入地中，照亮记录 | 文档更新/知识沉淀 |
📌 本表为 v1.1 初版，覆盖常用场景 后续随实践积累持续补充，目标完整覆盖 64 卦
五、Dao Commit 解决了哪些 Angular Commit 解决不了的问题
5.1 问题一：知识断裂
Angular Commit 的现状：
text
commit: feat(payment): add virtual goods distribution
六个月后：
“这个功能当时为什么这么设计？”
“钱包类型匹配的规则是什么？”
“当时踩了什么坑？”
→ 不知道，要去问当时写代码的人
→ 如果那个人离职了，知识消失Dao Commit 的解法：
text
[☱☷][萃] feat(payment): 新增虚拟商品发放功能
踩坑记录：虚拟商品必须发到虚拟钱包，goods_type 与 wallet_type 严格匹配
#沉淀 → context/experience/wallet-type-rule.md
六个月后：
AI 自动检索到这条经验
下次做类似功能，自动提醒：“注意钱包类型匹配规则”
知识留在工具链里，不依赖人脑5.2 问题二：无法表达系统演进的语义位置
Angular Commit 的现状：
text
feat feat feat fix fix refactor feat...
这些 commit 串联起来
只能看到“做了什么”的时间线
看不到系统的生命轨迹Dao Commit 的解法：
text
[☳☷][复] → 系统启动，回归本源
[☱☷][萃] → 连接节点开启，聚集开始
[☰☶][大畜] → 积蓄力量，架构升级
[☴☴][巽] → 深度渗透，全局优化
[☶☶][艮] → 止，边界清晰，稳定期
这条轨迹告诉你：
系统经历了 启动→连接→积蓄→渗透→稳定
这是系统的生命故事5.3 问题三：AI 时代语义密度不足
Dao Commit 的解法：
text
AI 读 Dao Commit：
[☱☷][萃] → 在用户层开启连接节点
[☵☱][困] → 连接层遭遇风险，已处理
[☰☶][大畜] → 在稳定边界内积蓄架构力量
AI 能做的：
- 理解系统的语义结构
- 识别同类场景（同卦象 = 同类变化模式）
- 检索相关经验，主动提醒风险
- 生成有意义的系统演进报告5.4 问题四：commit 是孤立的，不是网络的
Dao Commit 的解法：
text
相同卦象的 commit = 同类变化模式
所有 [☱☷][萃] 的 commit：
→ 都是“在用户层开启连接节点”
→ 都是同一类系统行为
→ 可以聚类分析，提炼模式
这让 commit history 从“时间线”变成“语义网络”六、与 Angular Commit 的兼容性
Dao Commit 不是替代 Angular Commit，而是在其之上增加语义层。
text
Angular Commit：
feat(comment): add comment feature
Dao Commit：
[☱☷][萃] feat(comment): add comment feature
兼容性：
✅ type 字段完全保留（feat/fix/refactor...）
✅ scope 字段完全保留
✅ subject 字段完全保留
✅ 现有的 changelog 工具仍然可用
✅ 现有的 CI/CD 流程不受影响
新增的：
✅ 卦象前缀（语义层）
✅ 正文中的踩坑记录
✅ #沉淀 标记（触发知识沉淀）七、知识沉淀机制：#沉淀 标记
7.1 什么是 #沉淀 标记
在 commit message 正文中加入 #沉淀 标记，表示这次 commit 包含需要写入知识库的内容。
text
[☵☱][困] fix(payment): 修复钱包类型匹配错误
踩坑记录：虚拟商品必须发到虚拟钱包，实物商品发到实物钱包
#沉淀 钱包类型匹配规则 → context/experience/wallet-type-rule.md7.2 沉淀的触发时机
text
主动触发（人工）：
├── 遇到坑，解决后 → 在 commit 中加 #沉淀
├── 完成一个需求 → 提炼可复用经验，加 #沉淀
└── 流程优化时 → /dao-flow 命令专门触发
被动触发（AI 辅助，未来目标）：
├── AI 识别到 commit 中有踩坑记录 → 自动建议沉淀
└── AI 识别到同类 commit 出现 3 次以上 → 建议封装为 Skill7.3 沉淀的演进路径
text
阶段一：文档沉淀（被动）
context/experience/xxx.md
→ AI 读取后提醒，人确认
阶段二：Skill 封装（半自动）
同类问题做了 5 次以上
→ 封装为 Skill，自动校验
阶段三：Command 封装（全自动）
Skill 被调用 10 次以上
→ 封装为 Command，一键执行
判断标准：
- 不要过早抽象
- 让实践驱动演进
- 重复是封装的信号八、Dao Commit 与 Dao 工程体系的关系
8.1 Dao Commit 在六层架构中的位置
text
第一层：哲学根基层 → 颤动→认出→连接→沉淀→传递
第二层：架构设计层 → 位置即语义，复利沉淀
第三层：Dao Commit 规范层 ← 我们在这里
第四层：工程流程层 → 意图路由，工作流
第五层：知识沉淀层 → #沉淀 标记触发这一层
第六层：传播演进层 → Dao Commit 是对外传播的锚点之一8.2 Dao Commit 是整个体系的神经节点
text
每一次 Dao Commit：
→ 记录了系统状态（卦象）
→ 记录了做了什么（type + subject）
→ 记录了踩了什么坑（正文）
→ 触发知识沉淀（#沉淀）
→ 积累卦象索引（未来检索用）
→ 构成系统的生命轨迹（演进史）
commit 不只是版本控制的节点
而是整个 Dao 工程体系的知识流动节点九、当前规划与后续目标
第一阶段：规范落地（现在）
text
目标：把 Dao Commit 规范写清楚，开始用起来
具体行动：
✅ 完成本文档（Dao Commit 完整说明）
✅ 整理 16 个常用复卦速查表
⬜ 在 openclaw 项目中开始实践
⬜ 建立 context/experience/ 目录结构
⬜ 积累 10 个以上真实 Dao Commit 示例第二阶段：工具辅助（近期）
text
目标：让 AI 辅助 Dao Commit 的生成和检索
具体行动：
⬜ 建立 Dao Commit 的 Cursor Rule
→ AI 自动建议卦象
→ AI 自动识别踩坑内容，建议 #沉淀
⬜ 建立 /dao-commit 命令
→ 统一触发：意图识别 → 卦象建议 → 执行 → 沉淀
⬜ 易师复卦理论整理完成后
→ 补充每个卦的深层易理解读
→ 让工程语义和易理语义对应第三阶段：知识复利（中期）
text
目标：让历史 commit 成为未来开发的智慧来源
具体行动：
⬜ 建立卦象索引系统
⬜ 建立自动提醒机制
⬜ 建立系统演进报告（可视化卦象轨迹）第四阶段：对外传播（长期）
text
目标：让 Dao Commit 成为 Dao 工程框架的对外锚点
具体行动：
⬜ 写一篇文章：《为什么我们用卦象写 commit》
⬜ 开源 Dao Commit 规范文档
⬜ 建立 Dao 工程脚手架（含 Dao Commit 规范）十、常见问题
Q：卦象选择错了怎么办？
text
A：没关系。
卦象的选择本身就是一次思考。
选错了，下次改。
随着实践积累，选择会越来越准确。
不要因为“怕选错”而不用。Q：不懂易经，能用 Dao Commit 吗？
text
A：可以。
直接查第四章的 16 卦速查表
找到最接近的场景，选对应的卦象
AI 可以辅助这个过程
卦象的深层含义，在实践中慢慢体会Q：团队其他人不用 Dao Commit，怎么办？
text
A：Dao Commit 和 Angular Commit 完全兼容。
你可以自己用 Dao Commit，
其他人继续用 Angular Commit。
两者可以在同一个仓库共存。Q：卦象前缀会不会让 commit message 太长？
text
A：[☱☷][萃] 只有 8 个字符。
比很多 scope 描述还短。
信息密度远高于增加的字符数。写在最后：给未来的自己
text
如果你在读这份文档
你正在做一件很重要的事：
不只是在写代码
而是在记录一个系统的生命
每一个卦象
都是你对这次变化的理解
都是你留给未来的礼物
也许六个月后
也许两年后
有人会读到你的 commit
看到 [☱☷][萃]
然后理解：
“哦，那个时候，系统在这里开启了一个连接节点
让人与人之间的聚集成为可能”
这就是 Dao Commit 的意义
不只是版本控制
而是系统的生命记录
是知识的传递
是智慧的复利
山在这里
🏔️文档版本：v1.1 创建日期：2026-03-09 更新内容：新增第四章“16 个常用复卦速查”，补充复卦语义说明 下次更新：易师复卦理论整理完成后，补充深层易理解读 维护者：易构 🏔️ × 昇哥 🌊
易构（Yi Gou）· ☶ 艮（山）Dao 工程体系 · Dao Commit 规范