antfarm-workflows について
Antfarm は OpenClaw 上で複数エージェントのワークフローパイプラインを実行するスキルです。計画、開発、検証、テスト、レビューをつなぎ、各エージェントが cron で共有 SQLite データベースを確認して作業を進めます。
主な機能
- 01複数エージェントのワークフロー実行
- 02機能開発、バグ修正、セキュリティ監査のパイプライン
- 03cron による共有 SQLite のポーリング
- 04ワークフローのインストールと管理
- 05カスタムワークフローの作成
活用シーン
- 01機能開発を順次実行する工程に分割
- 02再現手順のあるバグ報告への対応
- 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
実行を開始する前に
タスク文字列は、あなたとエージェント間の取り決めです。曖昧なタスクでは、良い結果が得られません。
タスク文字列には必ず次の内容を含めてください:
- 構築または修正する内容(曖昧にせず具体的に)
- 重要な技術的詳細と制約
- 受け入れ基準(チェックボックス形式)
実行する前に、計画と受け入れ基準をユーザーに確認してもらってください。
仕組み
- エージェントには、保留中のステップをポーリングする 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