mcpField
A
antfarm-workflows

antfarm-workflows

github.com/snarktankエージェントワークフロー2.5k46 回インストール35 週間前に更新
リポジトリ

antfarm-workflows について

Antfarm は OpenClaw 上で複数エージェントのワークフローパイプラインを実行するスキルです。計画、開発、検証、テスト、レビューをつなぎ、各エージェントが cron で共有 SQLite データベースを確認して作業を進めます。

主な機能

  1. 01複数エージェントのワークフロー実行
  2. 02機能開発、バグ修正、セキュリティ監査のパイプライン
  3. 03cron による共有 SQLite のポーリング
  4. 04ワークフローのインストールと管理
  5. 05カスタムワークフローの作成

活用シーン

  1. 01機能開発を順次実行する工程に分割
  2. 02再現手順のあるバグ報告への対応
  3. 03コードベースのセキュリティ問題の調査と修正

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/snarktank/antfarm --skill antfarm-workflows

インストール後、Claude Code で/antfarm-workflowsを入力して読み込まれたか確認します。

詳細

Antfarm

OpenClaw 上のマルチエージェントワークフローパイプラインです。各ワークフローは、cron ジョブで共有 SQLite データベースをポーリングし、自律的に実行する専門エージェント(プランナー、開発者、検証担当、テスター、レビュアー)の一連の処理で構成されます。

PATH の問題を避けるため、すべての CLI コマンドでフルパスを使用します。

node ~/.openclaw/workspace/antfarm/dist/cli/cli.js <command>

以下では、antfarm-cli を node ~/.openclaw/workspace/antfarm/dist/cli/cli.js の意味で使用します。

ワークフロー

ワークフローパイプライン用途
feature-dev計画 -> セットアップ -> 開発(ストーリー) -> 検証 -> テスト -> PR -> レビュー新機能、リファクタリング
bug-fixトリアージ -> 調査 -> セットアップ -> 修正 -> 検証 -> PR再現手順付きのバグ報告
security-auditスキャン -> 優先順位付け -> セットアップ -> 修正 -> 検証 -> テスト -> PRコードベースのセキュリティレビュー

コアコマンド

# Install all workflows (creates agents + starts dashboard)
node ~/.openclaw/workspace/antfarm/dist/cli/cli.js install

# Full uninstall (workflows, agents, crons, DB, dashboard)
node ~/.openclaw/workspace/antfarm/dist/cli/cli.js uninstall [--force]

# Start a run
node ~/.openclaw/workspace/antfarm/dist/cli/cli.js workflow run <workflow-id> "<detailed task with acceptance criteria>"

# Check a run
node ~/.openclaw/workspace/antfarm/dist/cli/cli.js workflow status "<task or run-id prefix>"

# List all runs
node ~/.openclaw/workspace/antfarm/dist/cli/cli.js workflow runs

# Resume a failed run from the failed step
node ~/.openclaw/workspace/antfarm/dist/cli/cli.js workflow resume <run-id>

# View logs
node ~/.openclaw/workspace/antfarm/dist/cli/cli.js logs [lines]

# Dashboard
node ~/.openclaw/workspace/antfarm/dist/cli/cli.js dashboard [start] [--port N]
node ~/.openclaw/workspace/antfarm/dist/cli/cli.js dashboard stop

実行を開始する前に

タスク文字列は、あなたとエージェント間の取り決めです。曖昧なタスクでは、良い結果が得られません。

タスク文字列には必ず次の内容を含めてください:

  1. 構築または修正する内容(曖昧にせず具体的に)
  2. 重要な技術的詳細と制約
  3. 受け入れ基準(チェックボックス形式)

実行する前に、計画と受け入れ基準をユーザーに確認してもらってください。

仕組み

  • エージェントには、保留中のステップをポーリングする cron ジョブがあります(15 分ごとに時間をずらして実行)
  • 各エージェントが自分のステップを取得して作業を行い、完了としてマークすると、次のステップに進みます
  • コンテキストは、エージェントの出力に含まれる KEY: value ペアを通じてステップ間で引き継がれます
  • 中央のオーケストレーターは存在せず、エージェントは自律的に動作します

エージェントの強制起動

15 分間の cron 待機を省略するには、action: "run" とエージェントのジョブ ID を指定して cron ツールを使用します。cron の一覧を表示してジョブを確認してください。ジョブ名は antfarm/<workflow-id>/<agent-id> です。

ワークフロー管理

# List available workflows
node ~/.openclaw/workspace/antfarm/dist/cli/cli.js workflow list

# Install/uninstall individual workflows
node ~/.openclaw/workspace/antfarm/dist/cli/cli.js workflow install <name>
node ~/.openclaw/workspace/antfarm/dist/cli/cli.js workflow uninstall <name>
node ~/.openclaw/workspace/antfarm/dist/cli/cli.js workflow uninstall --all [--force]

カスタムワークフローの作成

ワークフロー YAML、エージェントのワークスペース、ステップテンプレート、検証ループの作成方法については、詳細ガイド {baseDir}/../../docs/creating-workflows.md を参照してください。

エージェントのステップ操作(エージェントの cron ジョブで使用。通常は手動で実行しません)

node ~/.openclaw/workspace/antfarm/dist/cli/cli.js step claim <agent-id>        # Claim pending step
node ~/.openclaw/workspace/antfarm/dist/cli/cli.js step complete <step-id>      # Complete step (output from stdin)
node ~/.openclaw/workspace/antfarm/dist/cli/cli.js step fail <step-id> <error>  # Fail step with retry
node ~/.openclaw/workspace/antfarm/dist/cli/cli.js step stories <run-id>        # List stories for a run

コメント