書き込み・レビューループ

境界付き再試行パスで、書き込み → レビュー → 改訂のループに you-agent-factory を使います。

概要

書き込み・レビューループは、書き込みまたは実行の作業が候補を作り、その後レビュー手順が結果を決めるファクトリーワークフローです。受理された作業は完了状態へ進みます。却下された作業は書き込みへ戻り、同じゴールをレビューが受理するまで改訂できます。

いつ使うか

品質ゲート付きのドキュメント、コード、計画など、エージェント出力が完了前に明示的なレビューゲートを通る必要があるときに、このガイドを使います。ファクトリー内で明確な書き込み → レビュー → 改訂の道筋が欲しいときに従ってください。到達すべき結果は、レビュー後にのみ完了する受理済み作業であり、却下された作業は別の書き込みパスへ戻されます。

手順またはワークフロー

稼働中のファクトリーを確認し、書き込みまたは実行の作業を投入または進め、レビューが受理して完了するか書き込みへ却下して戻し、却下サイクルが永遠に続かないようループブレーカーで再試行を境界付けます。

稼働中のファクトリーを確認する

you session list

セッションが無いときにファクトリーを起動する

you

名前付き実行

you run --named @goal/blah
ファクトリーが必要なときは you または you run から始め、投入前に you session list で確認します。セッションが無ければ、ファクトリーを再度起動して再確認します。

書き込みまたは実行の作業を投入する

you submit --name my-write-review-work --work-type-name task --payload ./payload.md

バッチ投入

you submit batch ./batch.json
稼働中のファクトリーに対してのみ投入します。キュー後、書き込みまたは実行のワークステーションが候補を作り、レビューが受理か却下かを決めます。書き込みまたは実行のワークステーションが成功した作業を、対になるレビューワークステーション向けのレビュー中状態へ送るようファクトリーを形作ります。受理時、レビューは作業を完了状態へ進めます。却下時は onRejection を設定し、作業を書き込みまたは init 状態へ戻して別のパスを回します。その実行とレビューのペアと結果ルートが、書き込み → レビュー → 改訂の道筋です。却下サイクルが終わらないよう、境界付き再試行を追加します。よくあるパターンは、書き込みまたはレビューのワークステーションで VISIT_COUNT にガードされた LOGICAL_MOVE です。訪問回数が上限を超えたら、再び回す代わりに失敗または他の終了状態へ移します。

よくある落とし穴

稼働していないファクトリーに対してレビューや投入をしないでください。ブレーカーなしの却下を永遠に安全だと扱わないでください。このユースケースガイドを、後続の writer-reviewer 技法の用語ページと混同しないでください。

タグ