# commit

> YAML仕様書の整合性をチェックしてからコミット・プッシュする。ドキュメント間の参照、機能ID、依存関係の整合性を検証し、問題があればコミットを中止して報告する。

- Author: kyosuke tsubo
- Repository: michel-mayonaka/game-spec-driven-development
- Version: 20260201034131
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/michel-mayonaka/game-spec-driven-development
- Web: https://mule.run/skillshub/@@michel-mayonaka/game-spec-driven-development~commit:20260201034131

---

---
name: commit
description: YAML仕様書の整合性をチェックしてからコミット・プッシュする。ドキュメント間の参照、機能ID、依存関係の整合性を検証し、問題があればコミットを中止して報告する。
allowed-tools: Read, Glob, Grep, Bash(git:*), Bash(make:*), Bash(spec-validator:*), Bash(sdd-linter:*)
---

# Commit & Push with Document Consistency Check

YAML仕様書の整合性を検証してからコミット・プッシュを実行するスキル。

## 実行フロー

```
1. 変更ファイルの確認（git status, git diff）
      ↓
2. 変更されたYAML仕様書の品質チェック
      ↓
3. @spec アノテーションの整合性チェック（tactics-proto/ 変更時のみ）
      ↓
4-A. 問題なし → コミット実行 → プッシュ実行
4-B. 問題あり → 問題報告してコミット中止
```

## Step 1: 変更ファイルの確認

```bash
git status
git diff --staged
git diff
```

## Step 2: 仕様書の品質チェック

変更されたファイルの種類に応じて、spec-validator を実行する。
**個別IDではなくカテゴリ全体を検証する**（新規ファイルでもindex更新後に検出される）。

```bash
# 変更カテゴリに応じて実行
./tools/bin/spec-validator feature   # spec/features/*/F*.yaml 変更時
./tools/bin/spec-validator scene     # spec/views/scenes/S*.yaml 変更時
./tools/bin/spec-validator ui        # spec/views/ui-components/UC*.yaml 変更時
./tools/bin/spec-validator data      # spec/config/**/*.yaml, spec/db/**/*.yaml 変更時
```

| 変更ファイル | 実行コマンド |
|-------------|-------------|
| `spec/features/*/F*.yaml` | `./tools/bin/spec-validator feature` |
| `spec/views/scenes/S*.yaml` | `./tools/bin/spec-validator scene` |
| `spec/views/ui-components/UC*.yaml` | `./tools/bin/spec-validator ui` |
| `spec/config/**/*.yaml`, `spec/db/**/*.yaml` | `./tools/bin/spec-validator data` |

## Step 3: @spec アノテーションの整合性チェック

`tactics-proto/` または `spec/` 配下のファイルが変更されている場合、sdd-linter を実行する。

```bash
cd tools && make build-linter
./tools/bin/sdd-linter all
```

## Step 4: 結果に応じた処理

### 4-A. 問題なしの場合

```bash
git add -A
git commit -m "<type>(<scope>): <description>"
git push
```

**Conventional Commits 形式**:
```
<type>(<scope>): <description>

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
```

| type | 用途 |
|------|------|
| `feat` | 新機能追加 |
| `fix` | バグ修正 |
| `docs` | ドキュメントのみの変更 |
| `refactor` | バグ修正でも機能追加でもないコード変更 |
| `chore` | ビルドプロセス、ツール、設定の変更 |

### 4-B. 問題ありの場合

```markdown
## 整合性チェック結果: 問題あり

### 検出された問題

1. **[問題の種類]**: 具体的な問題の説明
   - 場所: ファイル名:行番号
   - 詳細: どう修正すべきか

### 推奨アクション

- 上記の問題を修正してから再度 /commit を実行してください
```

## 参照ドキュメント

- 仕様書アーキテクチャ: [CLAUDE.md](../../CLAUDE.md)
- 検証ルール: [guidelines/validation/rules.yaml](../../guidelines/validation/rules.yaml)
- スキーマルール: [guidelines/validation/yaml-schema-rules.yaml](../../guidelines/validation/yaml-schema-rules.yaml)
- sdd-linterルール: [tools/README.md](../../tools/README.md)

## 注意事項

- 仕様書以外のファイルのみの変更の場合、整合性チェックはスキップ
- 警告レベルはコミット続行、エラーレベルのみブロック