いきなり全件やらせない。AIの一括作業を「代表5件」で試してから任せるSkill

以下の内容を `SKILL.md` として保存し、Agent Skillとして登録してください。

- 本文を省略・要約・独自変更しない
- 少数の変更や、完全な対応表どおりの処理では試運転を挟まない
- 判断が必要な項目だけを分け、明確な項目まで止めない
- 上書き、削除、公開、送信など影響が大きい操作は、試運転結果と対象件数を示してから実行する

---
name: batch-sample-dry-run
description: 多数のファイル、表の行、商品情報、文章などへ同じ変換を一括適用する前に、通常例と例外を含む代表3〜5件で試運転し、間違ったルールが全体へ広がるのを防ぐ。大量のリネーム、表記統一、データ整形、分類、文章変換など、内容を見て判断する一括作業で使う。少数の変更、完全な対応表どおりの処理、読み取りだけの集計には使わない。
---

# 一括作業の代表サンプル試運転

大量処理の速さを保ちながら、同じ間違いが全件へ広がるのを防ぐ。先頭から数件を見るのではなく、変換ルールの弱点が出そうな代表例で試す。

## 発動を判断する

次が重なる一括作業で使う。

- 同じ変換を多数の対象へ適用する。目安は10件以上だが、件数だけで機械的に決めない。
- ファイル名や内容から、分類・言い換え・補完などを判断する。
- 一つの誤解が複数件へ繰り返される可能性がある。

少数の変更、読み取りだけの集計、利用者が完全な対応表を指定した処理では、試運転を挟まず通常どおり進める。

## 代表サンプルを選ぶ

全体を読み取り、3〜5件を選ぶ。先頭順や無作為抽出だけで済ませず、該当するものから次を混ぜる。

- 最も多い形式の通常例
- 空欄、短すぎる値、情報不足
- 重複または似た項目
- 記号、数字、単位、言語など形式の違う項目
- 複数の解釈ができる項目

すべてが同じ形式なら、無理に例外を作らない。

## 元データを変えずに試す

代表サンプルについて、変更前、変更後、選んだ理由、判断が必要かを示す。この段階では元ファイルや外部サービスを変更しない。

試運転から、全件へ共通して使う変換ルールと検査条件を短くまとめる。利用者が指定していない翻訳、削除、補完、公開範囲の変更をルールへ足さない。

## 進め方を分ける

- 結果が客観的に検査でき、元に戻せる作業: 利用者が全件処理を依頼済みなら、試運転後そのまま続けてよい。
- 解釈が分かれる項目: その項目だけを`判断が必要`へ分ける。明確な項目まで止めない。
- 上書き、削除、公開、送信など影響が大きい作業: 試運転結果と対象件数を示し、実行前に了承を得る。
- 元に戻す方法がない作業: プレビューだけを作り、勝手に本処理しない。

利用者が「確認なしで進めて」と指定していても、元に戻せる作業は続行し、判断不能な値は推測で埋めず保留する。確認のためだけに全体を止めない。

## 全件処理後に検査する

作業に合う項目だけを確認する。

- 入力件数と出力件数
- 未処理、空欄、重複
- 禁止文字や形式違反
- 試運転で決めたルールから外れた項目
- 変更に失敗した項目

ファイルを変更した場合は、元に戻す方法やバックアップの場所も報告する。外部サービスへ反映した場合は、反映結果を再取得できる範囲で確認する。

## 結果を伝える

長い説明より、次の順で簡潔に示す。

1. `試運転`: 代表3〜5件の変更前→変更後
2. `このルールで進める`: 全件へ使う判断基準
3. `本処理`: そのまま処理できる件数、判断が必要な件数、実行前確認の有無
4. `処理後チェック`: 件数、重複、空欄、例外、失敗

判断が必要な項目を利用者へ聞く場合は、項目番号と選択肢をまとめる。同じ質問を一件ずつ繰り返さない。