1. 能力目标
为搜推算法/工程同学解决算子知识层面的问题：找到合适的算子、看清算子在线上图里的实际配置、理解参数含义、判断算子能否复用、分析算子改动的影响范围。
这五件事是同一个心智过程的不同阶段——用户往往从"找个算子"问起，逐步问到"线上怎么用的""参数什么意思""能不能直接用""改了会出什么事"。归并到一个 skill 让对话可以在子场景间自然流转。
2. 适用场景
| 子场景 | 用户意图 | 触发关键词 |
|---|---|---|
| 算子发现 | 根据能力需求找算子 | 找一个、有没有、推荐、哪个算子能、需要支持 |
| 线上配置参考 | 查某算子在线上图里的实际配置 | 线上怎么配的、目前怎么用、参考一下线上、生产参数是 |
| 配置参数理解 | 解释算子参数的含义、范围、默认值 | 这个参数什么意思、xx 参数怎么取值、参数能取多少 |
| 复用判断 | 判断现有算子能否复用到新场景 | 能不能用、可以复用吗、要不要重新开发 |
| 影响分析 | 分析算子改动的影响范围 | 改了会影响哪些、用了这个算子的图有哪些、删掉行不行 |
3. 不适用场景
- 生成可直接写入的算子配置（仅做参考与分析，不替用户拼配置）
- 直接修改、创建、发布算子或图
- 业务需求决策
- 跨业务线的复用决策（仅给参考结论，最终决策由用户做）
- 未录入知识库的算子的相关问题
4. 输入槽位
| 槽位 | 必填子场景 | 获取方式 |
|---|---|---|
| target_capability | 算子发现、复用判断 | 用户描述能力需求，缺失时追问 |
| operator_name | 线上配置参考、配置参数理解、影响分析 | 用户输入算子名或类路径，缺失时追问 |
| target_scenario | 复用判断 | 用户描述目标业务场景，缺失时追问 |
| change_content | 影响分析（可选） | 用户描述改动内容，缺失时仅给当前引用范围 |
| target_graph | 线上配置参考、影响分析（可选） | 用户指定具体图，缺失时返回全量统计 |
| param_name | 配置参数理解（可选） | 用户指定参数名，缺失时返回全参数列表 |
算子知识库的字段定义、命名规则、业务域枚举见 references/operator_kb_schema.md。
5. 执行流程
5.1 算子发现
- 接收 target_capability，必要时追问。
- 调用 operator_search 做语义检索，取 top 5 候选。
- 调用 operator_recommend 拿到带推荐理由的结果。
- 按 §7.1 输出候选列表。
5.2 线上配置参考
- 接收 operator_name，必要时追问。
- 调用 operator_lineage_query 找到引用该算子的图列表。
- 调用 graph_config_query 拉取这些图中该算子的实际参数取值。
- 按 §7.2 输出实际配置案例（按业务域/流量分组聚合）。
5.3 配置参数理解
- 接收 operator_name，必要时追问。
- 调用 operator_params_query 拿到参数列表。
- 如有 param_name，聚焦该参数说明；否则返回全参数。
- 按 §7.3 输出参数说明。
5.4 复用判断
- 接收 target_capability + target_scenario，缺失时追问。
- 走 §5.1 流程找到候选算子。
- 对每个候选调用 operator_params_query 核查能力是否完整覆盖目标场景。
- 按 §7.4 输出复用结论与能力缺口。
5.5 影响分析
- 接收 operator_name，必要时追问。
- 调用 operator_lineage_query 拿到引用图列表。
- 解析图间引用关系（主图/子图）。
- 如有 change_content，调用 change_risk_assess 评估改动风险。
- 按 §7.5 输出影响范围与风险评级。
6. Tool 使用规则
- operator_search：算子语义检索
- operator_recommend：带推荐理由的算子推荐
- operator_params_query：算子参数详情
- operator_lineage_query：算子被引用图列表
- graph_config_query：图详情与算子在图中的实际配置
- change_risk_assess：参数改动风险评估
- 不得调用任何算子写入、图修改、草稿创建/发布类 Tool
- Tool 调用失败时按 §8 处理，不得编造结果
各 Tool 的完整接口协议（SDK 方法、入参、出参、调用示例、失败处理）见 references/tool_contracts.md。
7. 输出契约
7.1 算子发现输出
- 候选算子列表（top 3-5），每条包含：算子简称、全类名、业务域、推荐理由
- 推荐排序依据（语义匹配度 / 历史使用频率）
- 候选不足或不确定时，明确标注"建议补充约束条件"
7.2 线上配置参考输出
- 算子基本信息（算子名、类路径、业务域）
- 实际使用图列表（按业务域/流量从大到小，每条含图名、点位、当前版本）
- 各图中该算子的实际参数取值（聚合展示，标出最常用值和异常值）
- 说明："以上为线上现状参考，不代表推荐配置"
7.3 配置参数理解输出
- 算子基本信息
- 参数列表（参数名、类型、默认值、取值范围、业务含义）
- 若指定 param_name，给出该参数详解 + 常见取值场景
7.4 复用判断输出
- 需求摘要（复述用户目标场景）
- 候选算子（来自 §5.1）
- 能力对照表（目标场景需求 × 算子能力，标"覆盖 / 部分 / 缺失"）
- 结论：可复用 / 改参数后可复用 / 不建议复用，需新开发
- 若有缺口，列出需要补充的能力
7.5 影响分析输出
- 算子基本信息
- 直接引用关系（哪些图直接调用，按主图/子图分类）
- 间接影响范围（子图被哪些主图引用）
- 当前流量与实验情况（如可查）
- 风险等级（高/中/低）+ 评级依据
- 建议验证项（小流量观察哪些指标）
- 数据缺失或不确定项
8. 异常与兜底
- 必填槽位缺失：按子场景追问，不强行执行
- 算子知识库未命中：明确说明"未找到，不作推断"
- 存在多个同名候选：展示候选项并要求用户选择
- 血缘查询接口不可用：返回基于现有数据的部分结果，标注"血缘数据不全"
- 配置库无历史案例：直接说明"无线上配置案例"，不编造数据
- 跨工作空间引用查询不全：标注"仅基于当前工作空间数据"
- 参数业务含义文档未覆盖：标注"文档未覆盖，建议咨询算子研发"
9. 完成标准
- 所有必填槽位已补齐
- 结论包含数据来源（知识库 / 配置库 / 代码库 / 血缘）
- 不确定的部分已显式标注
- 输出按子场景对应 §7.X 模板，字段不缺
- 数据缺失项已列在"数据缺失或不确定项"中
- 未做任何写入或修改操作
