MINARA新增分析 Playbook
使用聚焦的分析框架扩展机构模式、Roundtable 模板或深度研究
Minara 已于 2026 年 5 月退役独立的 Scenario Registry。不要再创建 SCENARIO_* 定义文件、修改场景目录或增加 SCENARIO_LEARNING 开关。用户意图路由现在由技能负责，保留下来的分析 Playbook 直接服务于机构模式和深度研究。
选择正确的扩展面
| 目标 | 扩展位置 |
|---|---|
| 将一类用户请求路由到现有工具 | 内置技能 |
| 为机构角色提供可复用的分析框架 | apps/agent/src/tools/institution/playbooks/index.ts |
| 新增内置 Agent、阶段或 Roundtable 模板 | apps/agent/src/tools/institution/builder-templates.ts |
| 扩展深度研究中的资料收集与综合方法 | apps/agent/src/skills/builtin/deep-research/references/scenarios.md |
| 让单个用户编排自定义多 Agent 流程 | 使用 Roundtable Builder，无需修改源码 |
新增机构 Playbook
机构 Playbook 为一个或多个角色提供分析内容。请使用稳定、带命名空间的 ID，例如 institution.playbook.stock_quality，并将其加入 INSTITUTION_PLAYBOOKS。
"institution.playbook.stock_quality": {
id: "institution.playbook.stock_quality",
description: "Evaluate earnings quality, reinvestment, and balance-sheet resilience.",
body: `1. Verify the latest filing period and data freshness.
2. Compare cash conversion, margins, and invested-capital returns.
3. Identify the strongest disconfirming evidence.
4. State the conditions that would invalidate the conclusion.`,
},每个正文都要能够独立理解。请明确所需证据、冲突证据如何改变结论，以及实时数据缺失时如何降级。不要重复系统提示中已经存在的通用安全、引用和语言规则。
只有内置角色需要默认加载该 Playbook 时，才在 apps/agent/src/tools/institution/roles.ts 中添加映射。资产类别特有的映射放在 playbookIdsForRole() 中。测试会检查所有被引用的 ID 是否真实存在。
可调整的数值使用带安全默认值的方法论占位符：
Treat beta above `{{methodology:stock_beta_high_corr_threshold|default:0.8}}`
as market-sensitive.不要把可复用的投资规则埋在冗长 Playbook 中。请将它移入方法论系统，再通过占位符或 methodology_lookup 引用。
新增内置 Roundtable 模板
Roundtable Builder 支持五种阶段：context、parallel、debate、synthesis 和 final。内置 Agent、阶段和完整 Roundtable 模板位于 builder-templates.ts，共享类型来自 @minara/types。
验证器强制执行以下规则：
- 整条流程中的阶段 ID 与 Agent ID 不得重复；
- 辩论阶段至少包含两个 Agent；
- 综合和最终阶段必须恰好有一位管理者；
- 整条流程必须恰好有一个最终阶段，且该阶段位于最后；
- 循环次数、工具调用、超时和输出 Token 不得超过声明范围。
修改模板时，需要同步更新 Agent 测试与 Web UI Builder 测试。用户创建的模板通过 Builder Store 持久化，不应提交到源码。
扩展深度研究
深度研究的六步外层契约位于 deep-research/SKILL.md。主题特有的资料收集和分析方法写入 references/scenarios.md。内容应聚焦来源选择、证据质量、比较逻辑和最终综合的结构。
如果 Playbook 需要新能力，请先新增并测试工具，将它加入技能的 tool_names，再更新参考文件。来源或凭据不可用时，Playbook 必须如实降级。
验证贡献
pnpm --filter @minara/agent exec vitest run tests/unit/tools/institution.test.ts
pnpm --filter @minara/agent exec vitest run tests/unit/tools/institution-builder.test.ts
pnpm --filter @minara/agent typecheck修改深度研究时，还应运行对应的技能和报告流程测试。若改动影响公共行为，请同步更新四种语言的机构模式或深度研究文档。