# Git Commit

> 只提交本会话改动的文件。

- Skill: `cislunarspace/git-commit` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add cislunarspace/git-commit`
- Raw SKILL.md: https://api.skillmd.com/api/skills/cislunarspace/git-commit/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: cislunarspace (https://skillmd.com/u/cislunarspace)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/cislunarspace/git-commit

---


从本会话的 `Write`、`Edit` 调用识别改动文件；不扫描会话转录或运行脚本。

## 流程

### 1. 检查

1. 从对话上下文列出本会话修改或新建的仓库文件。
2. 运行 `git worktree list` 与 `git rev-parse --abbrev-ref HEAD`，记录当前所在 worktree 与分支。会话文件路径不在当前 cwd 所在 worktree 内（典型：误指向主仓库目录）时，停止并说明——提交将落到错误分支。
3. 运行 `git diff --name-only`，识别不在该列表中的脏文件；它们属于会话外改动。
4. 运行 `git diff --stat` 和 `git diff -- <会话文件>`，确认每项改动都应提交。
5. 读取 `references/git-workflow.md`（存在时），据此起草 commit message；没有该文件则用常规格式。
6. 从对话上下文识别关联 issue（`#N` 或 issue 链接）。

会话文件为空、存在冲突，或 diff 与本会话目标不符时，停止并说明原因。

### 2. 确认并提交

1. 展示会话文件、会话外脏文件、改动摘要、当前分支和拟议 commit message。
2. 会话外脏文件存在时，询问是否纳入；默认不纳入。
3. 等用户明确确认 message 和文件范围后执行提交。
4. 使用明确路径暂存并提交：`git add <file1> <file2> ... && git commit -m "<message>"`。不使用 `git add -A` 或 `git add .`。

超过 20 个文件或改动包含多个独立关注点时，先建议拆分提交并等待决定。

### 3. 验证

运行：

```bash
git status -- <会话文件>
git log --oneline -3
git branch --show-current
```

确认已提交的会话文件不再有未提交改动，且提交落在第 1 步确认的分支上（`git branch --show-current`）。

### 4. 关联 Issue

`git-commit` 不关闭 Issue，也不修改 GitHub Project。提交时只在 commit message 中保留准确的关联引用（如 `Fixes #123` 或 `Related to #123`，按用户意图选择）。Issue 关闭和 Project 状态迁移由 `/open-pr` 与 `/github-project` 在 PR 生命周期中处理。