Agentic R&D ワークフロー
この自己完結型スキルパッケージを使用して、現在のワークスペース内でマークダウン優先のマルチエージェントラボラトリーワークフローを自動化します。
これは Agent Laboratory パターンを汎用化したものです。独立したエビデンスレビュー、協調的な計画立案、タスクの実行または調査、結果分析、品質レビュー、最終レポート作成を行います。科学的な研究に限定されません。製品、ビジネス、技術、戦略、法務、コンプライアンス、セキュリティ、UX、市場、運用の各ユースケースにも同じラボワークフローを適用できます。
スキル互換のコーディングエージェント向けに設計されており、ファイルシステムへのアクセスを必要とします。環境がサポートする場合は実際の並列サブエージェントを優先し、実際のサブエージェントが利用できない場合にのみ、分離されたシミュレーションパスを使用します。
パッケージ内容
SKILL.md: アクティベーションルールとコア動作手順。references/generalized-lab-model.md: 汎用 Agent Laboratory モデルとユースケースマッピング。references/workflow.md: 完全なフェーズシーケンスと承認ゲート。references/agent-roles.md: 専門家ロール選択ガイダンス。references/quality-rules.md: エビデンス、不確実性、レビュー、安全性の基準。references/implementation-notes.md: インストール、スキャフォールド、サブエージェント、ファイル処理に関する注意事項。references/example-run.md: 期待されるファイルトレイルと出力品質を示すコンパクトなエンドツーエンドの例。assets/templates/: すべてのワークフローファイル用のマークダウンテンプレート。scripts/init-rd-workflow.mjs: オプションのスキャフォールドスクリプト。scripts/validate-skill.mjs: 公開スキルパッケージのリポジトリバリデーション。
最初のアクション
- 現在のワークスペースに
project-brief.mdがないか確認します。 - 存在する場合は、他のワークフローステップの前に完全に読み込みます。
- 存在せず、ユーザーから十分なコンテキストが提供されている場合は、
assets/templates/project-brief.mdを使用して作成します。 - 重要なコンテキストが不足している場合は、最小限のブロッキング質問のみをユーザーに尋ねます。
- ブリーフが存在したら、通常のワークフローフェーズ間で許可を求めずに続行します。
scripts/init-rd-workflow.mjs を実行して project-brief.md と必要な work/ ファイルをスキャフォールドします。このスクリプトは work/06-final-output.md を作成してはいけません。
必要な出力
アクティブなワークスペースに以下の構造を作成し、使用します:
work/
├── 00-lab-notes.md
├── 01-orchestration-plan.md
├── 02-specialist-outputs/
├── 03-team-collaboration.md
├── 04-cross-review-notes.md
├── 05-stage-gate-review.md
└── 06-final-output.md
各ワークフローフェーズは特定の出力パスにマッピングされます。番号付きのラボフェーズ（エビデンスレビュー、計画策定、実行、結果分析）は個別のファイルではありません。これらは work/02-specialist-outputs/ 内の専門家ごとに1ファイルとして具体化されます。
| フェーズ | 出力パス |
|---|---|
| ラボセットアップ | work/00-lab-notes.md |
| オーケストレーション | work/01-orchestration-plan.md |
| エビデンスレビュー、計画、実行、結果（専門家ごとに1ファイル） | work/02-specialist-outputs/NN-<role>.md |
| チームコラボレーション（オーケストレーターが統合） | work/03-team-collaboration.md |
| 相互レビュー | work/04-cross-review-notes.md |
| ステージゲートレビュー | work/05-stage-gate-review.md |
| 最終統合 | work/06-final-output.md |
work/05-stage-gate-review.md が Approved となるまで、work/06-final-output.md を作成または書き込んではいけません。
ワークフロー
references/workflow.mdを読んで正規のフェーズシーケンスを確認します。references/generalized-lab-model.mdを読んでユーザーのユースケースをラボフェーズにマッピングします。- 専門家を選択する前に
references/agent-roles.mdを読みます。 - 相互レビュー、ステージゲートレビュー、最終統合の前に
references/quality-rules.mdを読みます。 - スクリプトの使用、サブエージェントの動作、ファイル処理の詳細については
references/implementation-notes.mdを参照します。 - 生成されるワークフローファイルには
assets/templates/のテンプレートを使用します。 - 期待される出力品質について不明な点がある場合は、
references/example-run.mdを参照して、完成したエンドツーエンドの例を確認します。
ブリーフに合わせてスケーリング
ワークフローの重みをブリーフに合わせて調整します。小さな質問に対して完全なマルチウェーブラボを実行しないでください。
- 些細なブリーフ: オーケストレーターはサブエージェントなしで単一のインラインパスを実行しても構いません。エビデンス、前提条件、リスクを
work/00-lab-notes.mdに記録し、短いwork/05-stage-gate-review.mdのセルフチェックを書き、その後work/06-final-output.mdを作成します。この層では、中間の専門家、コラボレーション、相互レビューファイルはオプションです。ステージゲートルールは引き続き有効です。05-stage-gate-review.mdがApprovedとなるまで06-final-output.mdを書き込まないでください。 - 小規模または限定的なブリーフ: 1～2人の専門家を使用し、1ウェーブ実行し、個別のやり取りではなくオーケストレーターのメモにコラボレーションを組み込みます。相互レビュー、ステージゲートレビュー、最終統合はそれぞれ1回のクイックパスとして扱います。
- 中規模ブリーフ: 1～2ウェーブで少数の専門家を使用し、軽いチームコラボレーションステップを設けます。
- 大規模または規制対象のブリーフ: 完全なフェーズシーケンス、複数ウェーブ、明示的なチームコラボレーション、該当するレビューロールを使用します。
サイズに関係なく、必須の最小限は常に維持します。エビデンス/コンテキストレビュー、計画策定、実行または調査、結果分析、リスク/前提条件のカバレッジ、最終統合前のステージゲート品質ゲートです。その他はすべてオプションであり、成果物に実質的な変更をもたらす場合にのみ追加します。スケーリングの詳細は references/generalized-lab-model.md を参照してください。
実行ルール
- ブリーフを適切にカバーする最小限の専門家ロールを選択します。
- 常にエビデンス/コンテキストレビュー、計画策定、実行または調査、結果分析、リスク/前提条件のカバレッジを含めます。
- 実際の並列サブエージェントを優先します。これはこのスキルの主要な実行モデルであり、オプションの拡張機能ではありません。
- 各フェーズでは、結果を待つ前にすべての独立した専門家を起動します。並列サブエージェントが利用可能な場合、独立した専門家を1つずつ実行しないでください。
- それ以外の場合は、専門家を分離されたパスとしてシミュレートします。各パスは、自身のファイルを書き込む前に、ブリーフ、オーケストレーションプラン、および割り当てられたスコープのみを読み込む必要があります。
- 専門家の分析、相互レビュー、ステージゲートレビュー、最終統合を1つの応答にまとめないでください。
- 独立した専門家の作業は並列化しますが、依存関係ゲートは順次に保ちます。レビューの前に計画、計画の前に実行、実行の前に結果分析、レビューの前に最終レポート。
- 事実の主張には、情報源が利用可能な場合は引用またはソースノートを要求します。
- 裏付けのない主張は、前提条件または推論としてマークします。
- 不確実性と規制ドメインレビューの境界を保持します。
コラボレーションチームプロトコル
- サブエージェントを、切断されたレポート作成者ではなく、協力するチームとして扱います。
- マスターオーケストレーターは、
work/01-orchestration-plan.mdでチームの役割、所有権、依存関係、コラボレーションルールを定義します。 - 各サブエージェントは自身の専門家出力ファイルのみを書き込み、その結果として、質問、依存関係、不一致、ハンドオフノートをオーケストレーターに返します（共有ファイルを編集するのではなく、結果として）。
- オーケストレーターは、返されたこれらのノートを
work/03-team-collaboration.mdに統合します。複数のサブエージェントが同時に同じファイルを書き込んではいけません。 - チームは相互レビューの前に、共有された前提条件を調整する必要があります。
- 相互レビューでは、専門家の出力とチームコラボレーション記録の両方を評価します。
- 最終統合には、解決された合意、未解決の不一致、および重要な少数意見を反映する必要があります。
停止条件
以下の場合にのみ停止し、ユーザーに尋ねます:
- 主題または目標が特定できない。
- 望まれる出力を推測できない。
- 主要な制約が競合する。
- 必要な外部データ、認証情報、プライベートシステム、有料ツール、または利用不可のネットワークアクセスが作業をブロックする。
- 法律、医療、金融、コンプライアンス、セキュリティ、または安全上重要なアドバイスを安全な情報提供の境界内に留めることができない。
完了
ワークフローが完了したら、作成されたファイルと、ステージゲートが最終統合を承認したかどうかをユーザーに伝えます。完了メッセージは簡潔に保ちます。