分析 Playbook 與流程編排
技能、機構 Playbook、Roundtable 流程與方法論如何劃分職責
Minara 已於 2026 年 5 月退役獨立的 Scenario Registry。請求路由、分析指引與學習所得的投資規則現在由不同系統負責。每一層都可以獨立演進,不再受制於一個不斷膨脹的全局場景目錄。
當前模型
| 關注點 | 負責系統 | 事實來源 |
|---|---|---|
| 識別用戶需求並提供相關能力 | 技能路由 | apps/agent/src/skills/builtin/*/SKILL.md |
| 為機構角色提供可複用的分析框架 | 機構 Playbook | apps/agent/src/tools/institution/playbooks/index.ts |
| 將 Agent 編排為上下文、並行、辯論、綜合和最終階段 | Roundtable 流程 | @minara/types 定義與 Institution Builder Store |
| 指導長篇研究報告 | 深度研究技能參考 | deep-research/SKILL.md 與 references/scenarios.md |
| 複用並評價投資規則 | 方法論系統 | apps/agent/src/learning/ |
技能負責請求路由
技能描述自己能做什麼、何時出現,以及可以暴露哪些工具。註冊表加載直接子目錄中的 SKILL.md 包,過濾缺失的環境依賴,並向路由器提供精簡能力目錄。當前 SkillSession 決定哪些指引和工具進入本輪對話。
普通請求的路由因此與能力本身保持在一起。新增一類用戶請求時,通常只需要改進技能描述、參考文件或工具,不需要再創建中央場景定義。
機構 Playbook 負責分析內容
機構 Playbook 是具有穩定名稱的研究指引。一個角色可以針對股票、加密數字資產、指數、大宗商品或其他資產類別加載不同 Playbook。roles.ts 將內置角色映射到 Playbook ID,測試負責驗證每個引用。
Playbook 說明需要收集哪些證據、如何權衡分歧,以及實時數據不完整時如何繼續。可複用閾值通過 {{methodology:...|default:...}} 佔位符從方法論系統讀取。通用安全和引用規則保留在共享系統提示中。
Roundtable 流程負責協作
Roundtable Builder 使用五種階段組合分析過程:
context明確約束和歷史決策。parallel讓獨立專家在不相互錨定的情況下收集證據。debate進行多輪明確辯論。synthesis由一位管理者綜合全部記錄。final形成最終判斷與後續監控計劃。
流程保存階段順序、Agent、提示詞、技能、循環限制和預算。驗證器要求 ID 唯一、辯論至少包含兩個 Agent、綜合與最終階段各有一位管理者,並確保整條流程只有一個位於末尾的最終階段。每次運行都會保存流程快照,後續編輯不會改寫歷史。
用戶可以在不修改倉庫的情況下創建和保存自己的 Roundtable。內置 Agent、階段和 Roundtable 模板位於 builder-templates.ts,提供經過審查的起點。
深度研究保留獨立報告契約
深度研究使用固定的六步外層流程完成理解、規劃、收集、分析、可視化和寫作。主題特有的指引位於 references/scenarios.md。這些參考文件影響來源選擇和綜合方法,技能本身則保證進度反饋與最終產物保持一致。
方法論保持獨立
方法論是一條獨立投資規則,擁有證據、適用範圍、排除條件和可審計生命週期。Playbook 可以通過佔位符或 methodology_lookup 使用已晉級方法論,但不負責規則的置信度與結果歷史。
這種分離讓有效規則不再被困在單一流程中,也避免尚未通過晉級門檻的學習規則提前進入機構提示詞。