TCM Thinking Distiller

将任意中医师蒸馏为可被 AI 调用的人物技能。 参考案例：references/huxishu-case.md（胡希恕38万字讲稿蒸馏全记录）

工作流总览

结构：两条显式流水线 + 共享模块（保留原 Phase 编号，仅做归类映射，避免大重构）

Pipeline A · 新蒸馏（人 → skill）

Phase 0A（入口分流）
 → Phase 1（10 维并行调研）
 → Phase 2（框架合成 + 首次注册）
 → Phase 3（质量验证·对标 15 维度覆盖率）
 → Phase 4（增量补充·饮食/剂量/条辨）
 → Phase 5（最终注册交付）

Pipeline B · 增量优化（skill → 更好 skill）

Phase 0B（入口分流）
 → Phase B0（入口分流 / 差距分析）
 → Phase B1（对标 15 维度差距分析）
 → Phase B2（10 维并行调研·复用 Phase 1）
 → Phase B3（定向增强合成·P0-P5 优先级）
 → Phase B4（增量素材落盘·modules/ + references/）
 → Phase B5（质量再验证 + 注册）

共享模块 S1-S12（两条流水线共用）

• S1 · Phase 6.6：古今病名映射索引
• S2 · Phase 6.7：强制原文引用与回答协议（V4.3 升级：+输出格式铁律——检索线索（路径/行号/出处）永不进回答；禁学术编号结构；口语化转述三查；详见 references/28 第四节）
• S11 · 表达还原度验证与修复（V4.4 升级）：20 题长答盲评法验证"像不像本人"；六维质地差距检查表（问诊互动/临床故事/调侃/批判强度/口头禅单一/过度规整）；修复 7 技法 + 三件套落地法（前置表达速查卡/回答流程输出形态铁律/语气量化指标，双保险）；实测 10/10 盲评。详见 references/28-expression-verification.md
• S12 · 档案清理与索引健康维护（V4.4d 新增·nihaixia research 清理实战 2026-08-15）："权威 vs 档案"分级（modules/SKILL.md=回答依据，references/research=档案）；档案体检五步（全量阅读→价值画像→处理→更新导航→删除后检查）；删除后索引健康四步法（残留扫描/路径验证×2/关键词脚本失效=0；174 引用 0 失效实测）。详见 references/29-archive-maintenance.md
• S13 · 优化迭代实战法（V4.5c 新增·nihaixia skill 优化实战提炼）：通用 TCM skill 优化作战手册——覆盖优化目标（标注清晰/辨证一致/方剂完整/安全合规/非医学不僵化）、关键步骤（用户反馈捕获 bug→格式铁律→规则膨胀治理→盲区测试→版本标注→编码卫生）、执行逻辑（paired 棘轮：N=3 独立空白 judge、同 call 比两版、奇数 N 多数决、cur≥wor→keep 否则 git revert）、改进要点（8 项，含"精简入口+modules 按需检索"架构教训 -88% prompt token）。Phase B5 判定机制严格按本模块第四节执行。详见 references/30-optimization-playbook.md
• S14 · 非医学问答豁免（V4.5c2 新增·nihaixia 实战）：医学辨证类 skill 的常见负优化是"一刀切必达表格/字数"导致寒暄闲聊也逼出长篇表格，极机械。豁免场景：寒暄/闲聊/致谢/元问题/一句话追问/情绪共情等非辨证类问答，豁免"每答必达表格/加粗/400-500字"，保留人物口语口吻简短答。判定红线：以"问题意图"判（不涉及 症状→证→方 即豁免），不以回答长短判；一旦进入医学辨证立即恢复全部约束。paired 测试 3/3 判含豁免版更好。详见 references/30 第七节 + 本 skill S2 关联。
• S15 · 编码卫生与乱码防治（V4.5c2 新增·nihaixia 乱码返工教训；V4.6 增补·吴鞠通/李可实战）：统一简体 UTF-8、零乱码零繁体残留。nihaixia 曾因繁体残留+GBK mojibake 在多份文档生成后才发现，返工高。三级扫描（P0 U+FFFD > P1 HTML 实体残留 > P2 异写笔误，含假阳性防护）+ 预防（zhconv 转简体——禁自建映射表（实测漏字）、脚本显式 utf-8、kebab 命名）+ 修复映射表 + OCR 图片 URL 清理（PaddleOCR 失效图链接，独立行整删/残壳二次清）+ 外部链接审计（核心文件清零、README/版权页保留）。必须作为 Phase 3 / Pipeline B 注册前硬性健康检查（与索引失效扫描同级）。详见 references/32-encoding-hygiene.md
• S14b · 书籍补遗工作流（V4.6 新增·2026-08-23 李可八书实战）：用户提供新书 OCR 要求"优化进 skill"时的标准流程——摸底→覆盖检查（grep 标志内容判已覆盖/部分/缺失，防重复蒸馏）→缺口判定→补遗蒸馏（剂量必原文核对）→集成验证（索引/编码/文件名/敏感词）。核心陷阱：README 声明来源≠实际收录，以知识库实检为准。详见 references/33-book-supplement-workflow.md
• S16 · 版本标注纪律（V4.5c3 新增·nihaixia 版本混乱教训）：每次优化/注册前先定版本号并全文件同步，杜绝"折中版/当日优化"等口头标签散落。规则：① 重大格式重构→升 X.Y.0（如 2.3.1）；② 当日增量优化→升小版本（如 2.3.2），并在 SKILL.md/README/CHANGELOG 三处同步标注同一版本号；③ CHANGELOG 当日多次修改必记（nihaixia 实测：同日早/午多次大改，只记了早上 → 下午改动全部漏记）→ 每次注册前检查当日条目是否已记录（含同日多次，合并为"vX.Yb 当日补记"或分条）；④ 版本标签禁止只写在一处（等同没写，14b 事故教训）。Phase B5 必检项之一。
• S17 · 仓库推送纪律（V4.5c3 新增·nihaixia 误推送教训）：用户未明确说"推送/push"绝不主动 git push；本地 commit/sync 到仓库也必须先问（nihaixia 实战：agent 未经许可尝试 push 被用户训斥）。Agent 自作主张的 push/commit 一律视为违规。发布纪律红线，挂 S16 同段。
• S3 · Phase 6.8：热度驱动测试训练法
• S4 · Phase 6.9：知识网络体检
• S5 · 角色扮演 7 段式（Pipeline A 在 Phase 2、Pipeline B 在 Phase B3 各应用一次）
• S6 · 15 维度覆盖率验证（Pipeline A 在 Phase 3、Pipeline B 在 Phase B5 各应用一次）
• S7 · 剂量勘误工作流（V4.0 新增，经方/方剂型 skill 必做）：方剂全清单 → 逐方对照源文件提取（分批表格，问题类型：合格/错误/混淆/缺失/无法核对）→ 3 组独立子 agent 二次检测 → P0-P3 分级修复（每处改完验证+注册+复查）→ 汇总报告含 Top10 清单。详见 references/26-dose-audit-workflow.md
• S8 · 版本差异处理（V4.0 新增）：以源文件（人物讲课版）为准；测试/judge 禁止用通行本衡量源文件版剂量（实战 7 处 judge 误判教训）；版本差异显式标注两套并存；同方两书剂量不同时给人物临床实际用量口径。详见 references/26
• S9 · 剂量三体系换算（V4.0 新增）：①考古考证（汉朝1两≈15.6g，仅理解原方规模）②台湾临床（1钱=3.75g）③临床直换铁律（古方一两=临床一钱，人物未说明剂量的方一律按此开方）；三套分别换算严禁混用。详见 references/26
• S10 · 诚实标注规范（V4.0 新增，质量铁律）：无法核对/来源边界/转录矛盾/知识缺口显性化（待补条目）/源文件口误修正（用户确认后）五类必标；宁可显性标注缺口，不可编造填补；子 agent 复核以源文件原文为准（防误报纪律）；注册防回滚。来源追问四段式话术模板（V4.5 新增·nihaixia 15 第3轮实测，judge 评为教科书级）：当用户追问"这个剂量/说法是本人亲口说的还是你编的/算的"时，按四段式回答——①总声明（"一半是本人亲口说的，一半按他的规矩换算/转述的，两样分开，不糊弄你"）②口述部分（列人物讲课原话/原则，可引原文）③换算/转述部分（列规则与依据，如"古方一两=临床一钱"）④底线声明（"人物没说过的话，一个字都不会替他编"）。详见 references/27-honesty-standards.md

Phase 0：入口分流

0A：新蒸馏流程

优先级	来源	示例
1	本地语料	"这是XX的讲稿PDF/Markdown/医案集" → 纯本地模式
2	知识库链接	"ima知识库里有XX的资料" → 混合模式
3	明确人名	"蒸馏胡希恕" → 网络搜索模式

0B：优化已有skill流程

优先级	来源	示例
1	原著原文全文	"这是《四圣心源》全文TXT" → 原文分析模式
2	新上传OCR文件	"这是XX医书的OCR扫描件" → OCR清洗+定位模式
3	知识库新素材	"知识库里新增了XX的著作" → 混合补充模式

中医药师特化确认（两流程共用）

在进入 Phase 1 前确认（有默认值的问题给默认值）：

确认项	默认值	说明
学派归属	自动识别	经方派/温病派/中西汇通/火神派…
核心经典	按学派推断	经方派→伤寒+金匮；温病派→温病条辨
素材完整性	如不确定则标注	标注缺失部分，后续可补
蒸馏档位	标准档	极速(1维)/快速(3维)/标准(10维)/深度(10维+全量素材)
特殊维度	无	针灸/正骨/儿科等专长；功法/修炼/导引体系（道医/养生家，见维度15）

Phase 1：10 维并行调研

启动 10 个并行子 Agent（+1 个可选 Agent 11）。每个 Agent 读取同一份源文件（或通过网络搜索），聚焦不同维度。

模型档定义：

• heavy：深度推理任务（心智模型/决策启发式/方证体系/内在张力/临床安全），需要最大上下文+强推理能力
• light：描述性提取（表达 DNA/反模式/生平/谱系/FAQ/剂量），标准上下文即可

详细任务模板见：references/phase1-agents.md

Agent	维度	产出文件	模型
1	核心心智模型	references/01-core-philosophy.md	heavy
2	临床决策启发式	references/02-decision-heuristics.md	heavy
2b	方证体系（独立 Agent 深挖）	references/24-formula-pattern-system.md	heavy
3	表达DNA	references/03-expression-dna.md	light
4	反模式与诚实边界	references/04-antipatterns-boundaries.md	light
5	生平与学术传承	references/05-biography-legacy.md	light
6	内在张力（升 heavy：需跨文本推理）	references/06-tensions.md	heavy
7	智识谱系	references/07-intellectual-lineage.md	light
8	常见问题速查FAQ	references/08-faq.md	light
9	临床安全层（升 heavy：安全不容偷工减料）	references/09-clinical-safety.md	heavy
10	剂量思维（V3.4 前置提取）	references/12-dosage-framework.md	light
11*	功法/修炼/导引体系（可选，仅道医/养生家）	references/23-gongfa-system.md	light

⚠️ 关键教训：子Agent产出不要压缩。胡希恕案例中产出~50KB被压到12KB，细节丢失严重，需重写。

Agent ↔ 维度映射（10 个 Agent（+1 可选）直接对应 15 个标准维度，覆盖映射见下表；维度 7 饮食调理、维度 8 条辨框架由 Phase 4 增量补充）：

Agent	提取维度	模型
Agent 1	维度 1 · 核心心智模型	heavy
Agent 2	维度 2 · 临床决策启发式（专注决策流程，含分域取法）	heavy
Agent 2b	维度 10 · 方证体系（核心方剂 + 类似方鉴别）	heavy
Agent 3	维度 3 · 表达 DNA	light
Agent 4	维度 4 · 反模式与诚实边界（含维度 5 诚实边界 6 层 + 流派边界防护）	light
Agent 5	维度 9 · 生平与传承（含来源分级）	light
Agent 6	维度 11 · 内在张力	heavy
Agent 7	维度 12 · 智识谱系	light
Agent 8	维度 13 · 常见问题速查 FAQ	light
Agent 9	维度 14 · 临床安全层（含用药铁律）	heavy
Agent 10	维度 6 · 剂量思维（含药材选择偏好）	light
Agent 11*	维度 15 · 功法/修炼/导引体系（可选）	light

维度 6 剂量思维已前置（Agent 10）、维度 10 方证体系已独立（Agent 2b）；维度 7 饮食调理、维度 8 条辨框架由 Phase 4 增量补充；维度 15 功法体系（可选）由 Agent 11 负责。

Phase 2：框架合成 → 注册

SKILL.md 必须包含

1. YAML frontmatter：name(kebab-case≤64字符) + description(触发词+不适用边界)
2. 关键词索引：分组（六经/方剂/症状/饮食/剂量/理论），含搜索位置

⚠️ 索引引用格式铁律（V3.6 新增·nihaixia 事故教训）：

1. SKILL.md 检索索引的"搜索位置"一律用 文件 搜"关键词" 格式（如 <模块文件> 搜"关键词"），禁止在 SKILL.md 正文直写行号（详见第357-396行/L4868/约1009行）——行号在文件更新后必然错位（实测：nihaixia L4868 实际内容在 4965 行）。
2. 行号仅允许存在于独立 INDEX 文件（modules/00_index.md、references/20 场景的篇目导航表），且必须由脚本自动生成校验，禁止手工 hardcode。
3. 关键词必须真实存在于目标文件：新增/修改索引后跑 scripts/validate_keyword_refs.py 验证，0 失效才能注册。
4. 关键词选择原则：按行 grep 统计命中数；命中 <5 行的主题不单独建索引（并入邻近条目）；命中 >400 行属噪音无定位价值（改用聚焦词）；用聚焦词替代泛词（如"月经"84 行 vs "妇人"6 行，选"月经"）。
5. 完整性三检（跨模块引用缺失/完全缺失主题/结构性遗漏）见 references/25-index-audit.md。

3. 诊断公式：适配该中医师的辨证体系公式
4. 方证/方剂速查：类似方鉴别表
5. 角色扮演规则：

7 段固定顺序表（各段模板见 references/10-roleplay-template.md）：

段	段落	必含项/版本来源
1	安全声明	必含项 #11（仅供学术研究与角色演绎）
2	强制引用铁律	S2（必引原文 + 三段式 + ✅❌ 示范）
3	身份卡 / 激活条件	角色触发场景（中医诊断/流派争议/人物观点）
4	路由规则	问题类型→处理方式映射表（诊断题→用其辨证框架；争议题→表达其立场；超出范围→礼貌回避）
5	频率约束	语气/立场使用强度（学术争论保持批评但不攻击；用"我认为"而非绝对化）
6	失败预防	知识库外内容必须明说"该人物讲义中没有涉及，不能替其编造"；禁止联网搜索；不确定时诚实承认
7	内在张力	维度 11（≥3 组观点冲突/实践落差，让 AI 回答时呈现两面而非和稀泥）

V2.3 的 4 段式（激活条件/路由规则/频率约束/失败预防）已被吸收到 7 段式中的第 3-6 段。详细 4 段模板见 references/10-roleplay-template.md；边界应答模板见 references/22-boundary-response.md。

路由规则扩展：跨角色路由（V3.3 新增·可选·多 skill 环境启用）

当用户安装多个中医 skill 时，路由规则段增子规则——超范围问题按问题类型转交其他 skill：

用户问题类型	优先调用	示例
针灸选穴/手法	倪海厦 skill（针灸专长）	"扎什么穴治失眠？"
温病/卫气营血	另寻温病派 skill	"湿温初起如何辨证？"
中医外科/正骨	另寻外科/骨伤 skill	"跌打损伤方？"
道家内丹/养生	苏华仁 skill（道家内丹）	"如何修炼精气神？"

启用条件：用户已安装 ≥ 2 个中医 skill；不启用时此段可省略。 6. 内在张力：该中医师观点冲突/实践落差/立场矛盾 ≥3 组（取自 06-tensions.md，写在角色扮演规则之后，让 AI 回答时呈现两面而非和稀泥） 7. 智识谱系：受谁影响→影响谁→思想地图定位（取自 07-intellectual-lineage.md） 8. 常见问题速查FAQ：5~15 个高频问题直答（取自 08-faq.md，免检索快速响应） 9. 临床安全层：误治急救/传变预警/用药铁律（取自 09-clinical-safety.md，写入安全要求章节） 10. 调研来源表：一手/二手/本地三级分级 11. 安全声明：SKILL.md 首部或角色扮演规则之后固定一段——"本技能仅供学术研究与角色演绎，不构成医疗建议，具体诊疗请咨询执业医师"；若含毒性药/重剂内容，同步在临床安全层标注"严禁自行试药" 12. 前置表达速查卡 + 输出形态铁律（V4.4 新增·人物型 skill 必含，双保险）： - 前置表达速查卡：frontmatter 后第一屏（≤30 行）浓缩该人物表达 DNA——①开场必口语 ②禁表格/编号/小标题/字段 ③表达池三件套量化（口头禅≥2 处交替/追问≥1 处/断言式收束；表达池机制（V4.5 新增·nihaixia 15a/15c 实战）：口头禅池+断言池各建 8-18 个短语，会话级去重——同一会话内已用过的断言短语禁止再用，同义族合并计数（如"一剂就好/一剂就中/一剂知"同属一义族内互斥），池尽后复用须间隔 ≥3 轮）④五大表达模式一句话 ⑤"人物式冗余是加分项"显式声明 ⑥禁忌清单 ⑦输出四查（口语开场/口头禅追问达标/无表格编号结构/引用数量对账——正文出现的引用型条目（方剂名/条文号/穴位名）数量必须与卡片或速查块一一对应，漏=整篇重写）+ 内嵌 ✅❌ 微型对照 - 输出形态铁律：回答工作流"输出回答"步骤（Step 3 式）开头焊死同源铁律（⛔ 违反即整篇重写），与前置卡形成双保险——规则埋在 SKILL.md 深处 = 等于没有（nihaixia 14b 事故教训，见 references/28 四b 节） - 完整范式文件（expression_style 式：完整回答示范/问诊往返/调侃/口头禅库）保留为独立文件，速查卡注明其章节位置按需加载

详细检查清单见：references/phase2-checklist.md

modules/ 构建

modules/
├── 00_index.md # 模块索引（多文件时必生成）
├── 01_shanghan.md # 如果讲稿覆盖伤寒论
├── 02_jingui.md # 如果讲稿覆盖金匮要略
├── 03_yian.md # 如果有医案集
└── ... # 按需

modules/00_index.md（多文件时必生成）

模块 ≥ 2 个文件时必须生成 modules/00_index.md，便于 AI 检索覆盖内容：

文件	内容	覆盖章节	行数	主要病证/主题
01_shanghan.md	伤寒论讲稿	398 条	1.1MB	太阳/阳明/少阳/太阴/少阴/厥阴
02_jingui.md	金匮要略讲稿	22 篇	855KB	妇人/水气/虚劳/痰饮/...

生成时机：Phase 2 modules/ 复制原文后立即生成；在 SKILL.md 关键词索引中加 | 模块索引 | modules/00_index.md | 入口。

cases/ 构建

有医案素材时按疾病分类建案例库（对标 nihaixia 6 类医案库）：

cases/
├── 00_index.md # 医案检索索引（疾病/症状→文件→医案编号）
├── 01_cancer.md # 癌症/肿瘤
├── 02_cardiovascular.md # 心血管
├── 03_metabolic.md # 代谢/内分泌
├── 04_autoimmune.md # 自身免疫
├── 05_neurological.md # 神经/精神
└── 06_other.md # 其他

• 每个医案必须含 证-机-方-效四段链（全部来自原文，缺疗效写"未见记录"）
• SKILL.md 中写"医案参考"路由（病名→cases/ 文件）
• 完整规范见 references/13-cases-guide.md

注册

ima_skill_create -d /root/.skills/{skill_name}/

⚠️ V4.0 修正（wujutong 血泪教训）：注册目录指向 /root/.skills/{skill_name}/（平台实际读取位置）；/sandbox/workspace/skills/{skill_name} 必须保持为指向 /root/.skills/{skill_name} 的符号链接（ln -sf），若为真实目录则平台仅首次复制、后续更新不同步。 第一次注册常因 YAML 头部缺失或格式错误失败（错误码 411003），参考已有 skill 的 SKILL.md 补全。

Phase 3：质量验证（15 维度覆盖率）

倪海厦 skill 依赖说明：nihaixia 是框架设计时的质量标杆，用于提供方向感（"我离最完整的 skill 还差多少"）。若未安装 nihaixia，不影响本流程执行——直接使用下方的 15 维度覆盖率验证，无需对标任何外部 skill。

倪海厦依赖检测（可选）

ls /root/.skills/nihaixia/ 2>/dev/null && echo "nihaixia 已安装，可参考行数基准" || echo "nihaixia 未安装，跳过对标，直接用 15 维度覆盖率验证"

• 已安装 → 可参考 nihaixia 行数（SKILL.md ~11,200 行，modules/ ~3.1MB，cases/ ~6 类）辅助判断差距
• 未安装 → 跳过对标，直接使用 15 维度覆盖率验证，效果完全等价

质量标杆见：references/phase3-quality.md

必检维度（15 维度覆盖率·百分制）

前置门槛（不满足则不进入打分）：

• SKILL.md ≥ 200 行
• 有 YAML frontmatter（含 name + description 触发词）
• 有 modules/（讲稿原文检索能力）
• ima_skill_create 返回 status=1

索引健康检查（V3.6 新增·必检，不通过视为门槛不满足）：

• 无行号引用残留：grep -nE "详见第|见第[0-9]+行|约[0-9]+行|L[0-9]{2,}" SKILL.md 输出为空（原文 INDEX 文件除外）
• 关键词引用 0 失效：python3 scripts/validate_keyword_refs.py --skill SKILL.md 输出"失效 0"
• 完整性三检通过：按 references/25-index-audit.md 执行（跨模块引用/缺失主题/结构性遗漏）

15 维度覆盖率（每维度 1 分，满分 15 分）：

| # | 维度 | 检查项 | 产出 Agent | 必含/可选 | |---|------|-------|:---:| | 1 | 核心心智模型 | 01-core-philosophy.md 含"他说 vs 后人总结"区分 | Agent 1 | 必含 | | 2 | 决策启发式 | 02-decision-heuristics.md 提取 ≥5 条 + 含分域取法 | Agent 2 | 必含 | | 3 | 表达 DNA | 03 文件含术语翻译/口头禅/教学技巧/负面清单 + SKILL.md 前置表达速查卡（frontmatter 后第一屏）与回答流程输出形态铁律双保险 + ✅❌微型对照（V4.4 检查项） | Agent 3 | 必含（人物型） | | 4 | 反模式与诚实边界 | 04 文件含 6 层诚实边界 + ✅/❌ 成对示范 + 流派边界防护 | Agent 4 | 必含 | | 5 | 剂量思维 | 12-dosage-framework.md 含换算/红线/药材偏好/质疑超大剂量 | Agent 10 | 可选（无方剂医家） | | 6 | 饮食调理 | 11-diet-wellness.md 含胃气保养/病后禁忌 | Phase 2 增量 | 可选（道医可缺） | | 7 | 条辨框架 | 含七步条辨法或等效分析框架 | Phase 2 增量 | 可选（歌诀派可缺） | | 8 | 方证体系 | 24-formula-pattern-system.md 含核心方剂 + 类似方鉴别 | Agent 2b | 必含 | | 9 | 生平传承 | 05 文件含来源分级（一手/二手/本地） | Agent 5 | 必含 | | 10 | 内在张力 | 06-tensions.md ≥ 3 组张力，原文支撑 | Agent 6 | 必含 | | 11 | 智识谱系 | 07 文件含受谁影响/影响谁/思想地图 | Agent 7 | 必含 | | 12 | FAQ 速查 | 08-faq.md ≥ 5 个高频问题 | Agent 8 | 必含 | | 13 | 临床安全层 | 09 文件含误治急救/传变预警/用药铁律 | Agent 9 | 必含（医家适用时） | | 14 | 安全声明 | SKILL.md 首部固定声明（仅供学术研究） | Phase 2 框架合成 | 必含 | | 15 | 功法体系 | 23-gongfa-system.md 含次第/功法/禁忌 | Agent 11（可选） | 可选（仅道医/养生家） |

通过线（避免直接拿倪海厦 11,202 行做百分制误导——那是"内嵌原文"特例）：

档位	覆盖率	含义
达标	≥ 9/15（60%）	可发布基础版
优秀	≥ 12/15（80%）	可发布推荐版
标杆	≥ 14/15（90%）	完整版（核心人物标准）

必含维度（共 10 项）必须全部命中，否则不进入打分。

角色一致性自测

结构检查通过后，执行 references/15-consistency-test.md 的 4 类 12 题自测：

• A 知识正确性（3 题）→ 内容对不对
• B 观点立场（3 题）→ 观点像不像
• C 表达风格（3 题）→ 说话像不像
• D 安全边界（3 题）→ 会不会越界

结论规则：❌ ≥ 2 → 回 Pipeline B（Phase B3）定向增强；⚠️ ≥ 3 → 补表达DNA/诚实边界；否则可交付。

原文数字化与验收测试

若蒸馏产物收录大部头原文（医书合集/全本讲稿），必检两项：

1. 原文数字化：按 references/20-original-text-digitalization.md 建立行号索引体系（书目总览+关键词速查+逐篇目行号，校验 0 错误）+ OCR 噪音清理 + 维基对照校对
2. 验收测试：按 references/21-acceptance-testing.md 执行 50 条互联网热度问题实测（综合可答率 ≥80%）+ 负优化审计（优化前存档 full-body，独立子 agent 对比，棘轮回滚）

Phase 4：增量补充

4.1 饮食调理模型（如适用）

从讲稿中搜索：胃气、津液、饮食、能食、不能食、损谷、食复 → 整理为公式+速查表 → references/11-diet-wellness.md

4.2 剂量勘误（S7，方剂/经方型 skill 必做；V4.0 新增）

剂量维度已由 Phase 1 Agent 10 前置提取（12-dosage-framework.md），但提取≠勘误：Phase 4 必须执行 S7 剂量勘误工作流（references/26）——方剂全清单→逐方对照源文件提取（分批表格）→3 组独立子 agent 二次检测→P0-P3 分级修复→汇总报告（含 Top10）。产出 skill 的剂量质量以此为准，非 Agent 10 提取稿。

4.2b 临床剂量补齐（S10，S7 下游延伸；V4.4b 新增·nihaixia 2026-08-14 实战）

勘误只纠错，补齐才闭环：S7 后必须执行 S10 临床剂量补齐工作流（references/26 第五节）——缺药三分类（A 缺姜枣常例 / B 临床只给部分药味 / C 完全无临床记录）→按逐味独立判定生成临床行（①倪师口述优先②无口述按「古方一两=临床一钱」换算③非"两"单位查实物换算表④仍无则保留原单位）→产出临床剂量速查表（references/distilled/）→全库复查（提取全部"XX方"标题对比覆盖、核验上下文剂量词、补漏）。核心原则：临床行永不省略（原书方阙除外）；换算量必须标注〔换算〕与口述区分，不冒认。

4.2c 原文细节一致性铁律 + 临床替代注记（V4.5 新增·nihaixia 15d 用户定稿，方剂型 skill 必做）

• 炮制/细节一致性三级判定：临床用药的炮制字与细节（炙/生甘草、酒制、去节等）必须与原文一致——原方"炙甘草"临床写"炙甘草"、原方"甘草"（生）临床写"甘草"，炮制不同药性不同，禁止互换。判定：①人物口述明确讨论该细节并主动更改（有原话，如倪师白虎加人参汤"你不需要用炙甘草，用生甘草"）→ 按口述标注〔口述·主动改〕；②口述只说"甘草"而原文"炙甘草"（或反之）→ 按转录省略处理，临床按原文写并标注；③两可一律按原文。出卡逐味对照源稿核对炮制字。
• 临床替代注记（人物主动化裁，非转录错误）：人物临床与原方不同的化裁必须显式标注，禁把原方当临床用药——实例：倪师乌头赤石脂丸临床以乌梅代乌头（乌金丸=汉唐32号，丸剂）、栝蒌薤白白酒汤/半夏汤临床以甜酒酿代白酒（两汤匙）。速查表/卡片的「临床」行按人物实际用药写并注"代XX"。

4.3 条辨框架

从讲稿中搜索条文分析案例，整理该医家的标准分析流程 → 七步条辨法或等效框架

4.4 每次补充后重新注册

ima_skill_create -d /root/.skills/{skill_name}/

（workspace 侧保持符号链接指向，勿用真实目录——见"注册"节 V4.0 修正）

中医师特化蒸馏维度

详细的15个维度定义（含1个可选维度）见：references/dimensions.md

#	维度	说明
1	核心心智模型	辨证体系（六经/八纲/卫气营血/脏腑…）
2	决策启发式	选方规则、加减规则、预后判断捷径
3	表达DNA	讲课风格、常用术语、口头禅、负面清单
4	反模式	禁治法、反对的理论、认为错误的东西
5	诚实边界	6层：已验证/需验证/不能做/扮演禁止/说错话/认可话
6	剂量思维	换算标准、常用药剂量、质疑超大剂量
7	饮食调理	病后禁忌、胃气保养、损谷则愈
8	条辨框架	分析条文的标准七步法
9	生平传承	师承、弟子、著作、评价（含来源分级）
10	方证体系	核心方剂及鉴别要点
11	内在张力	观点冲突/实践落差/立场矛盾，让角色立体化
12	智识谱系	受谁影响→影响谁→思想地图定位
13	常见问题速查	5~15个高频问题直答，免检索快速响应
14	临床安全层	误治急救/传变预警/用药铁律
15	功法/修炼/导引体系	修炼次第/火候要领/禁忌清单（适用道医/养生家/导引派，非必选维度，定义见 dimensions.md）

命名规范与目录结构

命名格式

• 技能名：kebab-case，拼音（如 huxishu、liuduozhou），≤64字符
• 严禁 ima- 前缀（平台保留前缀，违规报错）

文件名标准化规范（V4.4c 新增·强制，蒸馏产出的 skill 内部文件一律遵守）

总原则：蒸馏产出的所有文件（modules/、references/、cases/ 及根目录）文件名一律英文 kebab-case，禁止中文文件名。（文件内容可为中文——讲稿/医案/术语都是中文，仅文件名强制英文。）

统一格式：NN-english-kebab-name.md

• NN：两位数字序号（01-99），控制文件排序，同目录内唯一
• english-kebab-name：小写英文单词，连字符 - 分隔（如 01-shanghan-lun.md、26-dose-audit-workflow.md、cases/05-lung-cancer.md）
• 扩展名：蒸馏产物文档一律 .md（Markdown，含公式/表格/索引）；若产出脚本/数据文件（.py/.json/.csv 等），命名规则相同（NN-english-kebab-name.py），仅扩展名按实际类型
• 示例对照：

✅ 正确	❌ 错误	原因
modules/01-shanghan-lun.md	modules/01-伤寒论.md	中文文件名
references/02-decision-heuristics.md	references/02_Decision.md	下划线+大写
cases/03-stroke.md	cases/03 中风.md	空格
references/08-faq.md	faq.md	无序号无法排序

禁止项：中文 / 大写字母 / 空格 / 下划线作分隔符（历史遗留 01_xxx.md 保留不动，新文件一律连字符）/ 无序号。 标准保留名（不改名）：SKILL.md、README.md、CHANGELOG.md、LICENSE、.gitignore。 引用一致性：SKILL.md 索引与正文引用必须与实际文件名逐字一致（防引用死链坑）；改名后必须 grep -rn 旧名 全库更新引用。

最终目录结构（新蒸馏 + 优化已有）

	s
kills/{skill_name}/
├── SKILL.md # 核心（含公式+速查+索引+工作流）
├── cases/ # 独立案例库（优化时新增）
│ └── 01-xxx.md # 完整案例（证-机-方-效链）
├── modules/ # 原文全文
│ ├── 01-shanghan.md # 伤寒论讲稿
│ ├── 02-jingui.md # 金匮要略讲稿
│ ├── 03-yian.md # 医案集（如有）
│ └── 04-0x-xxx.md # 新增原文（优化时新增）
└── references/ # 分析性文档
 ├── 01-core-philosophy.md # 核心心智模型
 ├── 02-decision-heuristics.md # 决策启发式
 ├── 03-expression-dna.md # 表达DNA（含负面清单）
 ├── 04-antipatterns-boundaries.md # 反模式+诚实边界6层
 ├── 05-biography-legacy.md # 生平+来源分级
 ├── 06-tensions.md # 内在张力
 ├── 07-intellectual-lineage.md # 智识谱系
 ├── 08-faq.md # 常见问题速查
 ├── 09-clinical-safety.md # 临床安全层
 ├── 10-roleplay-template.md # 角色扮演4段式模板
 ├── 11-diet-wellness.md # 饮食调理（原06顺延）
 ├── 12-dosage-framework.md # 剂量框架（原07顺延）
 ├── 13-cases-guide.md # cases/ 医案库规范
 ├── 14-modules-summary.md # modules/ 摘要表规范
 ├── 15-consistency-test.md # 角色一致性自测协议
 ├── 15b-consistency-report.md # 自测报告归档
 ├── 16-distill-archive.md # 蒸馏留档规范
 ├── 17-release-guide.md # 发布物料规范
 ├── 23-gongfa-system.md # 功法/修炼/导引体系（可选，Agent 11）
 ├── 24-formula-pattern-system.md # 方证体系（Agent 2b 独立产出）
 └── 18-1x-xxx.md # 新增分析（优化时新增）

框架自身文档（本技能内部文件，不随蒸馏产出）：
 ├── phase1-agents.md # 子Agent Prompt模板
 ├── phase2-checklist.md # 注册前检查清单
 ├── phase3-quality.md # 质量验证标准
 ├── dimensions.md # 15维度定义
 ├── 18-error-handling.md # 错误处理与降级机制
 ├── 19-huangyuanyu-v3-case.md # 黄元御 V3 深度优化实战案例
 ├── 20-original-text-digitalization.md # 原文数字化与行号索引方法论
 ├── 21-acceptance-testing.md # 验收测试方法论
 ├── 22-boundary-response.md # 非主线应答模板
 ├── 25-index-audit.md # 索引完整性审计规范（V3.6）
 └── huxishu-case.md # 实战案例（胡希恕）

错误处理机制

子Agent容错

• 超时/失败 → 自动重试3次（间隔递增10s/30s/60s）
• 连续失败 → 降级到light模型或跳过该维度
• 跳过维度→记录到"已知差距清单"，后续手动补全

素材校验

• 检查文件大小（<10MB，超限提示拆分）
• 检查编码（非UTF-8自动转码；统一简体 UTF-8 零乱码零繁体为注册硬门槛，详见 S15 / references/32-encoding-hygiene.md，含 U+FFFD / HTML 实体残留 / 异写三级扫描与假阳性防护）
• 检查OCR质量（大量乱码时提示人工校验）

降级档位

• 深度档（10维+全量）→ 标准档（10维）→ 快速档（仅3维：心智+决策+DNA）→ 最小档（仅心智模型）→ 极速档（1维：仅核心心智模型，10分钟占位）

极速档详细流程：

Phase 0A 入口分流（确定学派/核心经典）
 → Phase 1 仅跑 Agent 1（heavy，提取核心心智模型）
 → Phase 2 生成迷你 SKILL.md（身份卡+核心框架+5条FAQ+安全声明）
 → Phase 3 跳过 → 直接 Phase 5 注册
预计耗时：10 分钟 | 适用场景：先注册占位，后续迭代补充

**极速档安全围栏**（V3.3 新增·防误认完整版）：
- ① **YAML description 标签**：极速档产出的 SKILL.md 必须在 description 末尾加 `[极速档·占位版]`，便于平台标记
- ② **顶部 ⚠️ 固定声明**：SKILL.md 首部必须加一段警示，标明"覆盖率 <9/15，仅含核心心智模型，缺维度动态列出"
- ③ **补全提示触发**：注册成功后强制提示用户"当前为占位版，建议通过 Pipeline B 增量补全至达标≥9/15"

回滚机制

• 修改前：cp SKILL.md SKILL.md.bak
• 回滚：cp SKILL.md.bak SKILL.md && ima_skill_create

完整错误处理文档 → references/18-error-handling.md

坑位百科（按发生阶段分组）

共 18 坑（入口与素材 4 + 调研与合成 7 + 验证与发布 6 余），合并自胡希恕实战 + 黄元御实战 + nihaixia 索引事故。 完整表格已下沉至 references/31-pitfall-encyclopedia.md（V4.5c·P1 瘦身，遵循本 skill 自家 G7 铁律：知识进 modules/references，指令留 SKILL.md）。本处仅留索引：行号引用失效、子代理漏查 modules、OCR 异写漏检、file_edit 吞标题、未注册被回滚 等为高频致命坑，优化轮次必对照核查。

---

Pipeline B：优化已有 skill 工作流

适用场景：已有skill需要利用新素材进行升级（非从零蒸馏） 实战案例：利用《四圣心源》《长沙药解》《黄元御医书十一种》优化 huang-yuanyu skill（269行→513行）

Phase B0：入口分流

优先级	来源	示例
1	原著原文	"这是《四圣心源》全文TXT" → 原文分析模式
2	知识库内容	"ima知识库里有XX的蒸馏本" → 已有资料模式
3	新上传OCR	"这是XX医书的OCR识别文件" → OCR清洗+分析模式

Phase B1：对标差距分析

加载目标skill的SKILL.md，进行10维差距分析（nihaixia 作为可选方向参考，若未安装则跳过对比，仅做 15 维度覆盖率验证即可）：

#	差距维度	检查方法	参考值（nihaixia 可选对照）
1	SKILL.md行数	wc -l skill_path	11,202行
2	诊断决策树	grep IF-THEN结构数量	8个完整IF-THEN树
3	独立案例库	ls cases/ 检查	6个cases/模块(140KB)
4	关键词索引	索引条目数量	200+条
5	角色扮演/表达DNA	身份卡+工作流协议	完整Agentic Protocol
6	问诊协议	是否有结构化问诊	诊病十问
7	内在张力	grep "张力" 数量	4组
8	智识谱系	是否含"受谁影响/影响谁"	有
9	诚实边界6层	是否含正误对照	有（✅/❌成对）
10	临床安全层	是否含误治急救/用药铁律	有

输出：差距分析清单 → 确定优先级排序（P0-P9）

Phase B2：多源素材 10 维并行调研

直接引用 Phase 1 的10维分析框架（详见 Phase 1 章节 + references/phase1-agents.md）

与 Phase 1 的差异：

• Agent 1,2,2b,6,9 → 使用 heavy 模型（深度推理任务）
• Agent 3,4,5,7,8,10 → 使用 light 模型
• Agent 11（可选）→ 仅道医/养生家启用
• SKILL.md优化时，产出文件直接更新到已有 references/ 对应位置

⚠️ 关键教训：子Agent必须指定 output_path，确保产出文件可读；research类型子Agent只读不改，需主Agent手动写入output。

Phase B3：定向增强合成

按差距优先级，将分析结果填入SKILL.md：

优先级	增强项	操作方法	预估行数
P0	扩展关键词索引	从原文提取200+条，按症状/方剂/药物/诊断/饮食5类组织（关键词选择原则：按行 grep 统计命中；<5 行不单独索引并入邻近条目；>400 行属噪音换聚焦词；用聚焦词替代泛词如"妇人"→"月经"）	+200行
P1	结构化IF-THEN诊断树	将现有公式改为IF-THEN分支结构（含证候/治法/方剂/禁忌）	+300行
P2	建立独立案例库	从医案集中提取案例→cases/01_xxx.md（证-机-方-效完整链条）	+200行
P3	补充问诊协议	提炼该医家的问诊思路→"XX诊病X问"	+100行
P4	深化角色扮演	身份卡+回答工作流（6步法）+表达DNA（句式/高频词/情绪温度）	+100行
P5	方剂/药物速查	完整方剂库+药物归经分类表+药对表	+300行

🔴 CHECKPOINT（优化轮内闸门·V4.5c 新增）：每轮 B3 改动后必须先跑一次 paired/盲测验证（按 S13 第四节），未验证不得叠加下一轮改动——否则缺陷累积将无法归因（nihaixia 实战：连续 6 轮未验证 → 11-20 题全面落败才发现）。验证判定词表仅 keep | tweak | rollback。

🔴 CHECKPOINT（规则膨胀治理·S13·L6·G6 自查）：每轮优化后扫描 SKILL.md 是否存在同一约束多处置顶/重复表述——nihaixia 曾因"表格约束"在速查卡②/14b/Step3 三处各写一遍导致维护错位与"注意行重复 bug"。原则：单一权威定义 + 其余处仅短引用（如 S2 写 G1-G3 权威定义，S11/S14 仅引用）。蒸馏器自身也须自查（S2/S13/S14/S16 都涉及"表格/字数约束"，须指向 S2 权威定义而非各写一遍）。发现重复即合并，不累积。

🔴 CHECKPOINT（敏感词预扫描·2026-08-23 李可 411006 实战新增）：B3 蒸馏产出（尤其 OCR 古籍/访谈/批注类素材）注册前必扫敏感词——李可五书补遗曾因补遗文件含「毛主席×5/早泄/阳痿/自杀」触发注册 411006 被拒。扫描清单：政治类（毛主席/红卫兵/法轮/天安门等）+ 性相关（性交/早泄/阳痿/手淫等）+ 暴力类（自杀/杀人等）。命中即温和化（"毛主席"→"国家当年"、"早泄/阳痿"→"房事之疾"、"自杀"→"轻生/自尽"），再注册。注册失败 411006 时先跑此扫描定位，勿盲目重试。

失败模式分支（if-then）：

• 若 B3 改动后验证 cur < 上次 → 触发 B3 返工，不进入 B4/B5 注册；从 results.tsv 取上次通过锚点 git revert（S13 负优化红线）。
• 若 B5 必检维度有 P0/P1 项未闭环 → 退回对应 Phase 补做，禁止带缺陷注册。
• 若 ima_skill_create 注册失败/被快照覆盖 → 启用注册三步防护（见 references/31-pitfall-encyclopedia.md C 阶段"未注册文件被回滚"坑）。

Phase B4：增量素材落盘

将新素材原文完整复制到modules/目录：

# 原文全文 → modules/
cp /path/to/original_text.md skills/{skill_name}/modules/0X_xxx.md

# 10维分析报告 → references/
mkdir -p skills/{skill_name}/references/
cp /path/to/analysis/*.md skills/{skill_name}/references/

Phase B5：质量再验证 + 注册

新旧同题盲评法（V4.5 新增·nihaixia 15 实战必做）：Pipeline B 优化已有 skill 后，必须做基线对比盲评——同题三向（旧版作答/上次新版作答/本次新版作答）交独立 judge 按 6 维评分（人物口吻强度/故事细节/调侃/跑题冗余/问诊互动/拉听众收尾），总分对比；判定标准：本次 ≥ 上次即通过，< 上次必须返工。绝对值评分（15 维覆盖）无法回答"是否真的进步"，相对基线才有答案（nihaixia"11-20 全面落败→部分修复→通过"三阶段实证）。测试题复用上次题库保证可比性；产出的三向作答存档至 outputs/。

判定机制严格化（V4.5c·S13 实战强化）：上面的"独立 judge 评分"必须按 references/30-optimization-playbook.md 第四节执行，杜绝自评偏差与软判定：① N=3 独立空白 sub-agent 评委，每人同一次 call 内同时读两版作答（paired 比较，不打绝对分）；② 奇数 N 多数决（3:0 / 2:1 → 取多数；平局补第 4 人破平）；③ 负优化红线：results.tsv 记 cur（本次）与 wor（历史最差），cur ≥ wor → keep，cur < wor → 立即 git revert 到上次通过锚点**（不累积叠加缺陷）；④ **大改后必跑 4.3 负优化核查**（抽取代表性改动逐条问"是否造成退化"，18/18 无回归实证）；⑤ 每轮 B3 改动后**必先验证再叠下一轮**（防缺陷累积无法归因）。判动词表仅限 keep | tweak | rollback`。

必检维度（黄元御实战标准）：