Contextual Commits Skill 技能

Contextual Commits 是一种在 Git 提交信息中嵌入决策追踪记录的开源协议和技能规范，旨在为 AI 编码 Agent 的每次代码提交补充「为什么这样做」的上下文，解决传统 Conventional Commits 只记录「做了什么」而丢失决策过程的问题。

传统 AI 生成的提交信息通常仅复述代码变更内容（如「添加了 GoogleAuthProvider 类」），而 Contextual Commits 要求在提交正文中以结构化格式记录完整的决策链路，包括：

intent（意图）：说明本次修改的业务目标或功能方向 decision（决策）：记录关键方案选型及其理由 rejected（拒绝）：列出被主动放弃的备选方案及原因 constraint（约束）：记录本次修改受到的技术或业务约束条件 learned（学到）：沉淀从实践中获得的新认知

Contextual Commits 不依赖任何新工具或基础设施，只需在现有 Git 工作流中采用这一提交规范。其核心价值在于：AI 编码工具每次会话产生三类输出——代码变更（已提交到 git）、决策过程（丢失）和理解认知（丢失），该规范将后两类信息保留在提交历史中，供后续协作者和 AI Agent 查询复用。

适用场景：团队协作项目需要传承决策上下文、AI Agent 需要理解历史修改的原因而非仅看 diff、个人知识管理沉淀编程认知。

安装方式：将项目克隆到本地后，按照 README 指引配置 Git 提交模板即可使用，无需安装额外插件或依赖。