unclesam
6eda653db6
- 新增 `git air msg` 命令，支持根据暂存区或历史 Diff 自动生成 Conventional Commits 提交说明 - 支持中、英、日、韩多语言自适应及通过 CLI/配置文件/环境变量进行定制 - 完善全局配置体系，新增 `commit_lang` 选项及相关单元测试
293 lines
13 KiB
Markdown
293 lines
13 KiB
Markdown
<p align="center">
|
|
<img src="assets/logo.png" width="180" height="180" alt="git-air logo" />
|
|
</p>
|
|
|
|
<h1 align="center">git-air �鴻</h1>
|
|
|
|
<p align="center">
|
|
<strong>Go險隱槭〒譖ｸ縺九ｌ縺溘∫ｩｺ豌励�繧医≧縺ｫ霆ｽ蠢ｫ縺ｧ鬮倬溘↑Git繝阪う繝�ぅ繝泡I繧ｳ繝ｼ繝峨Ξ繝薙Η繝ｼ繝��繝ｫ縲�</strong>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="https://go.dev/"><img src="https://img.shields.io/badge/Go-1.26%2B-00ADD8?style=flat&logo=go" alt="Go Version" /></a>
|
|
<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License" /></a>
|
|
<a href="https://github.com/unclesam-ly/git-air/pulls"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" alt="PRs Welcome" /></a>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="README.md">邂菴謎ｸｭ譁�</a> |
|
|
<a href="README_EN.md">English</a> |
|
|
<a href="README_JA.md"><strong>譌･譛ｬ隱�</strong></a>
|
|
</p>
|
|
|
|
---
|
|
|
|
## �検 縺ｪ縺� git-air 繧帝幕逋ｺ縺励◆縺ｮ縺具ｼ�
|
|
|
|
### 隱ｲ鬘鯉ｼ哂I縺梧嶌縺�◆繧ｳ繝ｼ繝峨�豌玲戟縺｡縺�＞縺後√Ξ繝薙Η繝ｼ縺ｯ謔ｪ螟｢
|
|
|
|
迴ｾ莉｣縺ｮ髢狗匱縺ｧ縺ｯ縲、I��ursor縲，opilot縲∝推遞ｮLLM繝励Λ繧ｰ繧､繝ｳ�峨ｒ豢ｻ逕ｨ縺吶ｋ縺薙→縺悟ｽ薙◆繧雁燕縺ｫ縺ｪ繧翫∪縺励◆縲よ焚遘偵〒謨ｰ蜊∬｡後�謨ｰ逋ｾ陦後�繧ｳ繝ｼ繝峨′逕滓�縺輔ｌ繧九◆繧√�幕逋ｺ繧ｹ繝斐�繝峨�蜉�噪縺ｫ蜷台ｸ翫＠縺ｾ縺吶�
|
|
|
|
**縺励°縺励√◎縺薙↓縺ｯ隕矩℃縺斐○縺ｪ縺�㍾螟ｧ縺ｪ隱ｲ鬘後′蟄伜惠縺励∪縺呻ｼ�**
|
|
- **縲瑚ｦ九◆逶ｮ縺悟ｮ檎挑縺吶℃繧九阪→縺�≧骭ｯ隕�**�壹う繝ｳ繝�Φ繝医ｄ繧ｳ繝｡繝ｳ繝医∝多蜷阪′邯ｺ鮗励↑縺溘ａ縲√ヰ繧ｰ縺後↑縺�→逶ｲ菫｡縺励ｄ縺吶＞��
|
|
- **逕滓�AI閾ｪ霄ｫ縺ｮ縲瑚�蟾ｱ閧ｯ螳壹ヰ繧､繧｢繧ｹ縲�**�壼酔縺倥メ繝｣繝�ヨ蜀�〒逕滓�AI縺ｫ縲後％縺ｮ繧ｳ繝ｼ繝峨↓繝舌げ縺ｯ縺ゅｋ�溘阪→閨槭＞縺ｦ繧ゅ√悟撫鬘後↑縺丞��欧縺ｫ蜍穂ｽ懊＠縺ｾ縺呻ｼ√阪→霑斐▲縺ｦ縺上ｋ縺薙→縺悟､壹＞��
|
|
- **莠ｺ髢薙�逶ｮ縺ｧ隕玖誠縺ｨ縺励ｄ縺吶＞貎懷惠逧�↑鄂�**�啻if err != nil` 縺ｮ譌ｩ譛溘Μ繧ｿ繝ｼ繝ｳ譎ゅ↓繝ｭ繝�け隗｣髯､��utex Leak�峨ｒ蠢倥ｌ縺溘ｊ縲；oroutine 蜀�〒 `recover` 縺後↑縺九▲縺溘ｊ縲√Ν繝ｼ繝怜�縺ｧ繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺瑚ｧ｣謾ｾ縺輔ｌ縺ｪ縺九▲縺溘ｊ縺吶ｋ繝舌げ縺ｯ縲∫岼隕悶〒縺ｯ髱槫ｸｸ縺ｫ隕玖誠縺ｨ縺励ｄ縺吶＞縲�
|
|
|
|
縺昴�邨先棡縲�**縲窟I縺後さ繝ｼ繝峨ｒ螟ｧ驥冗函逕｣縺励∵ｷｱ螟懊↓莠ｺ髢薙′譛ｬ逡ｪ髫懷ｮｳ縺ｮ蟇ｾ蠢懊↓霑ｽ繧上ｌ繧九�**縺ｨ縺�≧譛ｬ譛ｫ霆｢蛟偵↑迥ｶ豕√′逕溘∪繧後∪縺吶�
|
|
|
|
---
|
|
|
|
### 隗｣豎ｺ遲厄ｼ壹Ξ繝薙Η繝ｼ繧偵Ο繝ｼ繧ｫ繝ｫ繧ｿ繝ｼ繝溘リ繝ｫ��re-Commit�峨↓螳悟�蜑咲ｽｮ
|
|
|
|
GitHub縺ｪ縺ｩ縺ｮCI/CD荳翫〒蜍穂ｽ懊☆繧九�繝�ヨ繧ょ━遘縺ｧ縺吶′縲�**`git-air` 縺ｯ繧ｳ繝ｼ繝峨ｒ `git commit` 縺吶ｋ蜑阪↓縲√Ο繝ｼ繧ｫ繝ｫ遶ｯ譛ｫ荳翫〒蜍穂ｽ懊☆繧句ｮ悟�縺ｫ迢ｬ遶九＠縺溘檎ｬｬ荳芽�屮譟ｻ蠖ｹ縲阪→縺励※險ｭ險医＆繧後※縺�∪縺吶�**
|
|
|
|
繝√Ε繝�ヨ螻･豁ｴ縺ｮ繧ｳ繝ｳ繝�く繧ｹ繝医ｒ荳蛻�賜髯､縺励√∪繧九〒**縺ゅ↑縺溘�髫｣縺ｫ蠎ｧ繧句哨縺ｯ謔ｪ縺�′逶ｮ縺ｮ驪ｭ縺�す繝九い繧｢繝ｼ繧ｭ繝�け繝�**縺ｮ繧医≧縺ｫ縲∫ｴ皮ｲ九↑蟾ｮ蛻�ｼ�git diff`�峨□縺代ｒ蜴ｳ縺励￥繝√ぉ繝�け縺励∪縺呻ｼ�
|
|
|
|
- 笞｡ **Git繝阪う繝�ぅ繝悶↑讌ｵ荳翫�謫堺ｽ懈ｧ**�壹＞縺､繧ゅ�菴懈･ｭ繝輔Ο繝ｼ繧貞ｴｩ縺輔★縲√ち繝ｼ繝溘リ繝ｫ縺ｧ `git air` 縺ｨ蜿ｩ縺上□縺代〒蜊ｳ蠎ｧ縺ｫ襍ｷ蜍輔�
|
|
- �ｧ� **荳ｻ隕√Δ繝�Ν繧貞ｮ悟�邯ｲ鄒�**��**Google Gemini 3.x縲、nthropic Claude縲』AI Grok縲．eepSeek縲＿wen縲∵匱隴� GLM縲゜imi縲√Ο繝ｼ繧ｫ繝ｫOllama縲＾penAI** 縺ｪ縺ｩ繧定ｨｭ螳壹↑縺励〒蜊ｳ蠎ｧ縺ｫ蛻�ｊ譖ｿ縺亥庄閭ｽ縲�
|
|
- �孱�� **繧ｹ繝槭�繝医↑繝弱う繧ｺ髯､蜴ｻ**�啻go.sum` 繧� `package-lock.json`縲∬�蜍慕函謌舌＆繧後◆ `*.pb.go` 繧定�蜍暮勁螟悶５oken豸郁ｲｻ繧呈椛縺医∵晁�Ν繝ｼ繝励ｒ髦ｲ縺弱∪縺吶�
|
|
- �識 **蜴ｳ譬ｼ縺ｪ繧ｷ繝九い繧ｨ繝ｳ繧ｸ繝九い蝓ｺ貅�**�壹♀荳冶ｾ槭ｄ辟｡鬧�哨縺ｯ荳蛻�↑縺励ゆｸｦ陦悟�逅��遶ｶ蜷医√ョ繝�ラ繝ｭ繝�け縲ヾQL繧､繝ｳ繧ｸ繧ｧ繧ｯ繧ｷ繝ｧ繝ｳ縲¨ULL繝昴う繝ｳ繧ｿ縲√Μ繧ｽ繝ｼ繧ｹ繝ｪ繝ｼ繧ｯ繧呈欠鞫倥＠縲∝�菴鍋噪縺ｪ菫ｮ豁｣繧ｳ繝ｼ繝峨ｒ逶ｴ謗･謠千､ｺ縺励∪縺吶�
|
|
- �投 **Token豸郁ｲｻ驥上→雋ｻ逕ｨ縺ｮ繝ｪ繧｢繝ｫ繧ｿ繧､繝�隕狗ｩ阪ｂ繧�**�壼�蜃ｺ蜉婬oken謨ｰ繧呈ｭ｣遒ｺ縺ｫ髮�ｨ医＠縲∝推遉ｾ譛譁ｰ縺ｮ蜈ｬ蠑乗侭驥題｡ｨ縺ｫ蝓ｺ縺･縺�※螳溯｡後さ繧ｹ繝医ｒ蜊ｳ蠎ｧ縺ｫ險育ｮ暦ｼ医Ο繝ｼ繧ｫ繝ｫ螳悟�繧ｪ繝輔Λ繧､繝ｳ繝｢繝�Ν縺ｯ辟｡譁呵｡ｨ遉ｺ�峨�
|
|
- 笨ｨ **AI 繧ｳ繝溘ャ繝医Γ繝�そ繝ｼ繧ｸ閾ｪ蜍慕函謌�**�壼､画峩蟾ｮ蛻�°繧� Conventional Commits 貅匁侠縺ｮ鬮伜刀雉ｪ縺ｪ繝｡繝�そ繝ｼ繧ｸ繧堤函謌撰ｼ�**譌･譛ｬ隱槭�闍ｱ隱槭�髻灘嵜隱槭�荳ｭ蝗ｽ隱�**縺ｫ閾ｪ蜍暮←蠢懶ｼ峨�
|
|
- �搭 **繝√�繝�隕冗ｴ��隱ｭ縺ｿ霎ｼ縺ｿ��.airules`��**�壹Μ繝昴ず繝医Μ逶ｴ荳九↓ `.airules` 繧帝�鄂ｮ縺吶ｋ縺�縺代〒縲√メ繝ｼ繝�蝗ｺ譛峨�繧｢繝ｼ繧ｭ繝�け繝√Ε隕冗ｴ�ｒ譛蜆ｪ蜈医〒驕ｩ逕ｨ縲�
|
|
- �ｪ� **繝ｯ繝ｳ繧ｯ繝ｪ繝�け縺ｧ Pre-commit 繝輔ャ繧ｯ蛹�**�壹さ繝槭Φ繝�1逋ｺ縺ｧGit繝輔ャ繧ｯ縺ｨ縺励※逋ｻ骭ｲ縲ょ些髯ｺ縺ｪ繧ｳ繝ｼ繝峨�繧ｳ繝溘ャ繝医ｒ譛ｪ辟ｶ縺ｫ繝悶Ο繝�け縺励∪縺吶�
|
|
|
|
---
|
|
|
|
## �箕�� 繧ｿ繝ｼ繝溘リ繝ｫ螳溯｡後う繝｡繝ｼ繧ｸ
|
|
|
|
```text
|
|
$ git air
|
|
|
|
[git-air] 繧ｳ繝ｼ繝峨Ξ繝薙Η繝ｼ荳ｭ... (Engine: gemini / gemini-3.7-flash)
|
|
笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏
|
|
#### 螟画峩讎りｦ�
|
|
繝ｦ繝ｼ繧ｶ繝ｼ隱崎ｨｼ繝上Φ繝峨Λ繝ｼ縺ｫ Redis 繧ｭ繝｣繝�す繝･螻､繧定ｿｽ蜉�縺励，ontext 縺ｮ繧ｿ繧､繝�繧｢繧ｦ繝井ｼ晄眺繧剃ｿｮ豁｣縲�
|
|
|
|
#### 隧ｳ邏ｰ繝ｬ繝薙Η繝ｼ邨先棡
|
|
- [BLOCKER] internal/service/user.go:45 - 驥榊､ｧ縺ｪ繧ｻ繧ｭ繝･繝ｪ繝�ぅ�# 迚ｹ螳壹�繝輔ぃ繧､繝ｫ縺ｮ縺ｿ繧偵Ξ繝薙Η繝ｼ
|
|
git air internal/service/chat.go
|
|
|
|
# 荳譎ら噪縺ｫ繝｢繝�Ν繧Пrovider繧呈欠螳壹＠縺ｦ螳溯｡�
|
|
git air --provider deepseek --model deepseek-chat
|
|
```
|
|
|
|
---
|
|
|
|
### 3. AI 繧ｳ繝溘ャ繝医Γ繝�そ繝ｼ繧ｸ閾ｪ蜍慕函謌� (`git air msg`)
|
|
|
|
繧ｳ繝溘ャ繝医Γ繝�そ繝ｼ繧ｸ縺ｮ菴懈�縺ｫ謔ｩ繧蠢�ｦ√�繧ゅ≧縺ゅｊ縺ｾ縺帙ｓ縲Ａgit-air` 縺後せ繝��繧ｸ繝ｳ繧ｰ縺輔ｌ縺溷ｷｮ蛻�ｒ蛻�梵縺励，onventional Commits 貅匁侠縺ｮ繝｡繝�そ繝ｼ繧ｸ繧�**螟夊ｨ隱櫁�蜍暮←蠢�**縺ｧ逕滓�縺励∪縺呻ｼ�
|
|
|
|
```bash
|
|
# 1. 繧ｷ繧ｹ繝�Β險隱槭ｒ閾ｪ蜍墓､懷�縺励※逕滓� & 蟇ｾ隧ｱ蝙九さ繝溘ャ繝�
|
|
git air msg
|
|
|
|
# 2. 闍ｱ隱槭〒逕滓��医が繝ｼ繝励Φ繧ｽ繝ｼ繧ｹ繝ｻ蝗ｽ髫帙�繝ｭ繧ｸ繧ｧ繧ｯ繝亥髄縺托ｼ�
|
|
git air msg -l en
|
|
|
|
# 3. 譌･譛ｬ隱� / 髻灘嵜隱槭〒逕滓�
|
|
git air msg -l ja
|
|
git air msg -l ko
|
|
|
|
# 4. 遒ｺ隱阪↑縺励〒逶ｴ謗･ git commit 繧貞ｮ溯｡�
|
|
git air msg -c
|
|
```
|
|
|
|
---
|
|
|
|
### 4. 繝ｯ繝ｳ繧ｿ繝�メ縺ｧ Pre-commit 繝輔ャ繧ｯ繧堤匳骭ｲ
|
|
|
|
Git 繝ｪ繝昴ず繝医Μ逶ｴ荳九〒莉･荳九ｒ螳溯｡鯉ｼ�
|
|
```bash
|
|
git air hook install
|
|
```
|
|
- **繧ｳ繝溘ャ繝郁�蜍輔ヶ繝ｭ繝�け讖溯�**�壹Ξ繝薙Η繝ｼ縺ｧ `[BLOCKER]` 驥榊､ｧ谺�髯･繧� `[REJECT]` 蛻､螳壹′讀懷�縺輔ｌ縺溷�ｴ蜷医～git-air` 縺ｯ髱槭ぞ繝ｭ縺ｮ邨ゆｺ�さ繝ｼ繝峨〒**繧ｳ繝溘ャ繝茨ｼ�git commit`�峨ｒ閾ｪ蜍慕噪縺ｫ荳ｭ譁ｭ繝ｻ繝悶Ο繝�け**縺励∪縺呻ｼ�
|
|
- **蜴ｳ譬ｼ繝｢繝ｼ繝� (`--strict`)**�啻[WARNING]` 隴ｦ蜻翫〒繧ゅさ繝溘ャ繝医ｒ繝悶Ο繝�け縺励◆縺��ｴ蜷医� `git air --strict` 繧剃ｽｿ逕ｨ��
|
|
- **荳譎ら噪縺ｪ繝悶Ο繝�け隗｣髯､**�夂ｷ頑･縺ｧ繧ｳ繝溘ャ繝医ｒ蠑ｷ蛻ｶ縺励◆縺��ｴ蜷医�縲；it 讓呎ｺ悶� `git commit --no-verify` 縺ｾ縺溘� `git air --no-block` 繧剃ｻ倅ｸ弱＠縺ｾ縺吶�
|
|
|
|
繝輔ャ繧ｯ繧定ｧ｣髯､縺吶ｋ蝣ｴ蜷茨ｼ�
|
|
```bash
|
|
git air hook uninstall
|
|
```
|
|
|
|
---
|
|
|
|
## 笞呻ｸ� 險ｭ螳壹�蜆ｪ蜈磯��ｽ�
|
|
|
|
1. **繧ｳ繝槭Φ繝峨Λ繧､繝ｳ蠑墓焚** (`--key`, `--model`, `--provider`, `--prompt`, `--lang`, `--price-input`, `--price-output`, `--strict`, `--no-block`)
|
|
2. **迺ｰ蠅�､画焚** (`GIT_AIR_API_KEY`, `GIT_AIR_PROVIDER`, `GIT_AIR_MODEL`, `GIT_AIR_COMMIT_LANG`)
|
|
3. **繝励Ο繧ｸ繧ｧ繧ｯ繝亥句挨險ｭ螳�** (繝ｪ繝昴ず繝医Μ逶ｴ荳九� `./config.yaml` 縺ｾ縺溘� `./.git-air.yaml`)
|
|
4. **繧ｰ繝ｭ繝ｼ繝舌Ν險ｭ螳�** (`~/.git-air/config.yaml`)
|
|
|
|
### `config.yaml` 險ｭ螳壹ヵ繧｡繧､繝ｫ萓具ｼ�
|
|
```yaml
|
|
# 繝励Ο繝舌う繝繝ｼ: gemini, claude, grok, deepseek, qwen, zhipu, moonshot, siliconflow, ollama, openai, custom
|
|
provider: "gemini"
|
|
api_key: "YOUR_API_KEY_HERE"
|
|
model: "gemini-3.7-flash"
|
|
|
|
# 繧ｫ繧ｹ繧ｿ繝� API 繧ｨ繝ｳ繝峨�繧､繝ｳ繝� (莉ｻ諢�)
|
|
# base_url: "https://api.deepseek.com/v1"
|
|
|
|
# 繧ｫ繧ｹ繧ｿ繝� System Prompt (莉ｻ諢�)
|
|
# custom_prompt: ""
|
|
|
|
# 繧ｫ繧ｹ繧ｿ繝� Token 譁咎≡險ｭ螳� (莉ｻ諢上∝腰菴�: 邀ｳ繝峨Ν / 1M Tokens)
|
|
# price_input: 0.75
|
|
# price_output: 3.75
|
|
|
|
# AI 繧ｳ繝溘ャ繝医Γ繝�そ繝ｼ繧ｸ險隱櫁ｨｭ螳� (莉ｻ諢�: auto, zh, en, ja, ko)
|
|
# commit_lang: "auto"
|
|
```LLM縺ｮ繧ｨ繝ｳ繝峨�繧､繝ｳ繝医→謗ｨ螂ｨ繝｢繝�Ν繧呈ｨ呎ｺ悶�繝ｪ繧ｻ繝�ヨ縺励※縺�∪縺吶Ａ--provider` 繧呈欠螳壹☆繧九□縺代〒邁｡蜊倥↓蛻�ｊ譖ｿ縺医ｉ繧後∪縺呻ｼ�
|
|
|
|
```bash
|
|
# 1. Google Gemini (謗ｨ螂ｨ: 鬮倬溘�菴弱さ繧ｹ繝�)
|
|
git air config set --provider gemini --key "YOUR_KEY"
|
|
|
|
# 2. Anthropic Claude (Claude-3.7 / 3.5 Sonnet)
|
|
git air config set --provider claude --key "YOUR_KEY" --model anthropic/claude-3.7-sonnet
|
|
|
|
# 3. xAI Grok (Grok-2 / Grok-3)
|
|
git air config set --provider grok --key "YOUR_KEY" --model grok-2-latest
|
|
|
|
# 4. DeepSeek (鬮伜ｺｦ縺ｪ謗ｨ隲悶�諤晁�Δ繝�Ν)
|
|
git air config set --provider deepseek --key "YOUR_KEY" --model deepseek-chat
|
|
|
|
# 5. SiliconFlow (DeepSeek-V3 鬮倬溘�繧ｹ繝�ぅ繝ｳ繧ｰ)
|
|
git air config set --provider siliconflow --key "YOUR_KEY" --model deepseek-ai/DeepSeek-V3
|
|
|
|
# 6. 騾夂ｾｩ蜊�撫 (Qwen / Alibaba Cloud)
|
|
git air config set --provider qwen --key "YOUR_KEY" --model qwen-plus
|
|
|
|
# 7. 譎ｺ隴� AI (GLM-4)
|
|
git air config set --provider zhipu --key "YOUR_KEY" --model glm-4-plus
|
|
|
|
# 8. Moonshot AI (Kimi)
|
|
git air config set --provider moonshot --key "YOUR_KEY"
|
|
|
|
# 9. Groq (雜�ｫ倬滓耳隲�)
|
|
git air config set --provider groq --key "YOUR_KEY" --model llama-3.3-70b-versatile
|
|
|
|
# 10. OpenRouter (繝槭Ν繝√Δ繝�Ν邨ｱ蜷医ご繝ｼ繝医え繧ｧ繧､)
|
|
git air config set --provider openrouter --key "YOUR_KEY"
|
|
|
|
# 11. 繝ｭ繝ｼ繧ｫ繝ｫ螳悟�繧ｪ繝輔Λ繧､繝ｳ繝ｻ繝励Λ繧､繝舌す繝ｼ驥崎ｦ� (Ollama)
|
|
git air config set --provider ollama --model qwen2.5-coder
|
|
|
|
# 12. OpenAI 蜈ｬ蠑� (GPT-4o / o3-mini)
|
|
git air config set --provider openai --key "YOUR_KEY" --model gpt-4o-mini
|
|
|
|
# 13. 繧ｫ繧ｹ繧ｿ繝� Token 譁咎≡險ｭ螳� (莉ｻ諢擾ｼ夂ｵ�∩霎ｼ縺ｿ譁咎≡陦ｨ繧剃ｸ頑嶌縺阪∝腰菴�: 邀ｳ繝峨Ν/1M Tokens)
|
|
git air config set --price-input 0.75 --price-output 3.75
|
|
```
|
|
|
|
迴ｾ蝨ｨ縺ｮ險ｭ螳壹ｒ遒ｺ隱搾ｼ医き繧ｹ繧ｿ繝�譁咎≡繧��繧ｹ繧ｯ蛹訪ey繧貞性繧�会ｼ�
|
|
```bash
|
|
git air config get
|
|
```
|
|
|
|
---
|
|
|
|
### 2. 繧医￥菴ｿ縺�Ξ繝薙Η繝ｼ繧ｳ繝槭Φ繝�
|
|
|
|
```bash
|
|
# 迴ｾ蝨ｨ繧ｹ繝��繧ｸ繝ｳ繧ｰ縺輔ｌ縺滂ｼ�it add貂医∩�牙､画峩繧偵Ξ繝薙Η繝ｼ�医ョ繝輔か繝ｫ繝茨ｼ�
|
|
git air
|
|
|
|
# 逶ｴ蜑阪�繧ｳ繝溘ャ繝亥�螳ｹ繧偵Ξ繝薙Η繝ｼ
|
|
git air HEAD~1
|
|
|
|
# 繝悶Λ繝ｳ繝�俣縺ｮ蟾ｮ蛻�ｒ繝ｬ繝薙Η繝ｼ
|
|
git air main..feature-agent
|
|
|
|
# 迚ｹ螳壹�繝輔ぃ繧､繝ｫ縺ｮ縺ｿ繧偵Ξ繝薙Η繝ｼ
|
|
git air internal/service/chat.go
|
|
|
|
# 荳譎ら噪縺ｫ繝｢繝�Ν繧Пrovider繧呈欠螳壹＠縺ｦ螳溯｡�
|
|
git air --provider deepseek --model deepseek-chat
|
|
```
|
|
|
|
---
|
|
|
|
### 3. 繝ｯ繝ｳ繧ｿ繝�メ縺ｧ Pre-commit 繝輔ャ繧ｯ繧堤匳骭ｲ
|
|
|
|
Git 繝ｪ繝昴ず繝医Μ逶ｴ荳九〒莉･荳九ｒ螳溯｡鯉ｼ�
|
|
```bash
|
|
git air hook install
|
|
```
|
|
- **繧ｳ繝溘ャ繝郁�蜍輔ヶ繝ｭ繝�け讖溯�**�壹Ξ繝薙Η繝ｼ縺ｧ `[BLOCKER]` 驥榊､ｧ谺�髯･繧� `[REJECT]` 蛻､螳壹′讀懷�縺輔ｌ縺溷�ｴ蜷医～git-air` 縺ｯ髱槭ぞ繝ｭ縺ｮ邨ゆｺ�さ繝ｼ繝峨〒**繧ｳ繝溘ャ繝茨ｼ�git commit`�峨ｒ閾ｪ蜍慕噪縺ｫ荳ｭ譁ｭ繝ｻ繝悶Ο繝�け**縺励∪縺呻ｼ�
|
|
- **蜴ｳ譬ｼ繝｢繝ｼ繝� (`--strict`)**�啻[WARNING]` 隴ｦ蜻翫〒繧ゅさ繝溘ャ繝医ｒ繝悶Ο繝�け縺励◆縺��ｴ蜷医� `git air --strict` 繧剃ｽｿ逕ｨ��
|
|
- **荳譎ら噪縺ｪ繝悶Ο繝�け隗｣髯､**�夂ｷ頑･縺ｧ繧ｳ繝溘ャ繝医ｒ蠑ｷ蛻ｶ縺励◆縺��ｴ蜷医�縲；it 讓呎ｺ悶� `git commit --no-verify` 縺ｾ縺溘� `git air --no-block` 繧剃ｻ倅ｸ弱＠縺ｾ縺吶�
|
|
|
|
繝輔ャ繧ｯ繧定ｧ｣髯､縺吶ｋ蝣ｴ蜷茨ｼ�
|
|
```bash
|
|
git air hook uninstall
|
|
```
|
|
|
|
---
|
|
|
|
## 笞呻ｸ� 險ｭ螳壹�蜆ｪ蜈磯��ｽ�
|
|
|
|
1. **繧ｳ繝槭Φ繝峨Λ繧､繝ｳ蠑墓焚** (`--key`, `--model`, `--provider`, `--prompt`, `--price-input`, `--price-output`, `--strict`, `--no-block`)
|
|
2. **迺ｰ蠅�､画焚** (`GIT_AIR_API_KEY`, `GIT_AIR_PROVIDER`, `GIT_AIR_MODEL`)
|
|
3. **繝励Ο繧ｸ繧ｧ繧ｯ繝亥句挨險ｭ螳�** (繝ｪ繝昴ず繝医Μ逶ｴ荳九� `./config.yaml` 縺ｾ縺溘� `./.git-air.yaml`)
|
|
4. **繧ｰ繝ｭ繝ｼ繝舌Ν險ｭ螳�** (`~/.git-air/config.yaml`)
|
|
|
|
### `config.yaml` 險ｭ螳壹ヵ繧｡繧､繝ｫ萓具ｼ�
|
|
```yaml
|
|
# 繝励Ο繝舌う繝繝ｼ: gemini, claude, grok, deepseek, qwen, zhipu, moonshot, siliconflow, ollama, openai, custom
|
|
provider: "gemini"
|
|
api_key: "YOUR_API_KEY_HERE"
|
|
model: "gemini-3.7-flash"
|
|
|
|
# 繧ｫ繧ｹ繧ｿ繝� API 繧ｨ繝ｳ繝峨�繧､繝ｳ繝� (莉ｻ諢�)
|
|
# base_url: "https://api.deepseek.com/v1"
|
|
|
|
# 繧ｫ繧ｹ繧ｿ繝� System Prompt (莉ｻ諢�)
|
|
# custom_prompt: ""
|
|
|
|
# 繧ｫ繧ｹ繧ｿ繝� Token 譁咎≡險ｭ螳� (莉ｻ諢上∝腰菴�: 邀ｳ繝峨Ν / 1M Tokens)
|
|
# price_input: 0.75
|
|
# price_output: 3.75
|
|
```
|
|
|
|
---
|
|
|
|
## �搭 繝√�繝�隕冗ｴ��繧ｫ繧ｹ繧ｿ繝槭う繧ｺ��.airules`��
|
|
|
|
繝ｪ繝昴ず繝医Μ縺ｮ繝ｫ繝ｼ繝医ョ繧｣繝ｬ繧ｯ繝医Μ縺ｫ `.airules` 繝輔ぃ繧､繝ｫ繧剃ｽ懈�縺吶ｋ縺ｨ縲、I 縺ｯ縺昴�繝ｫ繝ｼ繝ｫ繧呈怙蜆ｪ蜈井ｺ矩��→縺励※驕ｩ逕ｨ縺励∪縺呻ｼ�
|
|
|
|
```markdown
|
|
# 繝√�繝�蜈ｱ騾夐幕逋ｺ繝ｫ繝ｼ繝ｫ
|
|
1. 縺吶∋縺ｦ縺ｮ SQL 蜃ｦ逅�� DAO 螻､縺ｫ髮�ｴ�＠縲∵枚蟄怜�邨仙粋縺ｫ繧医ｋ逕� SQL 縺ｯ遖∵ｭ｢縺ｨ縺吶ｋ��
|
|
2. 荳ｦ陦悟�逅�〒蜈ｱ譛牙､画焚繧呈桶縺��ｴ蜷医�縲《ync.RWMutex 縺ｾ縺溘� sync/atomic 繧剃ｽｿ逕ｨ縺吶ｋ縺薙→��
|
|
3. 繧ｪ繝ｼ繝励Φ縺励◆繝ｪ繧ｽ繝ｼ繧ｹ��B rows縲？TTP 繝ｬ繧ｹ繝昴Φ繧ｹ縲√ヵ繧｡繧､繝ｫ�峨� defer Close() 縺ｧ遒ｺ螳溘↓隗｣謾ｾ縺吶ｋ縺薙→��
|
|
4. error 繧偵い繝ｳ繝繝ｼ繧ｹ繧ｳ繧｢�� = err�峨〒辟｡譚｡莉ｶ縺ｫ辟｡隕悶☆繧九％縺ｨ繧堤ｦ∵ｭ｢縺吶ｋ縲�
|
|
```
|
|
|
|
---
|
|
|
|
## �孱�� 繧ｫ繧ｹ繧ｿ繝�髯､螟冶ｨｭ螳夲ｼ�.airignore`��
|
|
|
|
邨�∩霎ｼ縺ｿ縺ｮ閾ｪ蜍暮勁螟厄ｼ医Ο繝�け繝輔ぃ繧､繝ｫ繧�ヰ繧､繝翫Μ�峨↓蜉�縺医√Μ繝昴ず繝医Μ逶ｴ荳九↓ `.airignore` 繧帝�鄂ｮ縺吶ｋ縺薙→縺ｧ縲∽ｻｻ諢上�繝輔ぃ繧､繝ｫ繧�ョ繧｣繝ｬ繧ｯ繝医Μ繧但I繝ｬ繝薙Η繝ｼ縺九ｉ髯､螟悶〒縺阪∪縺呻ｼ�
|
|
|
|
```gitignore
|
|
# 繝峨く繝･繝｡繝ｳ繝医ｄ險ｭ險域嶌繧帝勁螟�
|
|
docs/
|
|
*.md
|
|
|
|
# 繝�せ繝医Δ繝�け繧�ム繝溘�繝��繧ｿ繧帝勁螟�
|
|
tests/mock/
|
|
testdata/
|
|
|
|
# 讖溷ｯ�ｨｭ螳壹ヵ繧｡繧､繝ｫ繧帝勁螟�
|
|
*.env
|
|
secrets.yaml
|
|
```
|
|
|
|
---
|
|
|
|
## �塘 繝ｩ繧､繧ｻ繝ｳ繧ｹ
|
|
|
|
譛ｬ繝励Ο繧ｸ繧ｧ繧ｯ繝医� [MIT 繝ｩ繧､繧ｻ繝ｳ繧ｹ](LICENSE) 縺ｮ繧ゅ→縺ｧ蜈ｬ髢九＆繧後※縺�∪縺吶�ssue 繧� Pull Request 繧ょ､ｧ豁楢ｿ弱〒縺呻ｼ�
|