Git AI 助手

技能文档

---
name: ai-git-assistant
title: Git AI 助手
category: 开发工具
description: AI 驱动的 git 工作流助手，根据暂存区变更生成符合 Conventional Commits 规范的提交信息，支持提交信息评审打分、更新日志、发布说明与 PR 描述生成。写完代码要提交、要给团队出 changelog/release notes、要写 PR 描述或检查提交信息质量时使用。当用户提到生成 commit message、提交信息、变更日志、更新日志、发布说明、PR 描述、Conventional Commits 时触发。触发词：提交信息、commit、changelog、发布说明、PR 描述。
---

# Git AI 助手

AI 驱动的 git 工作流助手：从暂存区差异生成提交信息、评审提交质量、从提交历史生成更新日志、在两个标签间生成发布说明、从分支差异生成 PR 描述。

## 适用场景

- 已暂存变更，需要一条规范的提交信息
- 想评审或改进一条提交信息
- 需要从近期提交生成更新日志
- 需要两个版本之间的发布说明
- 需要为当前分支写 PR 描述
- 想查 Conventional Commits 规范

## 技能工作流

### 步骤1：配置环境（AI 命令首次使用前）

```bash
export AI_API_KEY="你的-API-Key"
# 可选：覆盖 API 地址与模型
# export AI_API_URL="https://你的兼容端点/v1/messages"
# export AI_MODEL="claude-opus-4-6"
```

依赖：`python3`、`curl`、`git`。API 地址默认指向 Anthropic Messages 兼容端点，可用 `AI_API_URL` 替换为任意兼容服务。

### 步骤2：选择命令执行

本地命令（无需 API Key）：

| 命令 | 说明 |
|---------|-------------|
| `conventions` | Conventional Commits 快速参考 |

AI 命令（需 `AI_API_KEY`）：

| 命令 | 说明 |
|---------|-------------|
| `commit` | 从暂存区变更生成提交信息 |
| `review <message>` | 评审提交信息质量并打分 |
| `changelog [--from <tag>]` | 从 git log 生成更新日志 |
| `release [--from <tag>] [--to <tag>]` | 生成两个版本间的发布说明 |
| `pr` | 从分支差异生成 PR 描述 |

### 步骤3：核对输出并使用

- `commit` 输出可直接用于 `git commit`，破坏性变更会带 `BREAKING CHANGE` 脚注。
- `review` 给出 1-10 分与逐项检查结果，低于 8 分附改写建议。
- `changelog`/`release` 输出 Markdown，按功能/修复/性能等分组，已去除提交哈希。
- `pr` 输出含 Summary、Changes、Why、Testing 四节。

## 示例

从暂存变更生成提交信息：

```bash
git add src/auth.ts src/middleware.ts
bash scripts/git-assist.sh commit
```

输出示例：

```text
feat(auth): add JWT refresh token rotation

- Implement automatic token rotation on refresh
- Add refresh token family tracking to detect reuse
- Update middleware to handle expired access tokens gracefully

BREAKING CHANGE: refresh endpoint now returns both access and refresh tokens
```

评审一条提交信息：

```bash
bash scripts/git-assist.sh review "fixed stuff"
```

其他命令：

```bash
bash scripts/git-assist.sh changelog --from v1.2.0
bash scripts/git-assist.sh release --from v1.0.0 --to v2.0.0
bash scripts/git-assist.sh pr
bash scripts/git-assist.sh conventions
```

## 安全与数据

- AI 命令会把 git diff 或提交历史发送到所配置的 API 端点做分析，响应返回后不落盘存储；`conventions` 完全本地运行。
- 技能只读 git 状态，绝不执行 `git commit`、`git push` 或任何破坏性操作。
- 临时文件自动清理，不保存任何凭据。

使用说明

# Git AI 助手

AI 驱动的 git 工作流助手：生成提交信息、评审提交质量、生成更新日志/发布说明/PR 描述。

## 使用

```bash
# 配置 API Key（AI 命令需要）
export AI_API_KEY="你的-API-Key"

# 从暂存区变更生成提交信息
git add .
bash scripts/git-assist.sh commit

# 评审提交信息
bash scripts/git-assist.sh review "fixed stuff"

# 生成更新日志与发布说明
bash scripts/git-assist.sh changelog --from v1.0.0
bash scripts/git-assist.sh release --from v1.0.0

# 生成 PR 描述
bash scripts/git-assist.sh pr

# Conventional Commits 规范速查（本地，无需 Key）
bash scripts/git-assist.sh conventions
```

## 工作原理

脚本读取 `git diff --cached` 或提交历史，配合预设提示词调用 Anthropic Messages 兼容 API 生成结果；单次输入截断至 12000 字符。全程只读仓库，不执行 commit/push 等破坏性操作，依赖 `python3`、`curl`、`git`。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。