| name | bailian-model-recommend |
| description | 阿里云百炼模型选型与推荐。当用户需要"选择、推荐、对比"模型，或描述一个 AI 场景/功能需求（隐含需要帮其决策用哪个模型）时激活。核心意图是帮用户做决策， 不是单纯查资料。触发词：推荐模型、选哪个、哪个适合、对比、做一个XX、实现XX 功能、用什么模型好、XX场景方案。当用户同时涉及模型查询和模型选择时，优先 使用本 skill（本 skill 内部会读取模型数据完成推荐）。 |
| compatibility | 需要已安装 bailian-docs-llm-wiki skill（提供 models/ 数据目录） |
百炼模型推荐
从阿里云百炼平台模型库中，根据用户场景推荐最合适的模型并提供调用示例代码。
适用场景
显式选型：
- "推荐一个模型"、"选哪个模型"、"用什么模型好"
- "帮我对比一下XX和XX模型"
隐式选型（用户描述想做的事，隐含需要选模型）：
- "我想做一个XX"（客服机器人、翻译工具、代码助手...）
- "帮我实现XX功能"（图片生成、语音合成、文本摘要...）
- "怎么用 AI 来做XX"、"大模型能做XX吗"
- "XX场景有什么方案"、"我想接入XX能力"
技术选型：
- "XX和XX哪个更适合做YY"
- "低成本/高并发/高精度 场景怎么选"
不适用：
- 用户已确定模型，只问怎么调用 → 直接给调用代码
- 纯粹查询模型参数/价格 → 使用 bailian-docs-llm-wiki skill
与 bailian-docs-llm-wiki 的边界： 当用户同时涉及模型查询和模型选择时，优先使用本 skill（本 skill 内部会读取模型数据完成推荐）。仅当用户已确定模型、只需查参数/价格/调用方式时，由 bailian-docs-llm-wiki 处理。
前置检查
执行推荐前确认依赖的 bailian-docs-llm-wiki skill 已安装且数据可用。
检测逻辑：
- 检查
bailian-docs-llm-wiki skill 是否已安装（通过查找已安装 skill 目录中是否存在 bailian-docs-llm-wiki/models/models.jsonl）
- 如果未安装，执行安装：
npx skills add modelstudioai/skills --skill bailian-docs-llm-wiki -y
安装失败则告知用户并中止。禁止在没有数据的情况下凭记忆推荐模型。
推荐流程
第一步：理解需求（Agent 直接完成，不输出给用户）
从用户描述中快速提取结构化需求信息。JSON 结构定义见 references/requirement-schema.md，推断规则见 references/capability-codes.md。
要快： 简单字段映射，不做复杂推理。如果需求不清晰，直接追问具体场景，不输出中间分析。
第二步：筛选候选
从 models/models.jsonl 和 models/groups/<slug>.json 中综合筛选匹配的模型（10~50 个），结构化字段和语义信息同时参与筛选：
- 去除历史快照版本（如
model-2025-04-28），只保留主版本
- 按模态过滤（输入/输出模态必须兼容）
- 按能力、特性、上下文窗口、质量定位评分排序
- 读取 group 文件的 description（group 级 + item 级），将场景关键词（如"科研"、"代码"、"长文本"、"客服"）与用户需求做语义匹配，提升匹配模型的排序
- 同一家族最多保留少量模型，避免同质化
- 候选不足时放宽过滤条件
数据源字段说明见 references/data-source.md。
第三步：精选推荐
从候选列表中选出 3 个推荐：
| 位置 | 策略 |
|---|
| 推荐 #1（最佳推荐） | 最符合用户预算和质量偏好的最佳模型 |
| 推荐 #2（次优选择） | 另一个档次的模型，说明与 #1 的 tradeoff |
| 推荐 #3（备选参考） | 不同视角的选择，说明场景差异 |
排序逻辑：
- 用户要省钱 → #1 必须是性价比最高的，不是旗舰
- 用户要最好 → #1 必须是能力最强的旗舰
- 用户无倾向 → #1 选综合匹配度最高的
- 推荐最适合场景的，不是最强的；偏好从用户表达中推断，不预设倾向
约束：
- 理由必须关联用户具体需求（禁止"性能强大"等空话），三条理由角度不同
- 有定价信息时结合预算权衡，帮用户做成本决策
- 避免推荐同家族多个模型，优先稳定版本
- 提供多档次选择和 tradeoff 说明，由用户自己决定
pipeline 场景： 相邻步骤的模型模态必须兼容，不兼容时添加提示。
第四步：输出推荐结果
对每个推荐模型，读取对应的 group JSON 文件（models/groups/<slug>.json）获取 samples 字段中的调用示例代码。示例代码获取方式和输出格式见 references/samples-format.md。
用自然语言直接输出推荐（如"根据你的需求，我推荐以下模型..."），每个模型包含：
- 模型名称和 ID
- 推荐理由 — 关联用户具体需求，附 tradeoff 对比
- 亮点 — 关键优势标签
- 规格信息 — 上下文窗口、最大输出、定价（如有）
- 调用示例代码 — 从 group 文件的 samples 字段获取（优先 openai.python，同时提供 curl）
输出约束：
- 不暴露内部流程术语（禁止出现"Stage"、"意图画像"、"候选召回"、"精排"等词汇）
- 所有推荐基于
bailian-docs-llm-wiki 的实际数据，不凭记忆推荐
