Run multi-file batch operations with parallel agents and structured progress reporting. Use when processing multiple skills, files, or components in a single session with quality gates and branch-first discipline.
並列AIエージェントを活用した大規模バッチ操作のワークフロー。コスモス化移行のふりかえりで実証された3つの実践を体系化：ブランチファースト規律、3エージェント並列実行（作業2 + レビュー1）、5分間隔の報連相。
このスキルを使う場面：
使わない場面：
github-pr-workflow — バッチ完了後のPR作成（Step 5）git-commit-practices — バッチコミットのフォーマットgit-initial-setup — このワークフローが尊重するブランチ保護furikaeri-practice — このワークフローを生み出したふりかえりgh) — gh auth status で確認general-purpose と code-review エージェントタイプ）git switch -c が最初のコマンド。変更作業の前にフィーチャーブランチを作成する。これは交渉不可のゲート。
すべてのバッチ操作の開始時に使用。必ず最初に実行するステップ。
Values: 基礎と型 — ブランチが基盤。ブランチなければ作業なし。
# クリーンな状態を確認
git status --short
# フィーチャーブランチを作成・切替
git switch -c feature/<操作の概要>
命名規則：
feature/cosmos-migration-phase-2 — 新機能・移行refactor/modernize-wpf-skills — 構造改善fix/validate-frontmatter-all — バッチバグ修正ゲート: git switch -c が失敗したら（ワーキングツリーが汚れている）、stashまたはコミットしてから進む。mainでは絶対に進めない。
バッチをSQL todosで追跡可能な単位に分解する。並列実行のために2〜3アイテムずつのバッチにグループ化。
作業の全体スコープを把握した後に使用。エージェント起動前に必ず実行。
Values: 温故知新 — 過去の経験から、追跡されないバッチ作業は漏れや重複を招く。
-- 全作業アイテムを登録
INSERT INTO todos (id, title, description, status) VALUES
('skill-a', 'スキルA モダン化', 'フロントマター更新、JA追加、バリデーション', 'pending'),
('skill-b', 'スキルB モダン化', 'フロントマター更新、JA追加、バリデーション', 'pending'),
('skill-c', 'スキルC モダン化', 'フロントマター更新、JA追加、バリデーション', 'pending');
-- 依存関係を定義（必要に応じて）
INSERT INTO todo_deps (todo_id, depends_on) VALUES
('skill-c', 'skill-a'); -- CはAに依存
-- バッチにグループ化
-- バッチ1: skill-a + skill-b（独立、並列化可能）
-- バッチ2: skill-c（skill-aに依存）
バッチ分割ルール：
バッチごとに作業エージェント2 + レビューエージェント1を起動。作業者が変更を実行し、レビュー担当が完了した作業を検証。
バッチの実行準備ができたら使用。これがコアの処理ステップ。
Values: 成長の複利 — 並列実行がスループットを倍増。レビューエージェントが品質の複利を保証する。速度だけでなく。
エージェント構成：
作業Agent 1 (general-purpose) ──→ アイテムA ──→ 完了
作業Agent 2 (general-purpose) ──→ アイテムB ──→ 完了
レビューAgent (code-review) ──→ A & B を検証
実行フロー：
mode: "sync" タスクとして起動done にマークUPDATE todos SET status = 'in_progress' WHERE id IN ('skill-a', 'skill-b');
-- エージェント完了後：
UPDATE todos SET status = 'done' WHERE id IN ('skill-a', 'skill-b');
5分間隔で進捗を報告。報連相プロトコルで作業の可視性を保ちつつ、エージェントをブロックしない。
バッチ実行が5分を超える場合に使用。全体を通じて可視性を維持。
Values: 継続は力 — 継続的な小さな報告が信頼を築き、問題を早期に発見する。毎回の更新で止まることは、持続的な作業の複利効果を無駄にする。
報連相プロトコル：
| 種類 | 説明 | アクション | タイミング | |------|------|-----------|----------| | 報告 | 状況を共有 | 作業を止めない | 5分ごと or バッチ完了時 | | 連絡 | 事実・変化を共有 | 作業を止めない | 予期しないことが起きた時 | | 相談 | 方向性を確認 | 作業を止めて確認 | 判断が必要な時 |
判断ルール：
完了したバッチをConventional Commitsでコミットし、PRを作成。
全バッチ完了かつレビューエージェントの検証後に使用。
Values: ニュートラルな視点 — 各コミットがレビュー可能な単位。PRが全体のストーリーを伝える。
バッチ単位のコミット：
git add <バッチ1のファイル>
git commit -m "refactor(scope): アイテムA・Bをモダン化
- フロントマターをnested metadata形式に更新
- JA版を追加（バイリンガル対応）
- バリデーション ≥90% PASS
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>"
最終確認：
-- 全アイテムがdoneか確認
SELECT id, status FROM todos WHERE status != 'done';
-- 0行が返るべき
PR作成： github-pr-workflow スキルに委譲、または gh pr create を直接使用。
ブランチステップのスキップ
修正: git switch -c を文字通り最初のコマンドにする。例外なし。
バッチの過積載 修正: バッチは2〜3アイテムに保つ。4以上の並列エージェントは品質を下げる。
毎回の報告で作業を止める 修正: デフォルトは報告/連絡。相談のみ停止が必要。
レビューエージェントなし 修正: 常にcode-reviewエージェントを1つ含める。品質なき速度はやり直しを生む。
一括コミット 修正: バッチ単位でコミット。アトミックなコミットがロールバックとレビューを容易にする。
1. [ ] `git switch -c feature/xxx`
2. [ ] SQL todosに依存関係付きで登録
3. [ ] バッチにグループ化（2-3アイテム）
4. [ ] 作業エージェントのプロンプト準備
5. [ ] レビューエージェントの基準定義
| 状況 | 種類 | アクション | |------|------|-----------| | バッチ正常完了 | 報告 | 進捗報告、続行 | | 予期しないファイル形式発見 | 連絡 | 通知、適応、続行 | | 3+アイテム同じ失敗 | 相談 | 停止、ユーザーに確認 | | スコープが予想より大きい | 相談 | 停止、新スコープ確認 | | 1アイテム失敗 | 連絡 | 通知、スキップ、続行 |
┌─────────────────────────────────────────┐
│ バッチコントローラー │
│（あなた — ワークフローを統制） │
├──────────┬──────────┬───────────────────┤
│ 作業者1 │ 作業者2 │ レビュー担当 │
│ (gen-p) │ (gen-p) │ (code-review) │
│ アイテムA │ アイテムB │ A & B を検証 │
└──────────┴──────────┴───────────────────┘
Q: 1セッションで何アイテム処理できる？ A: コスモス化移行で22アイテムまでテスト済み。2〜3個のバッチ＋5分報連相で管理可能だった。
Q: レビューエージェントが問題を見つけたら？ A: 特定の問題に対して修正エージェントを起動、その後修正ファイルのみ再レビュー。
Q: 作業エージェントを3つ以上使える？ A: 非推奨。作業2＋レビュー1がテスト済みのスイートスポット。エージェント増加はコンテキスト混乱とコンフリクトを増やす。
Q: git checkout -b ではなく git switch -c を使う理由は？
A: git switch -c はモダンなGitコマンド（2.23+）。このワークフローはこれを標準とする。
Q: アイテムが外部依存でブロックされたら？
A: SQLで blocked にマーク、descriptionにメモ、バッチからスキップ。バッチ完了後に対処。
npx skills add RyoMurakami1983/agent-batch-workflow下载完整 Skill 目录，包含 SKILL.md 及所有相关文件
Search for places (restaurants, cafes, etc.) via Google Places API proxy on localhost.
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Start voice calls via the OpenClaw voice-call plugin.
Notion API for creating and managing pages, databases, and blocks.
Gemini CLI for one-shot Q&A, summaries, and generation.
Category:developer