FY マルチエージェントフロースキル (FY-Flow)
契約駆動型マルチエージェント協調開発マイクロカーネル (FY-Flow) —— AutoGen パラダイムに準拠し、権限逸脱、タスク断片化、状態の宙吊りを効果的に防止します。
統一エントリーゲートウェイプロトコル (Unified Gateway Protocol)
本 Skill を呼び出すすべての命令は、このゲートウェイエントリに統合され、以下の2つのブランチルールに従って振り分けられ判定されます。
1. デュアルブランチ振り分けマトリックス
| ブランチタイプ | トリガー特性と命令 | 処理メカニズムと応答契約 | 典型的なシナリオ |
|---|---|---|---|
| ブランチ A：システムコンソール操作 | /fy-flow help/fy-flow start/fy-flow status/fy-flow kanban/fy-flow trace | 基盤運用エンジンに直通（0 事前段階評価）、対応するスクリプトを直接実行しシステム状態を出力します。 | ヘルプマニュアル表示、SOP 初期化、かんばん起動、ダッシュボード巡回、オフラインリンク図鑑 |
| ブランチ B：業務開発と対話意図 | 自然言語要件、コード修正、機能開発、バグ修正、トラブルシューティング、/fy-flow auto | 事前に【階級三問と単一責任分割】の実行を強制し、応答の先頭行に二重ヘッダー識別子を明示的に出力します：`【タスク階級: L0 即時応答 / L1 軽量タスク / L2 標準開発】 | 【単一責任: 準拠単一カード / 複合要件は N 個のアトミックタスクに分割する必要あり】` |
2. 業務要件【階級三問】決定フロー
[業務要件入力]
│
├─► 1. コード/ドキュメント/設定など、リポジトリファイルの変更が残りますか？
│ ├─ いいえ ──► 2. 結論を後続のエンジニアリングの根拠として事後追跡する必要がありますか？
│ │ ├─ いいえ ───────────────► 【L0 即時応答】（カードなしで直接回答、0 ミリ秒 CLI 遅延、下書きは下書きボックスへ）
│ │ └─ はい ───────────────► 【L1 軽量タスク】（カード作成後、作業開始待ち停止 → 人間の承認後、単一役割で完了）
│ │
│ └─ はい ──► 3. 複数役割の協調、コアビジネスコードの修正、または共通基盤ライブラリの変更が必要ですか？
│ ├─ いいえ ───────────────► 【L1 軽量タスク】
│ └─ はい ───────────────► 【L2 標準開発タスク】（カード作成後、作業開始待ち停止 → 人間の承認後、複数役割で協調）
- ゲートウェイ階級と CCP 弾性階級マッピング:
- 【L0 即時応答】：カードなしで直接回答、0 ステートマシンオーバーヘッド;
- 【L1 軽量タスク】：CCP Tier-3（Fast-Path 快速通過、物理的な独立レポート不要、証拠は直接かんばんに書き戻し）にマッピング;
- 【L2 標準開発】：規模と契約に応じて自動的に CCP Tier-2（部分最適化、工数 ≤ 4.0h、物理レポート不要）または CCP Tier-1（コアアーキテクチャとインターフェース契約の強制約）にマッチング。
- L1/L2 業務要件に属するものはすべて、ゲートウェイが単一責任審査（工数 ≤ 8.0h、単一のアトミック成果物）を強制実行します。直交領域をまたがる要件は、分割してカードを作成する必要があります。
- 作業開始承認の絶対ルール: カード作成の完了をもって、今回の計画セッションは終了状態となります。タスクカードは厳密に【未開始】状態に留めなければなりません。人間のユーザーが明示的に作業開始承認命令（例：「作業開始」「開発開始」「実行確認」）を出さない限り、自動的に【進行中】に進めることを固く禁じます。
- 実行状態の Task ID（例：
T0001）は、ゲートウェイを直接通過してステートマシンに投入され、二次的なカード作成は禁止されます。
コアコマンドクイックリファレンス (CLI Command Quick Reference)
| 業務シナリオ | 統一 CLI インターフェース (cli.py) | 基盤専用スクリプト | コア機能とパラメータ |
|---|---|---|---|
| タスクカード作成 | python3 scripts/cli.py task create ... | python3 scripts/quick_task.py create ... | --name "..." --assignee "..." --stage "Sprint 2.1 メニュー調整" --type "A" --target "..." --criteria "..." [--in-scope "file # 理由"] |
| 段階ゲート承認/終了 | python3 scripts/check_stage_gate.py ... | python3 scripts/check_stage_gate.py ... | --action start/close --stage "Sprint 2.1 メニュー調整"（必要に応じて承認、先行依存関係は自動検証） |
| コード化派遣 | python3 scripts/cli.py dispatch --task-id T00xx --format codex | python3 scripts/dispatch_task.py | 依存関係と同時実行性を検証し、【進行中】にプッシュ、Codex サブエージェントツールが直接呼び出せる JSON パラメータを出力 |
| タスク状態遷移の推進 | python3 scripts/transition_task.py ... | python3 scripts/transition_task.py ... | --task-id T00xx --role DEV --from-status 進行中 --to-status レビュー中 --token <token> --summary "コア変更概要" --remarks "..."（レビュー依頼時は --summary の指定を必須とし、差分と証拠スナップショットを自動付与） |
| 人間による最終承認 | python3 scripts/cli.py task accept ... | python3 scripts/quick_task.py accept ... | --task-id T00xx（人間ユーザー専用、エージェントによる代行署名は固く禁じる） |
| かんばん起動 | python3 scripts/cli.py kanban | python3 scripts/start_kanban_server.py | デフォルトで http://127.0.0.1:32886/ に起動 |
| 健全性チェック | python3 scripts/cli.py status | python3 scripts/heartbeat.py | ダッシュボード健全性、ブロックカード、効率指標を出力（サブエージェント認知ローミングと 600 秒超過アラートを含む） |
| 技術スタック同期/プロファイル再計算 | - | scripts/update_agent_tech_stacks.py | --force-recalc で専門エージェントの技術能力プロファイルを強制再計算し、Subagent をリフレッシュしてエクスポート。技術スタック移行後のプロファイル陳腐化問題を解決 |
| 継続性検証 | python3 scripts/cli.py ccp ... | python3 scripts/cli.py ccp ... | --task-id T00xx --stage レビュー中 でコンテキスト継続性を検証 |
| リンク全景図鑑 | python3 scripts/cli.py trace | python3 scripts/generate_trace_html.py | セッショントレースをオフライン解析、秒単位で全景リンク図鑑 HTML を生成 (0 Token) |
| スマートインクリメンタルテスト | python3 scripts/cli.py test | scripts/run_tests.py | Git の変更を自動検出し、関連する単体テストのみを実行 (秒単位)。ドキュメント変更は自動免除。--all で全量回帰 |
8 大専門エージェントサブエージェント書き込み権限と遷移区間マトリックス
[!IMPORTANT] 物理的分離の鉄則とトークンゲーティング (Dispatch Token Gating)：
- メインエージェント (PM 厳マネージャー) は、メインセッション内で自分自身がロールプレイして開発業務のコードを書くことを固く禁じます！Codex ホストは実際のサブエージェントツールを使用して派遣する必要があります。その他のホストはそれぞれのサブエージェントツールを使用できます。
- コード化派遣とトークンゲーティング：タスク派遣時は
cli.py dispatchが専用のdispatch_tokenを生成します。専門的な開発ロール (DEV/FRONTEND/REVIEWER/QA) が遷移する際は、必ず--token <token>を携帯する必要があります。ステートマシン実行基盤が強力にインターセプトし、ロールプレイによる偽の合格（グリーンスルー）を排除します。
Codex デスクトップ版自動派遣契約
ユーザーが明示的に作業開始を承認した後、メインエージェントはターゲットプロジェクトディレクトリで以下を実行します：
python3 .agents/skills/fy-flow/scripts/dispatch_task.py --task-id <ID> --format codex。
標準出力は単一の JSON オブジェクトであり、tool、arguments、task_id、role を含みます。診断情報は標準エラー出力に出力されます。
メインエージェントは、この arguments をそのまま、実際の collaboration.spawn_agent ツール呼び出しのパラメータとして直ちに使用し、
サブエージェントの返却を待ち、その後タスクの現在の状態に従ってレビューおよびテストエキスパートの派遣を続行する必要があります。派遣メッセージを手動で書き換えたり、コピーしたり、省略したりしないでください。
JSON を印刷して派遣完了とするのはやめてください。また、メインエージェント自身がエキスパートの作業を実行しないでください。現在の Codex ホストに
サブエージェントツールがない場合は、ホストの能力不足を明確に報告し、タスクは現在の状態を維持し、エキスパートの受領書を偽造しないでください。
派遣されたエキスパートは、メッセージ内の exit_contract.required_cli のみを実行し、カードの再作成や作業開始を行ってはなりません。
ユーザー承認が今回の実行をカバーしているため、カード作成後は同じセッション内で派遣を続行できます。作業開始承認がまだ得られていない場合にのみ、【未開始】状態で停止します。
| サブエージェント識別子 | ロール名 | コア責務 | 有効な状態遷移区間 | 終了契約 |
|---|---|---|---|---|
@flow-pm | 厳マネージャー (プロジェクトマネージャー) | 要件分割、階級判定、カード作成 | 未開始 -> 進行中 / 承認依頼 | カード作成シナリオでは【未開始】で停止し、作業開始承認を待つ。人間による承認を依頼 |
@flow-architect | 銭アーキテクト (システムアーキテクト) | システム全体アーキテクチャ、インターフェース契約、技術選定 | 未開始 -> 進行中 -> 完了 | ADR とアーキテクチャ設計ドキュメントを成果物として出力 |
@flow-dev | 李開発 (開発エンジニア) | バックエンド/フルスタックコアコーディングと単体テスト実装 | 未開始 -> 進行中 -> レビュー中 | 単体テストを必ず実行、開発レポートを生成、レビュー依頼時に --summary を提供 |
@flow-frontend | 馬フロントエンド (フロントエンド開発エンジニア) | Web/UI コンポーネントとフロントエンド体験実装 | 未開始 -> 進行中 -> レビュー中 | コンポーネントのレンダリングとインタラクションを検証、レポートを生成、レビュー依頼時に --summary を提供 |
@flow-reviewer | 周レビューアー (コードレビューエキスパート) | コード規約、セキュリティスキャン、品質ゲーティング | レビュー中 -> テスト中 / レビュー中 -> 完了 (Tier-3 証拠が新鮮で未漂移の場合、QA パス不要で直通) / レビュー中 -> 差し戻し | 静的スキャンで警告なし、レビュー意見を成果物として出力 |
@flow-qa | 章テスト (テストエンジニア) | 対象を絞った統合テストとリリース判定（現在のタスクに関連するテストのみ実行、全量スクリプトは固く禁止） | テスト中 -> 完了 / テスト中 -> 差し戻し | 対象を絞ったテストケースを作成、実際の工数を記録 |
@flow-docs | 李文通 (ドキュメントエンジニア) | 成果物ドキュメント管理とユーザーマニュアル | 未開始 -> 進行中 -> 完了 | GB/T 7713 学術・エンジニアリング規約に従う |
@flow-devops | 呂改特 (運用管理者) | ブランチマージ、リリースビルド、Git 履歴保護 | 未開始 -> 進行中 -> 完了 | パイプラインの合格を検証、PR ブロックを解決 |
モジュール化規約エンティティインデックス (必要に応じて詳細仕様ファイルを参照)
特定の業務シナリオに入った場合に限り、エージェントは view_file を呼び出して、対応する規約のエンティティ Markdown ファイルを参照する必要があります：
- 初回ロード / コールドスタート SOP：
references/02-bootstrap/01-initialization_sop.mdを参照 - タスク作成 / 単一責任判定：
references/01-gateway/01-task_classification.mdを参照 - タスク遷移 / ゲートルール / ロール権限：
references/03-engine/01-state_flow_rules.mdを参照 - コンテキスト引き継ぎ / エージェント間 Handoff (CCP)：
references/04-ccp/01-ccp_protocol_spec.mdを参照 - かんばんサービス運用 / PR 自動ブロック解除：
references/05-kanban/01-kanban_operations.mdを参照 - Git ブランチマージ / 監査ログとメトリクス：
references/06-governance/01-git_and_audit_spec.mdを参照