mcpField
A
atomic-commits

atomic-commits

github.com/nullswan开发0160 次安装39 周前更新
代码仓库

关于 atomic-commits

atomic-commits 是一项面向开发者的技能，用于将多项 Git 更改整理为可独立审查的提交。它涵盖变更分析、逻辑分组、分步暂存、提交排序与历史检查。

主要功能

  1. 01检查 Git 状态和差异
  2. 02按类型对更改分组
  3. 03分步暂存并提交更改
  4. 04按风险和用途排序提交
  5. 05推送前检查提交历史

适用场景

  1. 01审查前拆分无关更改
  2. 02从混合差异整理清晰历史
  3. 03使用 git add -p 暂存部分文件

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/nullswan/atomic-commits --skill atomic-commits

安装后在 Claude Code 中输入/atomic-commits确认已加载。

附带文件references/advanced.md

详细介绍

原子提交

将多个 git 更改整理为清晰、原子的提交，以维护规范的 git 历史记录。

工作流

1. 分析更改
git status
git diff --stat
git diff
2. 按逻辑分组更改

按类型分类：

  • feat：新功能
  • fix：错误修复
  • refactor：代码改进
  • docs：文档
  • test：测试更改
  • chore：维护
3. 逐步提交

为每个逻辑提交暂存特定文件：

git add path/to/related/files
git commit -m "feat: add user authentication"

git add path/to/other/files
git commit -m "fix: correct null check in validator"
4. 推送
git log --oneline -10  # Verify commits
git push origin <branch>

提交顺序

  1. 文档（风险最低）
  2. 测试（验证设置）
  3. 错误修复（独立的修正）
  4. 功能（主要更改）
  5. 重构（改进）

提交信息格式

<type>(<scope>): <description>

[optional body]

类型：feat、fix、docs、style、refactor、test、chore

示例

假设更改涉及登录页面、头像修复、README 更新和新增测试：

git add README.md
git commit -m "docs: update README with login instructions"

git add tests/login.test.ts
git commit -m "test: add login component tests"

git add src/components/Avatar.tsx
git commit -m "fix: correct avatar display on retina screens"

git add src/pages/Login.tsx src/components/LoginForm.tsx
git commit -m "feat: add login page with validation"

git push origin feature/login

提示

  • 每个提交都应能独立审查
  • 每个提交后，代码库都应处于可正常工作的状态
  • 如有疑问，宁可多提交几次，也不要减少提交次数
  • 使用 git add -p 交互式暂存部分文件

有关高级模式，请参阅 references/advanced.md。

评论

支持 Markdown