> ## Documentation Index
> Fetch the complete documentation index at: https://docs.profy.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 专家蒸馏

> 一场受控的结构化对话，把认知写进专家的 12 个字段

蒸馏是创造专家的主路径：你和一个处于「蒸馏模式」的专家对话，它做调研、跟你确认、然后把结论**直接写进你新专家的字段**。

<Note>
  蒸馏不是表单，也不是向导 API——它就是一场对话。但它是一场**有硬性阶段和门禁**的对话：调研不能跳过、场景校准不能跳过、必须至少产出一个技能。这些约束写在蒸馏模式的契约里，不是建议。
</Note>

## 它到底改了什么

蒸馏专家用 `distill_manage` 工具写你新专家的 12 个字段：

| 字段                   | 写什么                             |
| -------------------- | ------------------------------- |
| `name`               | 简短好记的专家名                        |
| `description`        | 一句话定位，用于市场列表                    |
| `category`           | 分类                              |
| `persona`            | 角色定位 + 心智模型 + 决策启发式 + 价值观 + 反模式 |
| `soul`               | 诚实边界 + 内在张力 + 行为约束              |
| `agent-instructions` | 表达 DNA + 回应策略 + 禁止行为            |
| `opening-message`    | 开场白（身份 + 能力范围 + 3 个示例问题）        |
| `overview`           | 市场详情页的 HTML 概览                  |
| `guard`              | 知识产权保护策略                        |
| `tool-configs`       | MCP 等外部服务连接                     |
| `tools-allow`        | 工具白名单                           |
| `tools-deny`         | 工具黑名单                           |

<Warning>
  **每次写入都是整字段覆盖，不是追加。** 想增量修改，蒸馏专家必须先读回当前内容、在本地合并、再整体写回。如果你在对话中途说「persona 里再加一条」，它读回失败就可能把原内容冲掉——所以关键阶段结束后去 Studio 看一眼字段内容是值得的。
</Warning>

五个认知层最终落到三个内容字段，不是一层一个字段：

```text theme={null}
心智模型 ┐
决策启发式 ├─→ persona
反模式   ┘
诚实边界 ──→ soul
表达 DNA ──→ agent-instructions
```

<Warning>
  **认知层不是技能。** 蒸馏契约明确禁止创建名为 `mental-model` / `decision-heuristics` / `expression-dna` / `anti-patterns` / `honesty-boundaries` 的技能——它们是内容，属于上面三个字段。技能编码的是可复用的**流程**。
</Warning>

## 完整流程

蒸馏一开始就会创建一个 `DRAFT` 状态的专家（标识形如 `distilled-xxxxxxxx`，版本 `0.0.1`），后续所有写入都落到这一行。所以中途断了不会白做——草稿一直在你的作品列表里。

<Steps>
  <Step title="Phase 0 · 入口分流">
    明确目标（「蒸馏芒格」「做一个费曼专家」）走直接路径；模糊需求（「我想提升决策质量」）走诊断路径——它会用 1-2 轮收窄，然后推荐 2-3 个候选让你选。
  </Step>

  <Step title="Phase 0A/0B · 澄清与素材">
    确认身份、focus、用途，并问你有没有本地材料。

    **如果你说有材料但还没上传，它必须停下来等。** 不会先跑调研——这条是硬规则，避免它基于公开信息编出一套你并不认可的框架。
  </Step>

  <Step title="Phase 1 · 六维调研">
    | 维度  | 找什么       | 提取重点             |
    | --- | --------- | ---------------- |
    | 著作  | 书、长文、论文   | 反复出现的核心论点、自创术语   |
    | 对话  | 播客、访谈、AMA | 被追问时的回答方式、即兴类比   |
    | 表达  | 社交媒体      | 高频用词句式、争议立场、幽默方式 |
    | 他者  | 他人分析与批评   | 外部观察到的模式         |
    | 决策  | 重大决策、转折点  | 决策背景与逻辑、事后反思     |
    | 时间线 | 完整时间线     | 关键里程碑、思想转折点      |

    **调研不能跳过。** 即使目标不是某个具体的人（比如「设计一套通用方法论」），Phase 1 也必须走。
  </Step>

  <Step title="Phase 1.5 · 调研 Review">
    暂停，给出调研质量摘要，等你点头。材料不够就在这里补，比写完再返工便宜得多。
  </Step>

  <Step title="Phase 2 · 提炼并写入">
    提取 **3-7 个心智模型**和 **5-10 条决策启发式**，写进 persona；边界与张力写进 soul；表达风格写进 agent-instructions；再生成开场白、名称、描述和 HTML 概览。
  </Step>

  <Step title="Phase 2.7a · 配置装配">
    分析领域是否需要外部服务（GitHub、Jira 之类的 MCP 连接）。

    这一步**必做**，但不一定有产出——不需要就不写。它填的 API key 是占位符，**真实凭证要你事后在 Studio 里填**。

    工具白名单/黑名单默认不写：所有内置工具默认可用，随手限制只会关掉你以为还在的能力。只有你明确要求限制时才会写 `tools-deny`。
  </Step>

  <Step title="Phase 2.7b · 技能生成">
    **每次蒸馏至少产出 1 个技能**，这是硬要求。技能类型按领域特征定：

    | 领域特征              | 技能类型   | 要脚本吗   |
    | ----------------- | ------ | ------ |
    | 有明确的分步流程或决策树      | 方法论技能  | 否      |
    | 核心价值是思考方式而非流程     | 思维框架技能 | 否      |
    | 能力可变成结构化交付物       | 工具型技能  | 可选     |
    | 涉及数据处理 / 计算 / 可视化 | 数据技能   | **必须** |
    | 涉及文件格式处理 / API 调用 | 集成技能   | **必须** |
  </Step>

  <Step title="Phase 3 · 场景校准">
    **必做，且必须等你明确说「继续」才开始。** 它会用 `Ask` 一次抛出 **5 个测试场景**，覆盖五种情形：

    * 已知问题（它答得对不对）
    * 权衡取舍（它的判断像不像你）
    * 语气（它说话像不像你）
    * 边界（它知不知道自己不知道）
    * 范围外（它会不会硬答）

    每个问题都带选项，一点即答，也可以自己写。

    <Note>
      这一步校准的是**已经写进去的专家行为**，不是你的输入。所以哪怕你前面交代得非常完整，它也不能跳过——你说得清楚，不代表它写对了。
    </Note>
  </Step>

  <Step title="Phase 4-5 · 质检与收尾">
    检查各字段是否填充（含字符数）、心智模型是否在 3-7 个区间、诚实边界是否明确、表达特征是否成立。通过后告诉你去 Studio 点发布。
  </Step>
</Steps>

<Warning>
  **发布不在对话里完成。** 蒸馏专家没有发布权限，它最后只会告诉你去 Studio 编辑页点右上角的「发布」。发布会进审核队列。
</Warning>

## 技能命名的坑

| 规则                                          | 后果                                                           |
| ------------------------------------------- | ------------------------------------------------------------ |
| 技能名必须是**英文 kebab-case**                     | 中文名会让 `skill(activate)` 解析失败——技能存在但永远激活不了                    |
| 更新已有技能时，`SKILL.md` 里的 `name` 必须与原技能**完全一致** | 名字不同不是「改名」，是**新建一个重复技能**                                     |
| 带脚本的技能必须用 `save_dir` 保存                     | 用 `create` / `update` 只存 Markdown 正文，**脚本会丢**，且在 Studio 里看不见 |

带脚本的技能在上传前必须在沙盒里跑通（退出码 0），失败最多修 3 次，还不行就降级成纯 Markdown 技能。所以「蒸馏说技能做好了但用起来报错」这类问题在正常路径上不该出现——真出现就是降级没触发，值得反馈。

<Note>
  `python-pptx` / `reportlab` / `fpdf` / `pptxgenjs` 这四个包被平台禁用。需要出 PPT、PDF 的技能要委托给内置插件（`builtin/presentation`、`builtin/kami` 等），而不是自己装库。
</Note>

## 怎么谈才谈得出东西

<AccordionGroup>
  <Accordion title="准备 3-5 个真实案例">
    具体案例比抽象描述有效得多。抽象描述提取出来的是通用套话，案例里才有你没意识到自己在用的判断规则。
  </Accordion>

  <Accordion title="暴露推理链，不要只给结论">
    别说「我会建议 X」，说「我先看 A 和 B，A 满足 C 时选 X，否则考虑 Y」。前者只能写出一条结论，后者能写出一条决策启发式。
  </Accordion>

  <Accordion title="明确说出你不知道什么">
    诚实边界会写进 soul，直接决定专家会不会硬答。这是买家最容易感知到的质量差异——一个什么都敢答的专家，用两次就没人信了。
  </Accordion>

  <Accordion title="给反例">
    「常见错误是⋯」「有人跟你说 X，通常是错的」——反模式知识是新手和专家的分界线，也是 persona 里最难靠公开资料补齐的部分。
  </Accordion>

  <Accordion title="在 Phase 1.5 认真看调研摘要">
    这是成本最低的纠偏点。调研方向错了不打断，后面写出来的 persona 全部要重来。
  </Accordion>
</AccordionGroup>

## 失败态与排错

| 现象                | 原因                          | 怎么办                     |
| ----------------- | --------------------------- | ----------------------- |
| 它没做调研就开始写         | 违反硬规则                       | 直接说「先做 Phase 1 调研」      |
| 一直在等，不往下走         | 你说了有材料但没上传                  | 上传，或明确说「不用材料，继续」        |
| 没走场景校准就说完成了       | 漏了 Phase 3                  | 说「跑一下场景校准」              |
| 技能激活报错            | 技能名是中文                      | 让它用英文 kebab-case 重建     |
| Studio 里看不到技能脚本   | 用了 `create` 而不是 `save_dir`  | 让它用 `save_dir` 重新保存整个目录 |
| 出现两个几乎一样的技能       | `save_dir` 时 `name` 与原技能不一致 | 删掉重复的那个                 |
| persona 里之前写的内容没了 | 整字段覆盖，未先读回合并                | 去 Studio 手动补回；后续改动一次说清  |
| MCP 连接不工作         | API key 是占位符                | 在 Studio 的工具配置里填真实凭证    |
| 某些内置能力用不了         | 写了 `tools-deny`             | 在 Studio 里清空黑名单         |

## 蒸馏之后

蒸馏产出的是能用的初版，不是终版。接下来：

* 在 Studio 里直接对话测试，验证它答得像不像
* 手动微调 persona / soul / agent-instructions——蒸馏写进去的就是普通字段，你随时可以改
* 从技能市场装更多技能
* 设定价格，提交审核

<Note>
  蒸馏可以反复进行。发布之后，自进化系统还会从真实使用中提出改进建议，由你决定是否采纳。
</Note>

## 相关页面

<CardGroup cols={2}>
  <Card title="端到端：蒸馏造专家" icon="wand-magic-sparkles" href="/zh/documentation/guides/distill-an-expert">
    一次完整蒸馏的实际过程
  </Card>

  <Card title="配置你的专家" icon="sliders" href="/zh/creators/configure-your-expert">
    四层 prompt 注入顺序与全部配置字段
  </Card>

  <Card title="自进化" icon="dna" href="/zh/creators/darwin-evolution">
    发布后的持续改进机制
  </Card>

  <Card title="设置定价" icon="tag" href="/zh/creators/pricing-and-billing">
    解锁费与对话消耗的关系
  </Card>
</CardGroup>