# ssot-step11-03-builder

> Step 11-03: バッチエラー定義（外部オーケストレーター方式）

- Author: Hiroshi Kataoka
- Repository: pri-Kataoka-Hiroshi/kfc_generator2
- Version: 20260126232234
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-07
- Source: https://github.com/pri-Kataoka-Hiroshi/kfc_generator2
- Web: https://mule.run/skillshub/@@pri-Kataoka-Hiroshi/kfc_generator2~ssot-step11-03-builder:20260126232234

---

---
name: ssot-step11-03-builder
description: |
  Step 11-03: バッチエラー定義（外部オーケストレーター方式）
location: managed
---

# Step 11-03: バッチエラー定義

各バッチで発生しうるエラーとその復旧手順を定義します。

**実行方式**: 外部オーケストレーター（各バッチを独立したClaude Codeセッションで処理）

## 対象テーブル

- `batch_errors` - バッチエラー定義

## 前提条件

- Step 09-02が完了していること: `batch_master` にデータが存在すること（17件）
- Step 11-02が完了していること: `batch_step` にデータが存在すること（推奨）

## 出力ファイル

- `SSOT_db/sql/step11_03/{batch_cd}.sql` - バッチごとのSQL
- `SSOT_db/sql/step11_03.sql` - 統合SQL（`--merge` で生成）

---

## 実行方法

### 基本コマンド

```bash
# デフォルト実行（10並列）
python3 .claude/skills/ssot-step11-03-builder/scripts/orchestrate_step11_03.py

# 順次実行（安定性優先）
python3 .claude/skills/ssot-step11-03-builder/scripts/orchestrate_step11_03.py --parallel 1
```

### オプション一覧

| オプション | 説明 |
|-----------|------|
| `--parallel N` | 並列実行数（デフォルト: 10） |
| `--timeout N` | 1バッチのタイムアウト秒（デフォルト: 900秒） |
| `--dry-run` | 実行せず対象バッチのみ表示 |
| `--batches BATCH_XXX,BATCH_YYY` | 特定バッチのみ処理 |
| `--retry` | 前回失敗したバッチのみ再実行 |
| `--skip-merge` | 最終マージをスキップ |
| `-v, --verbose` | 詳細ログを出力 |

---

## サブエージェント情報

### 名前
`step11-03-batch-errors`

### 定義ファイル
`agents/step11-03-batch-errors.md`

### 役割
1バッチの情報を分析し、発生しうるエラーと復旧手順をAIが定義

---

## リターンコード一覧（mst_batch_return_code）

| return_code | severity | 説明 |
|-------------|----------|------|
| 0 | NORMAL | 正常終了 |
| 4 | WARNING | 警告終了（処理継続） |
| 8 | ERROR | 異常終了（リトライ可能） |
| 12 | ERROR | 致命的エラー |
| 16 | FATAL | システムエラー |

---

## ID採番ルール

| エンティティ | プレフィックス | 例 |
|------------|--------------|-----|
| バッチエラー | `BE_` | `BE_POINT_EXPIRE_E001` |

---

## 補助スクリプト（execute_step11_03.py）

```bash
# 未処理バッチの一覧を表示
python3 .claude/skills/ssot-step11-03-builder/scripts/execute_step11_03.py --list-pending

# バッチ情報をクエリ
python3 .claude/skills/ssot-step11-03-builder/scripts/execute_step11_03.py --batch-cd BATCH_XXX --query

# 統合SQLを生成
python3 .claude/skills/ssot-step11-03-builder/scripts/execute_step11_03.py --merge
```

---

## 次のステップ

完了後、`/step11-04` でバッチマッピング定義を実行してください。

---

## リソース

- **オーケストレーター**: `scripts/orchestrate_step11_03.py`
- **サブエージェント定義**: `agents/step11-03-batch-errors.md`
- **補助スクリプト**: `scripts/execute_step11_03.py`
- **コマンド定義**: `.claude/commands/step11-03.md`