docs(站点): 把方法论和清单分开 —— 三问是「描述怎么写」,清单只做摘要

上一版我把方法论塞进了清单里(每个工具都写满三问),产品指出搞反了。

**方法论**(描述该怎么写)—— 一条工具描述要答三件事:
  · **干什么**:一句话说清它回答哪个问题
  · **什么时候用、⛔ 什么时候别用**
  · **怎么用**:参数怎么填、跟哪个工具配套
  🔴 点明「什么时候别用」是最值钱的那条:**一个工具能干什么,看名字就猜得到;
    什么时候不该用,只能踩出来** —— 几乎每条背后都有一次实测事故。
  ⚠️ 两条硬边界(都踩过):
    · 返回值只给事实、⛔ 不给成品句子 —— 某个返回值混了给模型的指令,
      模型照抄,内部指令原样贴进主管的对话框。护栏写成规范,⛔ 不写成台词。
    · 描述里⛔ 不留**正面举例** —— 写了「他会说『只要商保直付的』」,
      模型把这个例子逐字念给主管,而那版数据里根本没这一类。反例可留,正例不留。

**清单**:21 个工具各一句话,⛔ 不再重复三问。

MDX 编译通过。

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

apps/pac-docs/content/docs/design/assignment-agent.mdx

@@ -267,16 +267,20 @@ flowchart TD
 
 ### 工具描述怎么写
 
-工具描述是模型**决定调不调**时唯一能看的东西，所以它要答四件事：
+工具描述是模型**决定调不调**时唯一能看的东西。一条描述要答三件事：
 
-| 要答的 | 例子（取自真实描述） |
+| | 写什么 |
 |---|---|
-| **它答什么问题** | 「召回工作台：列出待跟进的召回计划…回答『现在该联系谁 / 今日推荐』」 |
-| **⚠️ 哪里容易误读** | 「这一层是 PAC **推断**出来的，⛔ 不是原始记录 —— 原始记录见 `get_facts`」 |
-| **⛔ 什么时候不该用它** | 「能不能做**不用问它**：做得了的事，对应的工具就在你手上；做不了的，那个工具压根不会出现」 |
-| **配套的那个工具是谁** | 「他问『今天有多少人要跟』时先用它给摘要，再用 `list_recall_queue` 取明细」 |
+| **干什么** | 一句话说清它回答哪个问题 —— 「回答『现在该联系谁 / 今日推荐』」 |
+| **什么时候用、⛔ 什么时候别用** | 「⛔ 出方案**不需要**先调它，方案自己会取名册」「⛔ 试探性调一次没有『预览』，那一次就是真撤」 |
+| **怎么用** | 参数怎么填、跟哪个工具配套 —— 「先用它给摘要，再用名单取明细」 |
 
-两条硬边界：**返回值只给事实、⛔ 不给成品句子**（否则模型照抄，内部指令会原样贴进主管的对话框 —— 踩过）；**中文标签只有一处真源**，⛔ 不在工具层另立一套（两份必然漂）。
+**「什么时候别用」是最值钱的那一条，也几乎每条背后都有一次实测事故。**「不需要先调看人手」是抓到模型写字前白调了一次、返回的数一个没用上；「撤销没有预览」是因为它真的没有。**一个工具能干什么，看名字就猜得到；什么时候不该用，只能踩出来。**
+
+⚠️ 两条硬边界：
+
+- **返回值只给事实，⛔ 不给成品句子** —— 踩过：某个返回值里混了给模型的指令，模型照抄，内部指令原样贴进了主管的对话框。护栏要写成**规范**，⛔ 不写成台词。
+- **描述里⛔ 不留正面举例。** 也踩过：描述里写「他会说『只要商保直付的』」，模型把这个例子**逐字念给主管听**了，而那一版数据里根本没有这一类。⇒ 反例可以留，正例不留。
 
 ### 全部工具
 
@@ -284,36 +288,33 @@ flowchart TD
 
 **两种人都有（9 个）**
 
-| 工具 | 干什么 | 什么时候用 · ⛔ 什么时候别用 |
-|---|---|---|
-| **我是谁** | 当前登录人、能管哪几家诊所、有什么权限 | 要用到诊所范围时才调。⛔ **「我能不能做某件事」不用问它** —— 做得了的事，工具就在手上；做不了的，那个工具压根不会出现 |
-| **找患者** | 按姓名 / 手机 / 患者号模糊找，返回候选卡片（手机号掩码）用于消歧 | 先用它拿到患者，再调其它工具 |
-| **患者全貌** | 一次拉全：画像要点 + 近期事实 + 当前召回计划 | 联系患者前的**首选**，省去多次往返 |
-| **患者画像** | 全量画像：价值分群 / 生命周期 / 治疗史 / 敏感 / 禁忌 / 潜在治疗 | ⚠️ 这一层是 PAC **推断**的，⛔ 不是原始记录 —— 原始记录去查「患者事实」 |
-| **患者事实** | 真实发生过的事（诊断 / 治疗 / 预约 / 收费），按时间排 | ⚠️ 只回**当前有效的那一版**，改过的记录不会连旧版一起出现，⛔ 别当成"改过两次"。⛔ 不含任何推断 |
-| **这次为什么召回他** | 当前召回计划：什么场景、什么原因、优先级、目标诊所 | 没有在跑的计划就返回空 |
-| **召回池名单** | 待跟进的人，按优先级排 | 回答「现在该联系谁 / 今天推荐谁」。⚠️ 没有看全池权限的人，拿到的**只是自己名下**那些 —— ⛔ 别说成"整个池子" |
-| **召回池概览** | 总量 + 优先级分档 + 病种分布 | 他问「今天有多少人要跟」时**先用它给摘要**，再用名单取明细 |
-| **画出来** | 把数据渲染成图 | 成批的条目、一张画像、一份报表 —— **适合看不适合读**的用它；简短问答直接说话 |
+| 工具 | 一句话 |
+|---|---|
+| 我是谁 | 当前登录人、能管哪几家诊所 |
+| 找患者 | 按姓名 / 手机 / 患者号模糊找人 |
+| 患者全貌 | 一次拉全：画像要点 + 近期事实 + 当前召回计划 |
+| 患者画像 | 全量画像 —— PAC **推断**出来的那一层 |
+| 患者事实 | 真实发生过的事，按时间排 —— **不含推断** |
+| 这次为什么召回他 | 当前召回计划：场景、原因、优先级 |
+| 召回池名单 | 现在该联系谁，按优先级排 |
+| 召回池概览 | 总量 + 优先级分档 + 病种分布 |
+| 画出来 | 把适合看不适合读的东西渲染成图 |
 
 **只有主管有（另 12 个）**
 
-| | 工具 | 干什么 | 什么时候用 · ⛔ 什么时候别用 |
-|---|---|---|---|
-| **选人** | **看人手** | 在岗客服名册 + 各自在手量 | 他问名册、问谁手上空时用。⛔ **出方案不需要先调它** —— 方案自己会取名册（曾实测白花过一次调用）|
-| | **看这批人构成** | 这批人各画像维度各多少人 | 切之前先看，免得切完只剩三个 |
-| **出方案** | **出一版方案** | 从池子按条件选人 + 排客服 + 算引导，**一次算完** | 他说出要哪一批就调。**换条件重来也是重调它出新的一版**，⛔ 不是在上一版排好的人里再挑。⛔ 它不写任何数据 |
-| | **看当前确认单** | 那张单**现在**什么样：排了几条、落在谁头上、还差什么 | 他在卡片上动过手之后**必须先调它**再报数 —— ⚠️ 卡片上的改动助手看不见，⛔ 别拿出方案那一版的旧数去算 |
-| | **改确认单** | 移出谁 · 改派给谁 · 改时效 · 设福利 | 他提出具体改动就调。一条指令 = **选谁 · 干什么 · 给谁**。⛔ 只改这一版的局部，换人群、改人数要重出 |
-| | **摆确认单** | 决定明细落在正文哪一句之后 | ⛔ 方案没算出来前别调（他会看到一块空的）；⛔ **算出来了也别急着调** —— 先把怎么排的讲完，明细是给他核对你那几句用的 |
-| | **摆引导** | 决定可动手的事落在哪 | 讲完一类**紧接着**调一次。⛔ 别攒着一起调 —— 前一类的按钮会落到后一类的说明后面 |
-| **追踪** | **分过哪几批** | 批次列表 + 每批汇总（分了多少 / 已处理 / 在手 / 退回 / 几个客服） | 他问哪批出了问题、哪批没动静时用 |
-| | **某批怎么样了** | 单批全貌：进度 · 按客服拆 · 退回原因 · 通话成效 · 逐条纪要 | 回答「那批怎么样了 / 谁为什么退回 / 客服怎么说的」 |
-| | **为什么分给了他** | 从**分配当时**的决策快照查 | ⛔ 不要自己推理。⚠️ 只回已经确认分下去的；⚠️ 回的是**当时**的情况，⛔ 别拿"现在"的值解释"当时"的决定 |
-| **收回** | **撤销整批** | 限时收回一整批 | ⚠️ **唯一会改数据的工具**，而且**撤了就收回了** —— 客服手上那批活当场消失。⛔ 只在他明确要求时调，**试探性调一次没有"预览"，那一次就是真撤** |
-| **取做法** | **取一份做法** | 某一类活按什么顺序做 | **动手之前**取一次。⛔ 它不查数据 —— 取回来的是做法，事实仍然要去调对应的工具 |
-
-⚠️ 上面每一条的「⛔ 别用」都不是凭空写的：**几乎每一条背后都有一次实测事故**。例如「出方案不需要先调看人手」那句，是抓到模型在写字前先白调了一次、返回的数一个都没用上；「撤销没有预览」那句，是因为它真的没有。
+| | 工具 | 一句话 |
+|---|---|---|
+| **选人** | 看人手 | 在岗客服名册 + 各自在手量 |
+| | 看这批人构成 | 这批人各画像维度各多少人 |
+| **出方案** | 出一版方案 | 选人 + 排客服 + 算引导，一次算完 |
+| | 看当前确认单 | 那张单**现在**什么样（他动过手之后助手看不见） |
+| | 改确认单 | 移出谁 · 改派 · 改时效 · 设福利 |
+| | 摆确认单 / 摆引导 | 决定它们落在正文哪一句之后（两个工具） |
+| **追踪** | 分过哪几批 | 批次列表 + 每批汇总 |
+| | 某批怎么样了 | 进度 · 按客服拆 · 退回原因 · 通话成效 · 逐条纪要 |
+| | 为什么分给了他 | 从分配**当时**的决策快照查 |
+| **收回** | 撤销整批 | 限时收回 —— **唯一会改数据的工具** |
+| **取做法** | 取一份做法 | 某一类活按什么顺序做（见 §2） |
 
 ---