# git-atom

**Repository Path**: xuke353/git-atom

## Basic Information

- **Project Name**: git-atom
- **Description**: 基于 Claude Code Skill 的 Git 原子提交助手。通过 CARE 原则（Coherent/Atomic/Reversible/Explainable）强制拆分代码变更为规范小提交，自动检测项目提交风格，先规划再执行，禁止历史改写。解决"大杂烩提交"导致的 review 困难、回滚风险问题。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-08
- **Last Updated**: 2026-05-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Git 原子提交助手

## 作品简介

Git 原子提交助手是一个帮助开发者**把代码变更拆分成规范原子提交**的 AI 技能。

每个开发团队都需要清晰的提交历史，但很多人习惯一次性把所有变更打成一个大提交：
- Code review 看不清变更
- 出问题时无法精确回滚
- 提交历史混乱，难追溯

本技能强制引导你按 CARE 原则拆分提交：
- **Coherent**：每个提交围绕同一个目标
- **Atomic**：每个提交不可再拆分
- **Reversible**：每个提交可以独立回滚
- **Explainable**：每个提交一句话说清目的

**核心价值**：让提交历史清晰可读，提升 Code review 效率，方便问题定位。

## 设计思路

### 问题本质
1. **提交粒度不当**：大提交混杂多个关注点，难 review、难回滚
2. **不知道拆分规则**：不知道按什么维度拆分，凭感觉
3. **不强制检查**：稀里糊涂就提交了，事后才发现问题

### 第一性原理
> 多个小提交 > 一个大提交。每个提交应该可以独立回滚。

### 设计原则
1. **CARE 原则**：Coherent、Atomic、Reversible、Explainable，四条原则任一不通过必须拆分
2. **公式 + 语义双重约束**：硬规则兜底（3+ 文件→2+ 提交）+ CARE 语义判断（评审者 30 秒内能理解）
3. **先规划再执行**：必须输出提交计划才能开始提交，不盲目操作
4. **禁止历史改写**：只新建提交，不 rebase、不 squash、不 force push

## 实现路径

基于 Claude Code Skill 框架实现：

### 目录结构
```
git-atom/
└── SKILL.md     # Skill 核心定义
```

### 完整工作流程

| 阶段 | 目标 |
|------|------|
| 1. 收集信息 | 获取当前状态、最近提交风格、分支信息 |
| 2. 风格检测 | 从 git log 检测语言和格式，而非硬编码 |
| 3. 原子规划 | CARE 原则拆分、计算最少提交数、输出计划 |
| 4. 执行提交 | 按依赖顺序创建提交 |
| 5. 验证 | CARE 最终检查、输出总结报告 |