1. 产品说明
1.1 产品定位
商机赢单教练Agent是一款面向销售团队的智能辅导型Agent，聚焦“这条商机值不值得继续投入、当前主要风险是什么、下一步应该如何推进赢单”这几个高频问题。它围绕商机对象，自动完成商机评分、风险诊断、推进卡点识别和赢单建议输出，帮助销售和管理者快速形成对商机质量与赢单路径的统一判断。
1.2 核心价值
在商机推进过程中，销售团队通常会遇到几个典型难题：
- 不清楚当前商机质量高低，难以判断是否值得继续投入
- 对潜在风险缺少系统识别，容易在关键阶段失控
- 说不清商机卡点到底出在需求、竞争还是决策链
- 缺少面向下一步推进动作的具体建议
- 团队成员对同一条商机的判断不一致，难以形成统一策略
商机赢单教练Agent的核心价值，就是把“经验化推进”变成“结构化赢单判断 + 标准化推进建议”，帮助团队提升商机经营质量和赢单效率。
2. 用户使用
2.1 在ShareAgent对话中使用
在ShareAgent中直接发起商机诊断及建议类询问意图，例如：
帮我给这个商机打分
这条商机值不值得继续投入
下一步怎么跟 / 识别推进卡点与风险
提出商机诊断/建议类问题后，ShareAgent会将问题自行路由到“商机赢单教练Agent”进行处理。
商机赢单教练Agent接收到问题后执行 数据查询 → 线索评分 → 诊断并生成建议 ，最终生成报告（Markdown及HTML，其中HTML可选择性生成）
选择生成HTML后，Agent会产出HTML格式的报告，通过点击可以在界面中打开展示。
若需全屏查看，可点击右上角“新窗口打开”的图标实现新页签全屏查看
2.2 Agent配置自动化任务生成诊断报告
商机诊断报告除在ShareAgent中进行对话产生外，也支持配置Agent自动化任务来定时对指定条件的线索生成诊断报告。
入口：ShareAgent>自动化
2.3 在商机数据详情页中查看诊断结果
ShareAgent中对话产生的诊断报告、Agent自动化任务产生的诊断报告，都会自动展示到数据详情页/AI诊断 页签组件中，以便于个人后续查看或团队成员共享。
3. 管理员配置
3.1 租户所属行业配置
商机赢单教练Agent进行线索评分和诊断时，会根据使用者(租户)的行业不同而选择匹配其行业的Knowhow作为评分规则和诊断及建议规范。
这就要求需知晓租户的行业信息，租户级行业信息维护入口：后台管理>业务规则管理>业务洞察Agent>业务洞察Agent设置>公司服务形态
** 延展信息：商机赢单教练Agent读取租户行业并匹配行业Konwhow作为评分及诊断规范的逻辑说明见下方“3.4 商机教练Agent的运行逻辑”模块
3.2 配置对象AI诊断组件
生成的诊断报告若想在线索数据详情页进行查看，需在线索对象中放出“AI诊断”组件（拖出即可，无需其他配置）。
配置入口：后台管理>对象管理>预设对象管理>商机>布局
组件拖出后，会自动获取商机诊断报告的最新报告进行呈现。（诊断结果的呈现不按人员做区分，A员工触发的诊断结果，B员工可看，且B员工重新触发诊断，结果会覆盖A员工所生成结果）
3.3 商机赢单教练Agent的构成
线索转换教练Agent由以下 6 个 skill 构成：
sfa-biz-router：路由 Skill，负责先识别当前问题是不是商机相关问题，并把请求分发到正确的下游能力。
商机评分：对商机对象及关联数据做评分，输出评分结果和评分依据。
商机诊断（画像生成）：基于评分结果生成完整诊断报告，输出卡点、风险、打法策略、行动建议和情报研判等内容。
需求分析：分析商机需求是否清晰、需求成熟度如何、当前需求侧有哪些问题。
决策链诊断：分析决策链是否完整，关键角色是否覆盖，是否存在决策缺口。
商机竞争分析：分析当前商机的竞争态势、竞争风险和相对机会点。
几个Skill的调用关系如下：
3.4 商机赢单教练Agent的运行逻辑
3.4.1 输入商机
即在前文2.1、2.2中讲的ShareAgent中发起询问及Agent自动化任务 对Agent能力的触发。
3.4.2 识别卖方行业
商机赢单教练Agent的诊断逻辑不是一套通用模板硬套所有行业，而是要先知道“卖方是谁、卖的是什么、属于什么行业”，才能选对后面的诊断 Flow、评分标准和推进方法。
卖方行业识别的方法：sfa-account-score、sfa-account-diagnosis 两个Skill的references中均有data-query.md，其中均包含“卖方行业配置”查询模块，如下：
卖方行业配置（SELLER_INDUSTRY）
读取卖方主营行业配置，得到 `SELLER_INDUSTRY`，用于增强远端 knowhow 检索主题：
```bash
sharecrm sales get-config-by-key --data '{"key":"service_models"}'
```
返回结果中如存在明确行业名称，则记为 `SELLER_INDUSTRY`。
- 若返回为空、不可用或无法判断行业：`SELLER_INDUSTRY` 置空。
- `SELLER_INDUSTRY` 为空时，后续远端 knowhow 查询不拼接行业，并在诊断输出中标注“缺少卖方行业信息”。
- 不得由模型猜测行业，不得用客户行业字段替代卖方行业。3.4.2 加载诊断Flow
商机评分、商机诊断(画像生成)、需求分析、决策链诊断、竞争分析这几个Skill执行处理流程及评分/诊断规则时会根据租户所在行业查询Know-how，以查到的Know-how作为流程及评分/诊断规则标准。
行业查询Know-how查询方式：每个Skill的references/下的.md文件，在头部均有一段优先查询远端文档(Know-how)的指令，示例如下：
这段指令会查询 后台管理>业务规则管理>业务洞察Agent>Knowhow中的文档，过滤条件由3部分构成：
1.SELLER_INDUSTRY：赋值为“3.4.2 识别卖方行业”获取到的值，匹配文档中的"卖方(我方)/"下的行业信息，比如图中的"SaaS软件"行业。
2.scene：固定赋值"business_insight"（含义为业务洞察），匹配文档中的"场景"信息。
3.coreTopics：每个references/下的.md文件描述各不相同，匹配文档中的"核心主题"。
通过以上3点过滤条件，筛出来符合条件的文档后返回给Skill做为流程及评分/诊断规则标准。** 租户级评分/诊断逻辑若有个性化调整需求，可以通过此方式做调整 **
**延展信息：Know-how由“纷享预设”、“租户自定义”两部分构成，其中“纷享预设”的Know-how租户不可见。
Skill的结构构成：
路由 skill：sfa-biz-router
SKILL.md描述中有定义Flow，此文件在项目实施落地过程中不建议做调整。
references/routing-methodology.md中描述具体路由标准和状态/阶段识别标准。项目实施落地过程中，此文件中的“状态/阶段识别标准”部分可以基于不同行业/客户做适当调整。
商机评分 skill：sfa_opportunity_score
- references/data-query.md 定义“查什么数据、怎么查”，它是商机评分前的数据查询说明，负责定位商机对象、查询主数据、销售记录以及各评分维度所需的事实证据。
- references/score-standard.md 定义“怎么打分、怎么评级”，它是商机评分规则本身，负责把查到的事实转换成分数、评级和推进判断。
- references/output_template.md 定义“最终评分报告怎么写”，它是商机评分结果的输出模板，负责约束基本信息、综合评估、分维度评分结果和结论建议的呈现结构。
商机诊断(画像生成) skill：sfa_opportunity_diagnosis
- references/data-query.md 定义“查什么数据、怎么查”，它是商机诊断前的数据查询说明，负责定位商机对象、查询主数据、销售记录以及诊断所需的关键上下文。
- references/flow.md 定义“怎么分析、按什么顺序生成诊断”，它是商机诊断的流程编排，负责组织诊断视角、分析步骤和输出顺序。
- references/global-diagnosis-criteria.md 定义“怎么判断诊断结论是否成立”，它是全局诊断标准，负责约束商机状态、推进质量和问题判断的统一口径。
- references/output_template.md 定义“最终诊断报告怎么写”，它是商机诊断报告的输出模板，负责约束概要、核心结论、诊断分析和建议输出的呈现结构。
需求分析 Skill：sfa_needs_discovery
- references/data-query.md 定义“查什么数据、怎么查”，它是需求挖掘前的数据查询说明，负责定位对象、查询主数据、销售记录以及分析所需的关键上下文。
- references/flow.md 定义“怎么分析、按什么顺序生成结果”，它是需求挖掘的流程编排，负责组织分析步骤、推理顺序和输出节奏。
- references/knowhow.md 定义“需求挖掘主要看什么”，它是需求挖掘的方法说明，负责提供业务场景下识别客户需求、问题和机会的通用 knowhow。
- references/need-analysis-framework.md 定义“需求要按什么框架拆解”，它是需求分析框架，负责把收集到的事实整理成结构化的需求判断维度。
- references/hidden-demand-inference-rules.md 定义“怎么识别隐性需求”，它是隐性需求推断规则，负责从显性信息中抽取潜在但尚未被客户直接表达的需求线索。
- references/budget-and-stakeholder-rules.md 定义“怎么判断预算和关键干系人”，它是预算与干系人分析规则，负责识别预算信号、决策角色和推动关系。
- references/output-template.md 定义“最终分析结果怎么写”，它是需求挖掘结果的输出模板，负责约束结论、分析内容和建议部分的呈现结构。
- references/downstream-summary-template.md 定义“怎么给下游 skill/流程传递摘要”，它是下游摘要模板，负责把需求挖掘结果整理成便于后续流程继续消费的结构化摘要。
决策链诊断 Skill：sfa_decision_chain_diagnosis
- references/data-query.md 定义“查什么数据、怎么查”，它是决策链诊断前的数据查询说明，负责定位对象、查询主数据、销售记录以及判断决策链所需的事实证据。
- references/score-standard.md 定义“怎么判断决策链质量、怎么分级”，它是决策链诊断规则本身，负责把查到的事实转换成对决策角色、影响路径和推进成熟度的判断结果。
- references/output_template.md 定义“最终诊断结果怎么写”，它是决策链诊断结果的输出模板，负责约束基本信息、诊断结论、决策链分析和建议输出的呈现结构。
商机竞争分析 Skill：sfa_opportunity_competitive_analysis
- references/data-query.md 定义“查什么数据、怎么查”，它是商机竞争分析前的数据查询说明，负责定位商机对象、查询主数据、销售记录以及竞争判断所需的关键事实。
- references/diagnosis-criteria.md 定义“怎么判断竞争态势和优劣势”，它是竞争分析规则本身，负责把查到的事实转换成竞品格局、我方优劣势和赢单风险的判断结果。
- references/output-template.md 定义“最终竞争分析结果怎么写”，它是商机竞争分析的输出模板，负责约束核心结论、竞争格局分析和建议动作的呈现结构。
3.4.3 按需取CRM数据
商机评分、商机诊断(画像生成)、需求分析、决策链诊断、竞争分析 这5个Skill的references/data-query.md 中定义运行该Skill需获取哪些关联数据。
3.4.4 形成诊断
商机评分过后会将评分结果及评分依据传递至下游商机诊断(画像生成)进行诊断，生成诊断结果。
3.4.5 模板化输出
最终商机诊断报告由商机诊断(画像生成)Skill的输出模板references/output_template.md来定义。
如果是专项诊断，则由需求分析/决策链诊断/竞争分析Skill的输出模板references/output_template.md来定义。
输出形式分为两种：
1、Markdown，该格式报告严格按照references/output_template.md约束输出。
2、HTML，该格式报告是在Markdown输出的基础上，调用scripts/build-html-report.py脚本，按照assets/output.html样式进行输出。