diff --git a/skills_library/pipelines/opportunity_general/common/opp-workflow/SKILL.md b/skills_library/pipelines/opportunity_general/common/opp-workflow/SKILL.md
index 464da64..5ea0012 100644
--- a/skills_library/pipelines/opportunity_general/common/opp-workflow/SKILL.md
+++ b/skills_library/pipelines/opportunity_general/common/opp-workflow/SKILL.md
@@ -29,9 +29,24 @@ description: 商机产线总纲——数据来自数据爬取平台，产线工
 | opp_submit_report | 提交人工确认（draft→confirmed 门禁） | 报告写完等用户确认 |
 | opp_list_approvals | 列研发审批单 | 审批进度查询 |
 | opp_diagnose | 产线自检（报告/审批分布、待办、平台连通） | 卡点诊断 |
+| opp_start_mining | 启动需求挖掘批次（后台：拉取众包需求→向量化→语义聚类→LLM命名类别）。scope=top 出全量TopX热门类别排名；scope=targeted+keyword 在指定类型内聚类找子型。立即返回 batch_id | "市场上什么软件需求最多""需求挖掘""分析XX类需求的细分" |
+| opp_mining_status | 批次状态轮询（pulling/embedding/clustering/naming/done/failed+原因） | 挖掘批次进度 |
+| opp_list_clusters | 类别排名表（热度/需求数/占比/命名证据）= TopX 热门需求类别 | "挖出来哪些类""TopX类别" |
+| opp_cluster_detail | 某类别的类内需求明细样例（每条带来源URL可查证） | "这类里具体有哪些需求" |
 
 ## 流程链
-热点软件/招标检索 → 选定方向 → 编写研发报告（草稿）→ 提交人工确认（门禁）→ 确认后发起研发审批 → 审批通过即立项方向
+**链路A（招标情报）**：热点软件/招标检索 → 选定方向 → 编写研发报告（草稿）→ 提交人工确认（门禁）→ 确认后发起研发审批 → 审批通过即立项方向
+**链路B（需求挖掘）**：opp_start_mining（top全量 / targeted指定类型）→ opp_mining_status 轮询到 done → opp_list_clusters 看 TopX 类别排名 → 选定类别 opp_cluster_detail 取带来源样例 → 结合数据写研发报告（链路A 的报告/确认/审批门禁）
+
+### 需求挖掘使用要点
+- 挖掘是**后台批次**：opp_start_mining 立即返回 batch_id，**不要傻等**；每轮用
+  opp_mining_status 报告当前状态（pulling/embedding/clustering/naming），failed 时
+  如实转述 error_msg 原因，禁隐瞒、禁假装成功。
+- **聚类结果只能来自 opp_* mining 工具返回**——禁止自己编类别名/编排名/编数量/编占比。
+  向用户呈现 TopX 时用 opp_list_clusters 的真实数字（需求数/占比）。
+- targeted 模式必须带 keyword（如"合同管理""小程序"），缺则工具直接拒绝。
+- 类别命名带 naming_evidence（样例标题），命名可疑时如实说明依据。
+- 类内明细每条带来源 URL，回答时按"数据来源"规范挂 markdown 链接可查证。
 
 ## 报告正文四节模板（2026-09-09 硬要求）
 opp_create_report / opp_update_report 正文必须按四个二级标题组织，「📊 研发报告」详情页逐节渲染：