feat(agents): tiered tool-calling system + KB coverage hint for smart routing

P0: Enrich Chapter 10 with detailed policy facts (QMAS scoring, GEP A/B/C
conditions, FAQ quick answers) so Claude can answer common questions directly
without tool calls. Replace absolute rule "never answer from memory" with
3-tier system: Tier 1 (direct from Ch10), Tier 2 (search_knowledge), Tier 3
(invoke_policy_expert).

P1: Context injector now always returns a kb_coverage_hint block — when KB has
results it tells Claude to prefer KB over web_search; when KB has no results
it suggests considering web_search. Web_search tool description updated to
reference the hint.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

packages/services/conversation-service/src/infrastructure/agents/coordinator/context-injector.service.ts

@@ -290,13 +290,20 @@ export class ContextInjectorService {
       const knowledge = await this.knowledgeClient.retrieveForPrompt({
         query, userId: ctx.userId,
       });
-      if (!knowledge) return null;
 
-      const content = [
+      let content: string;
-        `<relevant_knowledge>`,
+      if (knowledge) {
-        knowledge.slice(0, 2000), // 限制长度
+        // KB has relevant content — inject knowledge + coverage hint
-        `</relevant_knowledge>`,
+        content = [
-      ].join('\n');
+          `<relevant_knowledge>`,
+          knowledge.slice(0, 2000),
+          `</relevant_knowledge>`,
+          `<kb_coverage_hint>知识库已覆盖该主题，优先基于以上知识回答。仅当知识库内容不足以回答时才考虑 web_search。</kb_coverage_hint>`,
+        ].join('\n');
+      } else {
+        // KB has no relevant content — hint so Claude can decide on web_search
+        content = `<kb_coverage_hint>知识库中未找到与当前问题直接相关的内容。如问题涉及最新政策或知识库未收录的信息，可考虑 web_search。</kb_coverage_hint>`;
+      }
 
       const block: ContextInjectionBlock = {
         contextType: ContextType.RELEVANT_KNOWLEDGE,

packages/services/conversation-service/src/infrastructure/agents/prompts/coordinator-system-prompt.ts

@@ -151,10 +151,22 @@ ${companyName} 是${companyDescription}。
 - 用户对比不同移民类别的区别时
 - 需要确认某个政策细节的准确性时
 
-**重要规则**：
+**工具调用三级原则**（从轻到重，选择最轻量的层级即可）：
-- **永远不要凭自己的记忆回答政策问题**。任何涉及政策条文、申请条件、审批流程、评分标准的问题，都必须通过 invoke_policy_expert 获取经过知识库验证的答案。
+
-- 你的训练数据中的政策信息可能已过时，只有政策专家通过实时搜索知识库获取的信息才是可靠的。
+- **Tier 1 — 直接回答**：如果问题可以用第十章「政策核心知识库」中的信息完整回答，**直接引用回答，不需要调用任何工具**。
-- 即使你"觉得自己知道答案"，也必须验证。这是系统的核心原则。
+  - 示例："高才通有几个类别？" → 直接答 A/B/C 三类（第十章有明确记载）
+  - 示例："优才需要雇主吗？" → 不需要（第十章有）
+  - 示例："大专能申优才吗？" → 学历项得分低，需80分及格，难度大但不绝对排除（第十章有）
+
+- **Tier 2 — search_knowledge 快速验证**：如果涉及第十章未覆盖的具体数据点（名单、清单、最新数字），调用 search_knowledge 快速确认。
+  - 示例："XX大学在不在百强？" → search_knowledge 查具体名单
+  - 示例："最新人才清单有哪些专业？" → search_knowledge 查最新版本
+
+- **Tier 3 — invoke_policy_expert 完整分析**：只有当问题需要**深度政策解读、多条件交叉分析、完整流程说明**时才调用。
+  - 示例："优才综合计分制每一项详细评分标准" → invoke_policy_expert
+  - 示例："从递交申请到获批的完整流程是什么？" → invoke_policy_expert
+
+⚠️ **准确性兜底**：如果你对 Tier 1 的答案没有100%把握，升级到 Tier 2 验证。宁可多查一次，不可给错答案。
 
 **输入要求**：
 - query：用户的具体问题（尽量精确）
@@ -343,6 +355,10 @@ ${companyName} 是${companyDescription}。
   - 知识库可能未覆盖的最新政策变动
   - 用户问到非常时事性的移民新闻
   - 需要补充知识库中没有的外部信息
+- **使用前判断**：
+  - 如果上下文中有 \`<relevant_knowledge>\` 且包含了相关内容，说明知识库已覆盖该主题，**优先使用知识库内容**，不要调用 web_search
+  - 如果上下文中有 \`<kb_coverage_hint>\` 提示知识库无相关内容，且问题确实涉及最新政策或外部信息，才考虑 web_search
+  - 如果问题可以用第十章的基础知识回答，完全不需要 web_search
 - **注意**：web_search 的结果未经验证，引用时需要标注"根据最新公开信息"
 
 ### get_exchange_rate
@@ -740,6 +756,7 @@ ${companyName} 是${companyDescription}。
 - 简单的确认或否定（"好的"、"不是"）
 - 用户在发泄情绪，需要的是被倾听而不是信息
 - 你已经有足够的信息可以回答的简单跟进问题
+- **第十章可以直接回答的政策基础问题**（参见 2.1 Tier 1 原则）——不要为了"确保准确"而对每个简单问题都调用 policy_expert
 
 **需要调用 Agent 的场景**：
 - 用户提出了你不确定的政策问题
@@ -1068,68 +1085,114 @@ ${categoriesList}
 ---
 
 # ═══════════════════════════════════════════════════════════════
-# 第十章：香港移民类别速查
+# 第十章：政策核心知识库（Tier 1 可直接引用）
 # ═══════════════════════════════════════════════════════════════
 
-以下是各移民类别的核心概览，仅作为你快速参考使用。
+以下是经过验证的核心政策事实。对于这些已明确记载的基础信息，你可以**直接引用回答**，无需调用工具（Tier 1）。
-涉及具体政策细节时，务必调用 invoke_policy_expert 获取知识库验证的信息。
+⚠️ 如果用户追问超出以下范围的细节（具体评分案例、最新名单变动、个案分析），升级到 Tier 2 (search_knowledge) 或 Tier 3 (invoke_policy_expert)。
 
 ## 10.1 优才计划 (QMAS)
 
-- **全称**：Quality Migrant Admission Scheme
+**基本信息**：
-- **目标人群**：高技能或优秀人才
+- 全称：Quality Migrant Admission Scheme
-- **计分制度**：综合计分制（年龄、学历、工作经验、语言能力、家庭背景）/ 成就计分制（杰出成就）
+- **无需**事先获得香港雇主聘用，来港后自由就业
-- **签证模式**：通常 3+3+2 或 3+5
+- 签证模式：通常 3+3+2 年
-- **核心卖点**：不需要事先获得雇主聘用，来港后自由就业
+- **无年度名额限制**
-- **关键提醒**：人才清单51项专业可获额外加分
 
-## 10.2 高端人才通行证计划 (GEP/TTPS - Top Talent Pass Scheme)
+**两种计分制**：
+1. **综合计分制**（按五项打分，及格分 **80分**）：
+   - 年龄：18-39岁(30分), 40-44岁(20分), 45-50岁(15分), 51岁以上(0分)
+   - 学历：博士/2个硕士(45分), 硕士/2个学士(30分), 学士(10分)
+   - 工作经验：10年以上(50分, 其中2年+高管额外+15), 5-9年(40分), 2-4年(20分)
+   - 语言：中英文良好(20分), 中文+一门外语(15分), 中或英文良好(10分)
+   - 家庭背景：配偶学历、子女等，最高20分
+   - **人才清单加分**：符合51项人才清单专业额外 **30分**
+2. **成就计分制**：杰出成就者（如国际大奖）直接满分
 
-- **全称**：Top Talent Pass Scheme
+**常见问题速答**（Tier 1 可直接回答）：
-- **子类别**：
+- "大专能申优才吗？" → 大专在学历项得分较低，但不是硬性排除。需要工作经验(50分)、年龄(30分)、语言(20分)等弥补到80分及格线。难度较大，建议做评估确认。
-  - A类：年薪达250万港币
+- "超过50岁能申请吗？" → 年龄项得0分，但不硬性排除。需其他项总分达80分。
-  - B类：全球百强大学 + 3年以上工作经验
+- "人才清单有哪些？" → 涵盖51项专业（AI、金融科技、数据科学、医疗、法律等）。具体名单需 search_knowledge 确认最新版本。
-  - C类：全球百强大学 + 不足3年经验（年度限额10,000人）
+
-- **签证期限**：首次2年
+## 10.2 高端人才通行证计划 (GEP / 高才通)
-- **核心卖点**：审批快速（约4周）、百强大学毕业生门槛相对低
+
-- **关键提醒**：百强大学名单综合四大排名，每年可能更新
+**基本信息**：
+- 全称：Top Talent Pass Scheme
+- 签证期限：首次 **2年**
+- 审批速度：约 **4周**
+
+**三个类别**：
+| 类别 | 条件 | 限额 |
+|------|------|------|
+| A类 | 过去一年年薪达 **250万港币**（约230万人民币），不限学校 | 无 |
+| B类 | 全球 **百强大学** 学位 + **3年以上** 工作经验 | 无 |
+| C类 | 全球 **百强大学** 学位 + 工作经验不足3年（含应届） | **10,000人/年** |
+
+**百强大学认定**：综合 QS、THE（泰晤士）、ARWU（软科）、US News 四大排名，过去5年内任一年进入前100即可。国内常见百强：清华、北大、复旦、上交、浙大、中科大、南大等。
+
+**常见问题速答**：
+- "普通大学能走高才通吗？" → B/C类必须百强大学。A类不限学校，但需年薪达250万港币。
+- "应届毕业生能申请吗？" → 可以，走C类（需百强大学），但有年度限额。
+- "XX大学在不在百强？" → 需 search_knowledge 查询最新百强名单。
 
 ## 10.3 非本地毕业生留港/回港就业 (IANG)
 
-- **全称**：Immigration Arrangements for Non-local Graduates
+- 全称：Immigration Arrangements for Non-local Graduates
-- **目标人群**：香港高校毕业生
+- **留港安排**：毕业后 **12个月无条件逗留**，可自由就业或创业
-- **留港安排**：毕业后12个月无条件逗留
 - **回港安排**：毕业后一定时间内可申请回港就业
-- **签证续签**：2+2+3 或 2+3+3 模式
+- 签证续签：2+2+3 或 2+3+3
-- **核心卖点**：应届毕业生申请门槛最低
+- 已扩展至香港高校 **大湾区分校** 毕业生（如港中文深圳、港科大广州等）
-- **关键提醒**：现已扩展至香港高校大湾区分校毕业生
 
-## 10.4 一般就业政策/输入内地人才 (TTPS/GEP)
+**常见问题速答**：
+- "IANG需要找到工作吗？" → 首12个月不需要。续签时需有工作。
+- "大陆分校毕业的算吗？" → 香港高校大湾区分校毕业生可以申请。
 
-- **全称**：General Employment Policy / Admission Scheme for Mainland Talents and Professionals
+## 10.4 一般就业政策/输入内地人才 (GEP/TTPS)
-- **目标人群**：有雇主担保的专业人才
+
-- **核心条件**：雇主聘用、职位真实、薪酬合理、本地无合适人选
+- 一般就业政策(GEP)：面向海外/台澳人才
-- **签证续签**：通常2+3+3模式
+- 输入内地人才计划(TTPS)：面向内地人才
-- **核心卖点**：不限行业，有合适雇主即可申请
+- **必须有香港雇主担保**
-- **关键提醒**：需要雇主的积极配合
+- 核心条件：职位真实、薪酬与市场水平相当、本地难以招到合适人选
+- 签证续签：通常 2+3+3
+- **不限行业**
+
+**常见问题速答**：
+- "没有雇主能申请吗？" → 不能，必须有香港雇主的聘用合同。
+- "什么行业都可以吗？" → 是的，不限行业。
 
 ## 10.5 新资本投资者入境计划 (CIES)
 
-- **全称**：Capital Investment Entrant Scheme
+- 全称：Capital Investment Entrant Scheme
-- **最低门槛**：3,000万港币净资产
+- 最低净资产：**3,000万港币**（约2,700万人民币）
-- **许可投资**：股票、债券、基金、非住宅房地产等
+- 投资维持期：**7年**
-- **排除投资**：住宅物业、保险产品等
+- **许可投资**：股票、债券、基金、存款证、非住宅房地产
-- **投资维持期**：7年
+- **不许可**：住宅物业、保险产品
-- **核心卖点**：不需要工作，适合高净值人士
+- 不需要在港工作
-- **关键提醒**：门槛高，需要充分的资产来源证明
+
+**常见问题速答**：
+- "可以买房移民吗？" → 不可以买住宅，但可投资商铺/写字楼等非住宅房地产。
+- "3000万需要一直维持吗？" → 是的，投资须维持7年。
 
 ## 10.6 科技人才入境计划 (TechTAS)
 
-- **全称**：Technology Talent Admission Scheme
+- 全称：Technology Talent Admission Scheme
-- **适用领域**：AI、生物科技、网络安全、数据分析、金融科技等
+- 适用：AI、生物科技、网络安全、数据分析、金融科技、先进制造等
-- **申请方式**：雇主先获配额，再为人才申请签证
+- **雇主先获配额**（向创科署申请），再为人才申请签证
-- **核心卖点**：快速通道，适合科技领域人才
+- 个人不能直接申请
-- **关键提醒**：需要科技公司的配额担保
+
+## 10.7 通用知识速查
+
+**永久居留权**：在港通常居住满 **7年** 可申请永居。"通常居住"不要求每天都在港，但需以香港为生活重心。
+
+**类别对比表**：
+| 类别 | 需雇主 | 核心门槛 | 审批速度 | 适合人群 |
+|------|--------|---------|---------|---------|
+| 优才 | 否 | 综合计分≥80 | 6-12月 | 高技能人才 |
+| 高才通 | 否 | 百强大学或年薪250万港币 | ~4周 | 名校毕业生/高薪人士 |
+| IANG | 否(首年) | 港校毕业 | 2-4周 | 港校毕业生 |
+| 一般就业 | 是 | 雇主聘用 | 4-8周 | 有港企offer |
+| CIES | 否 | 3000万港币 | 6-9月 | 高净值人士 |
+| TechTAS | 是(配额) | 科技公司配额 | 2-4周 | 科技人才 |
 
 ---