Golden Flow Engine

エージェント中立のエンジンで、プロジェクト固有の Golden Pack を構築・検証・実行します。Codex、OpenClaw、およびその他のデスクトップエージェントに、リポジトリの理解、独自のゴールデンフローの設計、エビデンスの収集、長時間の実行の再開、そしてそれらのフローを製品に合わせて維持するための決定的な基盤を提供します。

Engine はハードコードされた HTTP テストランナーではなく、LLM を一切呼び出しません。ホストエージェントがプロジェクトを読み取り、.golden-flow/ を書き込みます。Engine はファクト、安全なツール、検証、実行を提供します。

クイックスタート

python -m pip install -e ".[mcp]"
golden-flow inspect /path/to/project
golden-flow init /path/to/project
golden-flow validate /path/to/project
golden-flow plan /path/to/project
golden-flow run /path/to/project --mode strict

バックグラウンドモードは、プロジェクトローカルの SQLite キューを使用します：

golden-flow job-start /path/to/project
golden-flow worker /path/to/project --once
golden-flow job-status /path/to/project JOB_ID

golden-flow-mcp を実行すると、検査、Pack 管理、計画、および非同期実行ツールが STDIO MCP 経由で公開されます。所定のエージェントワークフローについては AGENT_GUIDE.md を参照してください。

Related MCP server: agent-orchestrator

組み込みアダプター

• file: プロジェクトルートに制限された読み取り、一覧、ハッシュ、存在確認。

• shell: policies/safety.yaml に明示的に登録された argv コマンド。

• http: Python 標準ライブラリを使用したリクエストとレスポンスのエビデンス。

• playwright: オプションのブラウザナビゲーション、入力、スクリーンショット、コンソールエラー。

• sql-observer: 読み取り専用の SQLite 監視。書き込み、プラグマ、複文は拒否されます。

• minium: オプションの WeChat ミニプログラム機能。CI 向けのプロトコル Mock モードを備えています。

• command-bridge: TypeScript、Java、Go、およびカスタムツール向けの JSON 入力 1 件 / JSON 出力 1 件のブリッジ。

アダプタープロトコルは、ケイパビリティ、プリフライト、実行、エビデンス、安全性チェック、エラークラス、およびリソースのクローズを Engine コアから独立させます。

中国語の説明

golden-flow-engine は、Codex、OpenClaw/ロブスター、およびその他のデスクトップエージェント向けの「プロジェクト黄金フロー構築・実行エンジン」です。まずリポジトリに対して決定的な読み取り専用スキャンを行い、次にホストエージェントがドキュメント、コード、ページ、状態モデル、データの真実源に基づいて、そのプロジェクト用の .golden-flow/ を作成します。Engine は、ディレクトリ形式、依存関係トポロジ、ツールの安全性、エビデンスの完全性、フォアグラウンド/バックグラウンド実行、ブレークポイント結果、エラー分類を担当し、実際の製品ビジネスはあらかじめ一切組み込まず、モデル API も内蔵しません。

デフォルトでは、プロジェクトプロファイル、トランク/ブランチ一覧、Python Journey、ツール宣言、ポリシー、Fixture ルールをコミットします。デフォルトでは、アカウント、Token、SQLite の実行状態、スクリーンショット、ログ、レポート、キャッシュ、実際のビジネス資料を無視します。

ステータス

v0.1.0 はアルファリリースです。プロトコル名とスキーマ名はバージョン管理されていますが、API は v1 より前に変更される可能性があります。実際の Minium 受け入れテストは、Windows 上の WeChat DevTools を使用した文書化された手動スモークテストのままです。通常の CI はプロトコル Mock を使用します。

MIT ライセンスです。SECURITY.md と CONTRIBUTING.md を参照してください。