FY MultiAgent Flow 技能包 (FY-Flow)

契約驅動的多智能體協同研發微核心 (FY-Flow) —— 對齊 AutoGen 範式，有效防範越權、打回碎片化與狀態懸掛。

統一入口閘道協定 (Unified Gateway Protocol)

所有呼叫本 Skill 的指令統一收斂至本閘道入口，按如下雙支線規則分流與判定：

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`（人類使用者專屬，嚴禁 Agent 代簽）
啟動看板	`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`	輸出大盤健康度、阻塞卡片與效能指標（含子代理認知漫遊與超 600s 告警）
技術棧同步/畫像重算	-	`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)：

主 Agent (PM 嚴經理) 嚴禁在主會話中自扮演研發編寫業務程式碼！Codex 宿主必須用真實子代理工具派發；其他宿主可使用其各自的子代理工具。

程式碼化派發與令牌門控：任務派發時由 cli.py dispatch 生成專屬 dispatch_token。專業研發角色 (DEV/FRONTEND/REVIEWER/QA) 流轉時必須攜帶 --token <token>，狀態機執行底層強攔截，杜絕自扮演假綠走過場。

Codex 桌面端自動派發契約

使用者明確授權開工後，主 Agent 在目標專案目錄執行 python3 .agents/skills/fy-flow/scripts/dispatch_task.py --task-id <ID> --format codex。標準輸出是單個 JSON 物件，包含 tool、arguments、task_id 和 role；診斷資訊走標準錯誤。主 Agent 必須立即將 arguments 原樣作為一次真實 collaboration.spawn_agent 工具呼叫的參數，等待子代理返回，再按任務當前狀態繼續派發審查與測試專家。不要手工重寫、複製或縮減派單訊息；不要把 JSON 印出來當作派發完成，也不要主 Agent 自行執行專家工作。若當前 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 阻塞

模組化規約實體索引 (按需查閱具體規範文件)

當且僅當進入特定業務場景時，Agent 必須呼叫 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
上下文交接 / 跨 Agent 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

hava-idea/fy-flow

fy-flow 是什麼？

在你喜歡的 AI 中提問

說明文件

FY MultiAgent Flow 技能包 (FY-Flow)

統一入口閘道協定 (Unified Gateway Protocol)

1. 雙支線分流矩陣

2. 業務需求【分級三問】決策流

核心命令速查表 (CLI Command Quick Reference)

8 大專家子代理寫權限與流轉區間矩陣

Codex 桌面端自動派發契約

模組化規約實體索引 (按需查閱具體規範文件)

相關技能

steipete/bluebubbles

steipete/eightctl

steipete/blucli

steipete/bear-notes

steipete/camsnap

steipete/gifgrep