codex-dynamic-workflows

AI エージェントの動的ワークフロー

大規模なタスクを、監督下で実行する AI エージェントのワークフローに変換するには、このスキルを使用します。オーケストレーション用の成果物を作成し、継続的な実行が求められた場合はゴールモードに入り、利用可能であれば互いに独立した作業をサブエージェントに委任し、結果を統合して成果を検証し、再利用可能なワークフロー成果物を保存します。

このスキルは、スキルに対応したエージェントで動作します。現在の環境でそのようなランナーを利用できない場合は、ローカルスクリプトがサブエージェント用のツールを呼び出せると主張しないでください。プログラム可能なランナーがない場合は、人が読めるオーケストレーションスクリプトを作成し、利用可能なエージェントツールを使って実行してください。

判断ルール

ユーザーが動的なオーケストレーションを求めた場合に、このスキルを使用します。タスクの複雑さ、リスク、並行する作業の数だけでは、このスキルを使用する条件になりません。承認済みのワークフロー内では、具体的で独立した成果に貢献する委任のみを選択してください。

運用上の契約

このスキルを使用する場合：

1. 目標と成功基準を言い換えて確認します。
2. 委任する前に、ワークフロー成果物を作成または更新します。
3. 影響の大きい操作について、以下の境界に照らして承認状況を確認します。範囲内ですでに承認された操作について、再度確認を求めないでください。
4. ゴールを作成するのは、ユーザーまたはシステム／開発者の指示で明示的に求められた場合に限ります。通常の複数ターンにわたる作業は、ゴールの作成を許可するものではありません。
5. 作業を、担当範囲が明確で互いに重複しないパケットに分割します。
6. 現在の環境で利用可能で、かつユーザーがエージェントへの委任または並行作業を承認している場合に限り、サブエージェントを起動します。
7. サブエージェント用ランナーが利用できない場合は、独立した作業をローカルで行い、サブエージェントの成果ではなく親エージェントの作業として明示します。
8. 結果を明確に統合します。サブエージェントの出力をそのまま最終回答に貼り付けないでください。
9. タスクの影響範囲に応じたチェックで検証します。
10. 将来の作業に役立つ場合に限り、再利用可能な成果物を保存します。

ワークフロー成果物

ローカルの実行ディレクトリを作成することを推奨します。

.workflow/<slug>/
|-- plan.md
|-- state.json
|-- orchestration.md
|-- packets/
|-- results/
`-- final-report.md

この構成を生成するには、scripts/new_workflow.py を使用します。

python3 /path/to/codex-dynamic-workflows/scripts/new_workflow.py "Task title"

plan.md は人が読める形式にします。state.json にはステータス、パケット ID、承認状態、検証状態を記録します。orchestration.md は実行可能な思考モデルとして使用し、エージェントがたどる手順、分岐ルール、パケット用プロンプトを記載します。

オーケストレーション計画

次の項目を含む簡潔な計画を作成します。

Goal:
Success criteria:
Current context:
Constraints:
Risks:
Approval required:
Workflow artifact path:
Work packets:
Integration policy:
Verification:
Reusable artifacts:

明白な作業について、過剰に計画を立てないでください。計画は委任と検証を導くのに十分な詳細を備えたものとし、実行の代わりにしないでください。

承認ゲート

影響の大きい操作を行うために承認が不足している場合は、事前に承認を得てください。対象となる操作は、特定の宛先への公開または送信、本番環境への変更、破壊的な削除や履歴の書き換え、認証情報／アカウント／セキュリティの変更、または相当なコストがかかる処理です。明示的な承認は、その適用範囲内で有効です。実装の一般的な依頼は、無関係な外部操作を許可するものではありません。

依頼された変更の一環としてファイルの内容を置き換えることなど、承認済みのローカル編集や、関連する使い捨てのフィクスチャを使ったチェックは実施できます。不足している承認を求める前に、具体的な成果を準備してください。影響の大きい操作の承認を待つ間も、独立して進められる準備や修正を続けてください。

操作の承認状況が不明確な場合は、risk-gates.md を使用してください。

ゴールモード

ゴールを作成するのは、ユーザーまたはシステム／開発者の指示で明示的に求められ、現在のツール契約でもサポートされている場合に限ります。ワークフローの実行、複数ターンにわたる作業、実装の継続を求める依頼だけでは、追跡対象のゴールを作成するよう求められたことにはなりません。承認済みのゴールがある場合は、その目的全体をそのまま維持してください。

作業パケット

各パケットは自己完結している必要があります。

Packet ID:
Objective:
Context:
Files / sources:
Ownership:
Do:
Do not:
Expected output:
Verification:

担当範囲が重ならないパケットを優先してください。

• コードベースの調査
• 依存関係または API の調査
• 実装の一部分
• テストとフィクスチャ
• ドキュメントと例
• UX または製品レビュー
• セキュリティまたはリスクレビュー
• 最終検証

コード編集のパケットでは、重複しないファイルまたはモジュールを割り当ててください。ワーカーには、コードベースに自分以外の作業者もいること、他の人の編集を元に戻してはならないこと、並行して行われる変更に適応することを伝えてください。

サブエージェント

サブエージェントランナーが利用できる場合：

• 具体的で、範囲が限定され、実質的に役立つサブタスクのみを割り当ててください。
• 直ちに対応が必要なブロッキング作業は、メインエージェントで行ってください。
• メインエージェントが作業を進めている間に実行できる付随作業を委任してください。
• エージェント間で作業が重複しないようにしてください。
• 書き込み範囲が明確で重複しない場合に限り、ワーカーに直接編集を依頼してください。
• 次のクリティカルパスの手順に結果が必要な場合にのみ、サブエージェントの完了を待ってください。

サブエージェントランナーが利用できない場合：

• 作業パケットを個別にローカルで処理し、親エージェントの作業として明記してください。
• 各パスでは、パケットに関連するファイルだけを読み取ってください。
• パケットのメモを results/ に記録してください。
• パケットごとの出力が分かれてから統合してください。

統合

パケットの処理後、以下をまとめてください。

Accepted:
Rejected:
Conflicts:
Decisions:
Final changes:
Remaining risks:

競合は明示的に解決してください。2つのパケットの内容が異なる場合は、どちらを採用するか決める前に、信頼できる一次情報を確認してください。

results/ のファイルから統合チェックリストを作成するには、scripts/collect_results.py を使用してください。

python3 /path/to/codex-dynamic-workflows/scripts/collect_results.py .workflow/<slug>

検証

まず最も範囲を絞った信頼性の高いチェックを実行し、リスクに応じて対象範囲を広げてください。

• 変更したコードの単体テスト
• 型チェックまたは Lint
• ビルド
• ブラウザーまたは UI のスモークテスト
• スクリプトのドライラン
• ソース引用のチェック
• マイグレーションのドライラン
• コード以外の作業に対する手動チェックリスト

ワークフロー成果物がすべてそろっているか確認するには、scripts/verify_workflow.py を使用してください。

python3 /path/to/codex-dynamic-workflows/scripts/verify_workflow.py .workflow/<slug>

スキップしたチェックは正直に報告してください。元の成功基準を証拠で確認できるまでは、ワークフローが完了したと見なさないでください。

再利用可能なレシピ

実行によって役立つパターンが得られた場合は、.workflow/recipes/<name>.md やリポジトリのドキュメントフォルダーなど、プロジェクトに適した場所に簡潔なレシピを保存してください。次の内容を含めます。

• トリガー
• 計画の構成
• パケットの一覧
• 検証チェックリスト
• 既知のリスク

トランスクリプト、シークレット、大容量のログ、認証情報、個人に関する機密情報は保存しないでください。

参考資料

• 機械可読なワークフロー計画が役立つ場合は、references/plan-schema.md を読んでください。
• リスクの高い操作や曖昧な操作を行う前に、references/risk-gates.md を読んでください。
• このスキルのフォワードテストや改善を行う場合は、references/validation-examples.md を読んでください。