smoke-hux/workflow-orchestration-skill

workflow-orchestration-skill は何をしますか？

規律あるワークフローオーケストレーションのための再利用可能なCodexスキル：複雑なマルチステップ作業の計画、シーケンス、検証、追跡を行います。

概要

このスキルは、複雑なマルチステップ作業を管理するためのフレームワークを提供します。大規模なタスクを小さな管理可能なサブタスクに分割し、依存関係を定義し、各ステップの完了を検証し、全体的な進捗を追跡することで、一貫性と信頼性のある結果を実現します。

使用方法

1. ワークフローの定義: workflow.md ファイルにワークフローのステップと依存関係を記述します。
2. ワークフローの実行: 定義されたシーケンスに従って、各ステップを順番に実行します。
3. 検証: 各ステップの完了後に、期待される出力を検証します。
4. 追跡: status.md ファイルを使用して、ワークフローの進捗状況を追跡します。

サポートされるコマンド

• codex plan workflow.md: ワークフローの計画を表示します。
• codex run <step>: 特定のステップを実行します。
• codex verify <step>: ステップの結果を検証します。
• codex status: 現在のワークフローの進捗状況を表示します。

ワークフローファイルの形式

ワークフローは workflow.md ファイルにYAMLフロントマターとして定義します。

---
name: サンプルワークフロー
steps:
  - id: step-1
    description: 最初のステップ
    verify:
      - 条件1
      - 条件2
    dependencies: []
  - id: step-2
    description: 2番目のステップ
    verify:
      - 条件3
    dependencies:
      - step-1
...

ステータス追跡

ワークフローの状態は status.md ファイルに記録されます。

# ワークフローステータス

- step-1: ✅ 完了
- step-2: ⏳ 実行中
- step-3: ⬜ 未開始

例

# ワークフローの初期化
codex plan workflow.md

# ステップ1の実行
codex run step-1

# ステップ1の検証
codex verify step-1

# 進捗確認
codex status

ベストプラクティス

• 各ステップは可能な限りアトミックに保ちます。
• 検証条件は明確でテスト可能なものにします。
• 依存関係は正しく設定し、循環依存を避けます。
• ワークフロー実行中は status.md を常に最新に保ちます。

制限事項

• 現在のところ、並列実行はサポートされていません。
• ワークフローのロールバック機能は未実装です。
• 大規模なワークフローでは、status.md の管理に注意が必要です。