Communityライティング&編集github.com

Jamie-BitFlight/parallel-work

多数のサブエージェントを同時実行するためのシェイプ集 — ファンアウト&バリア、メーカー/チェッカー、生成&フィルタ、ランキング用トーナメント、根本原因調査用仮説ファンアウト、条件付き上限付きループなど。独立した複数のターゲットがあるフェーズ、1つのウィンドウでは大きすぎる・繰り返しすぎるタスク、多数ファイルへの同一編集、大規模セットのランキング・判断、複数の仮説が競合する場合、シグナルが停止を指示するまで繰り返す作業に使用。ユニットが互いの結果に依存する場合や原因が不明の場合は適用しない — まず調査し、その後並列化する。

parallel-work とは?

このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)向けに、複数のサブエージェントを効率的に並列実行するための標準化されたパターン(シェイプ)を提供します。主なシェイプには、ファンアウト&バリア(独立ユニットの一括実行と結果統合)、メーカー/チェッカー(生成と評価の分離)、生成&フィルタ(候補生成→評価による絞り込み)、トーナメント(ペア比較によるランキング)、仮説ファンアウト(根本原因調査用)、ループ・アンド・ストップ(条件付き繰り返し)があります。これらは、独立した複数のターゲットを一度に処理する場合や、1回の実行では大きすぎるタスク、多数ファイルへの同一編集、大規模セットの評価、複数の仮説検証、シグナルが停止を指示するまで繰り返す作業に適しています。各シェイプには明示的な協調コスト(バリア、マージ、評価者の分離など)が組み込まれており、ユニット間の依存関係がないことを前提としています。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Jamie-BitFlight/claude_skills/tree/main/plugins/agent-orchestration/skills/parallel-work

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

並列作業

並列性は、ユニットごとに新しいコンテキストと速度をもたらします。その代償として協調が必要です:待機するファンイン、衝突しないマージ、メーカーではない評価者。ユニットが真に独立している場合にこれを使用し、協調コストを明示的に支払います。

前提条件

  • ユニットは独立している:どのユニットも他の結果を必要とせずに開始できます。
  • ユニットが何かを把握していること。原因不明 → まず調査ディスパッチを1件送ります。
  • 書き込みは分離されている:各ユニットは異なるファイルに書き込むか、各ユニットが独自のワークツリーで実行され、そのユニットが触れたファイルのみをコミットします(仕組み:delegate/references/harness-notes/claude-code.mdの「分離」セクションを参照)。

いずれかが欠けている場合 → 直列化するか、まず調査します。

シェイプ

ファンアウト、ファンイン。 同じフェーズのN個のディスパッチを、各ユニットに1つずつ、一緒に送信します。1つの統合ディスパッチがそれらすべてを待機し(この待機がバリアです)、それらの配信ファイルを1つにマージします。各ユニットの出力はファイルに保持し、統合側はパスを読み取ります(あなたのコンテキストは読み取りません)。

機械的ファンアウト。 1つのprocessディスパッチが正確な変更を一度決定します。N個の汎用ディスパッチがそれをそのまま適用し、それぞれが自身のターゲットに対して行います。1つのreviewディスパッチがセット全体をチェックします。オーケストレーターは、たとえ小さなセットでも、自分で編集を適用することはありません。

メーカー/チェッカー。 結果を生成した者がそれを判断することはありません。reviewを別のエージェントにルーティングします — 該当ドメインにレビューアータイプのエージェントが存在する場合はそれに、そうでない場合は別の役割のスペシャリストに — 成功基準とアーティファクトパスを渡し、メーカーの推論は一切渡しません。

生成とフィルタ。 ファンアウトして候補を生成し、1つのディスパッチが重複排除とスコアリングを書かれたルーブリックに基づいて行い、生き残ったものだけが続行します。生成前にルーブリックを書きます。

トーナメント。 1つのウィンドウで判断するには大きすぎるセットをランク付けするため:ペア比較ディスパッチ(各ディスパッチは2項目を保持し、ブラケットはファイルに保持)を使用します。比較判断は絶対スコアよりも信頼性が高いです。

仮説ファンアウト。 根本原因調査用:互いに素な証拠ソース(ログ、コード、データ)ごとに1つのディスパッチが、そのソースのみから仮説を生成します。次に、仮説ごとに1つのディスパッチが反証を試みます。反証を生き残ったものが発見です。

条件付きループ。 サイズ不明の作業用:観測可能な条件が成立するまでディスパッチを繰り返します — 新しい発見がない、ゲート出力にエラーがゼロ、チェックリストファイルに未チェック項目がないなど。最初の反復の前に上限を設定します(デフォルトは5)。上限に達したら、残った内容をPARTIALとして報告します。

チェックリストファンアウト

- [ ]項目を含むマークダウンファイルは、すぐに使えるユニットリストです:未チェック項目ごとに1つのディスパッチが、DONE時に自身の行をチェックするよう指示され、「未チェック項目が残っていない」状態になるまでループします。同じファイルを指す項目は直列化します。

上限と停止条件

すべてのループとファンインは、開始前に数字が書き留められています:反復回数、再ディスパッチ回数、またはユニット数。上限に達した場合は、ユーザーにPARTIALまたはBLOCKEDを報告し、決して無言で再試行してはいけません。

永続チーム

一部のハーネスは、共有タスクリストとメッセージングを備えた長期生存エージェントチームを提供します。これらはエージェントが一貫性なく従う指示と通信オーバーヘッドを追加し、ハーネス間で移植できません。上記のシェイプはそれらを必要としません。エージェントがタスク途中でメッセージを交換する必要がある場合にのみチームを使用し、その場合はハーネスノートを参照してください。

関連リンク

  • delegate — 各ユニットが使用するプロンプトテンプレート。
  • delegate/references/harness-notes/claude-code.md — Claude Codeで同時ディスパッチを送信し、ワークツリーを分離し、長いパイプラインをワークフロースクリプトに移動する方法。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

Jamie-BitFlight/agentskill-kaizen-meta-docs

Agentskill kaizen plugin documentation index. Load when needing to read about cross-platform notes, improvement plans, or DuckDB integration.

Jamie-BitFlight/bash-51-features

Bash 5.1 release features and improvements with practical examples. Use when working with Bash 5.1 features, epoch time variables, redirection enhancements, or when user asks about Bash 5.1 changes, new features, or version-specific capabilities.

Jamie-BitFlight/bash-52-features

Bash 5.2 release features and improvements with practical examples. Use when working with Bash 5.2 features, variable handling enhancements, readline improvements, or when user asks about Bash 5.2 changes, new features, or version-specific capabilities.

Jamie-BitFlight/bash-53-features

Bash 5.3 release features and improvements with practical examples. Use when working with Bash 5.3 features, new command substitution, GLOBSORT, loadable builtins, or when user asks about Bash 5.3 changes, new features, or version-specific capabilities.

Jamie-BitFlight/bash-development

This skill should be used when the user asks to "write a bash script", "create a shell script", "implement bash function", "parse arguments in bash", "handle errors in bash", or mentions bash development, shell scripting, script templates, or modern bash patterns.

Jamie-BitFlight/bash-lint

This skill should be used when the user asks to "lint bash script", "run shellcheck", "format shell script", "use shfmt", "fix shellcheck errors", or mentions shell script linting, formatting, code quality, or pre-commit hooks for bash.

Jamie-BitFlight/bash-logging

This skill should be used when the user asks to "add logging to bash script", "colorize output", "implement log levels", "CI/CD sections", "terminal colors in bash", or mentions logging functions, emoji output, collapsible CI sections, or shlocksmith.

Jamie-BitFlight/bash-portability

This skill should be used when the user asks about "POSIX compatibility", "portable shell scripts", "cross-shell compatibility", "bashisms", "shebang selection", or mentions writing scripts that work on different shells (bash, sh, dash, zsh) or different systems.

Jamie-BitFlight/bash-testing

This skill should be used when the user asks to "test bash script", "write shell tests", "use shunit2", "use shellspec", "create test suite for bash", or mentions unit testing, test frameworks, mocking, or test-driven development for shell scripts.

Jamie-BitFlight/brainstorming-skill

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or when users request help with ideation, marketing, and strategic planning. Explores user intent, requirements, and design before implementation using research-validated prompt patterns.

Jamie-BitFlight/clang-format

Configure clang-format code formatting. Use when: user mentions clang-format or .clang-format, analyzing code style/patterns, creating/modifying formatting config, troubleshooting formatting, brace styles/indentation/spacing/alignment/pointer alignment, or codifying conventions.

Jamie-BitFlight/commitlint

When setting up commit message validation for a project. When project has commitlint.config.js or .commitlintrc files. When configuring CI/CD to enforce commit format. When extracting commit rules for LLM prompt generation. When debugging commit message rejection errors.

Jamie-BitFlight/conventional-commits

When writing a git commit message. When task completes and changes need committing. When project uses semantic-release, commitizen, git-cliff. When choosing between feat/fix/chore/docs types. When indicating breaking changes. When generating changelogs from commit history.

Jamie-BitFlight/dasel-reference

Use when querying, modifying, or converting JSON, YAML, TOML, XML, CSV, HCL, or INI with dasel v3. Complete reference for selectors, functions, conditionals, variables, spread operator, type casting, and format-specific patterns.

Jamie-BitFlight/data-exploration

Use when exploring unknown structured data files with dasel v3 — discover schema, list keys, find nested values, sample arrays, identify data types across JSON, YAML, TOML, XML, CSV, HCL, INI formats

Jamie-BitFlight/data-transformation

Use when modifying, converting, or transforming structured data with dasel v3 — in-place mutations, format conversion, batch operations, array manipulation, object construction, and merge patterns across JSON, YAML, TOML, XML, CSV, HCL, INI

Jamie-BitFlight/delegate

Decompose substantive work into phases, dispatch each phase to a sub-agent, and adjudicate what comes back. Use whenever a request asks for implementation, investigation, a fix, a review, or any change to files — including small ones — and whenever you are about to read source or run a diagnostic yourself instead of handing it off. Also use when a report from a sub-agent needs judging, when a phase needs re-dispatching, or when a user names one instance of a pattern. Does not apply when your own prompt begins "Your ROLE_TYPE is sub-agent." — then follow references/sub-agent-contract.md instead.

Jamie-BitFlight/enterprise-hibernate-hbm

Dasel v3 query patterns for Hibernate .hbm.xml mapping files — entity-table binding, Java property-to-column extraction, one-to-many set/list/bag relationship tracing, many-to-one foreign key discovery, batch scanning across 60+ HBM files. Use when querying Hibernate ORM class mappings, extracting schema metadata from Java persistence layer, or auditing entity-column relationships in enterprise legacy codebases.

Jamie-BitFlight/enterprise-installanywhere

Dasel v3 query patterns for InstallAnywhere .iap_xml installer definitions — use when querying action sequences, discovering variables, resolving platform conditions, navigating panels, or comparing installer variants. Files are 2.5+ MB, 65,000+ lines — too large for context reads, requires structural dasel queries.

Jamie-BitFlight/enterprise-maven-pom

Dasel v3 selector patterns for Maven POM XML files — use when querying dependency versions, filtering by groupId or scope, extracting module hierarchy from parent POMs, or detecting version conflicts across enterprise multi-module Java projects. Load this skill when working with pom.xml files using dasel.

関連スキル