关于 commit
commit 是一项指导会话变更 Git 提交的 Agent 技能,涵盖检查差异、规划聚焦的提交、征求确认,以及在每次提交后记录推理过程。
主要功能
- 01检查仓库状态和差异
- 02按逻辑将文件分组提交
- 03拟定祈使语气的提交信息
- 04提交前征求确认
- 05每次提交后记录推理过程
适用场景
- 01为会话中的变更制定提交计划
- 02将无关变更拆分为聚焦的提交
- 03提交后记录开发决策
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ parcadei/ continuous-claude-v3 --skill commit安装后在 Claude Code 中输入/commit确认已加载。
附带文件SKILL.v6.md
详细介绍
提交更改
你的任务是为本次会话中所做的更改创建 Git 提交。
流程:
-
了解更改内容:
- 查看对话历史,了解已完成的工作
- 运行
git status查看当前更改 - 运行
git diff了解具体修改 - 考虑将更改作为一个提交,还是拆分为多个逻辑提交
-
规划提交:
- 确定哪些文件应归入同一个提交
- 拟定清晰、描述性强的提交消息
- 使用祈使语气撰写提交消息
- 重点说明更改的原因,而不只是更改了什么
-
向用户说明计划:
- 列出每个提交计划添加的文件
- 展示将使用的提交消息
- 询问:“我计划创建 [N] 个提交,包含以下更改。是否继续?”
-
获得确认后执行:
- 使用
git add指定具体文件(切勿使用-A或.) - 使用计划好的消息创建提交
- 通过
git log --oneline -n [number]展示结果
- 使用
-
每次提交后生成推理记录:
- 运行:
bash "$CLAUDE_PROJECT_DIR/.claude/scripts/generate-reasoning.sh" <commit-hash> "<commit-message>" - 这会记录开发过程中尝试过的操作(构建失败、修复等)
- 推理文件可帮助后续会话了解过去的决策
- 文件存储在
.git/claude/commits/<hash>/reasoning.md
- 运行:
重要事项:
- 绝不要添加共同作者信息或 Claude 署名
- 提交的作者应仅为用户
- 不要包含任何“Generated with Claude”消息
- 不要添加“Co-Authored-By”行
- 提交消息应写得像是用户本人撰写的
请记住:
- 你拥有本次会话中所有工作的完整上下文
- 将相关更改归为一组
- 尽可能让提交保持聚焦且原子化
- 用户信任你的判断——他们要求你创建提交
评论
支持 Markdown