中医师思维蒸馏器

> 将任意中医师蒸馏为可被 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
• 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：新蒸馏流程

0B：优化已有skill流程

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

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

Phase 1：10 维并行调研

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

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

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

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

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

> 维度 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）：

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

路由规则扩展：跨角色路由（V3.3 新增·可选·多 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 检索覆盖内容：

生成时机：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 行做百分制误导——那是"内嵌原文"特例）：

> 必含维度（共 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

命名规范与目录结构

命名格式

• 技能名：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），仅扩展名按实际类型
- 示例对照：

禁止项：中文 / 大写字母 / 空格 / 下划线作分隔符（历史遗留 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自动转码）
• 检查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

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

> 合并自胡希恕实战+ 黄元御实战 + nihaixia 索引事故，共 18 坑。

A. 入口与素材阶段（4 坑）

B. 调研与合成阶段（7 坑）

C. 验证与发布阶段（6 坑）

Pipeline B：优化已有 skill 工作流

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

Phase B0：入口分流

Phase B1：对标差距分析

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

输出：差距分析清单 → 确定优先级排序（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：

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/。

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

注册

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

共享模块 S1：古今病名映射索引（原 Phase 6.6）

> 问题：现代人用"糖尿病""痛风""冠心病"提问，但古代医籍中只有"消渴""历节""胸痹"。如果不建立映射，AI无法将现代病名关联到古代辨证体系。

构建步骤

Step 1：提取古代病名全表
从原著中按章节提取所有古代病证名称：

grep -n "根原\|解\|病\|证" modules/*.md | grep -E "根原$|解$" | sort

Step 2：按现代医学分类映射
按13个现代医学分类组织映射表：

Step 3：写入SKILL.md关键词索引
在SKILL.md的关键词索引中增加：

| 现代病名 | references/modern-disease-mapping.md |

Step 4：建立快速查表
在SKILL.md中增加15~20条最常见现代病的古代对应病名和核心方剂快速查表。

共享模块 S2：强制原文引用与回答协议（原 Phase 6.7）

共享模块 S3：热度驱动测试训练法（原 Phase 6.8）

> 问题：优化后的skill如何验证质量并持续训练？用"结合互联网热度的100题测试"闭环。

触发：用户要求"结合互联网热度生成问题测试/训练skill"。

流程：

Step 1：热度调研
 search(web) 当前热门中医话题（实测2026：三伏晒背/冰饮人生观/支沟穴/乌梅汤/中医科学争议等）
 → 每类话题命中1-2条实证新闻/爆款梗

Step 2：生成100题题库（10类×10题）
 分类设计 = 热度话题类（6类：时令养生/网红评议/常见病/脾胃饮食/女性健康/情志压力）
 + 争议类（1类：科学质疑）
 + skill核心验证类（3类：三书同源/核心辨证/经典方剂）
 每题标注覆盖度：覆盖（skill可直接答）/部分（可检索作答）/缺口（无知识）

Step 3：全量实答（子Agent并行）
 5个子Agent并行（各20题），每个：
 - 读取题库对应题号 + skill知识库路径
 - 以角色口吻作答，硬性要求：每题≥1段原文引用（grep验证禁编造）+学习研究声明+诚实边界
 - 输出到 outputs/100answers/0X-YY.md

Step 4：覆盖度评估
 统计 覆盖/部分/缺口 → 识别薄弱维度 → 实答质量评分（原文准确性/角色一致性/知识正确性/安全边界/热度贴合）

Step 5：P0-P3增量训练（按优先级）
 P0 补现代病名映射（缺口题→覆盖）
 P1 补FAQ（部分题→直接覆盖）
 P2 补争议回应模板（话术层，如五步骨架）
 P3 补诚实边界声明（防答非所问，如"穴位非吾主线"）

实测结果（黄元御V3）：覆盖率98%→100%，实答评分9.4/10，P0-P3后缺口清零。

Step 6：回归验证（V3.3 新增·MiMo 建议·防 P0-P3 引入新错误）
- P0-P3 增量训练完成后必须重跑 Step 3-4（全量实答 + 覆盖度评估）
- 通过标准：新增内容准确率 ≥ 原 skill 准确率（黄元御基线 9.4/10）
- 未通过：回滚定位重做该 P 项（用 21-acceptance-testing.md 的棘轮审计方法）

子Agent实答任务模板要点：
- 角色背景（身份+口吻+立场）写清楚
- 题库文件路径+知识库文件清单（含关键词检索提示）
- 输出文件路径+格式模板
- 硬性要求：原文引用禁编造/学习研究声明/诚实边界/每题字数

共享模块 S4：知识网络体检（原 Phase 6.9）

> 问题：多次迭代后skill文件众多，需全量体检确保引用连通、维度完整。

检查项：
1. 死链检查（正向）：grep -roh "modules/...|references/...|cases/..." 提取全部引用路径 → 逐一核对文件存在
2. 章节连通：知识链路索引（如37）引用的modules章节号 vs 实际章节（grep "^## 7\." modules/07）
3. 维度覆盖：对标V2.2标准（公式≥10/决策树8/关键词200+/张力≥4/FAQ/安全层/医案≥5/映射100+）
4. 小文件甄别：7-12行文件可能是精炼分析报告（非占位符），人工判断后保留
5. 修复即注册：发现死链等立即修复+注册持久化
6. 关键词引用验证（V3.6 新增）：python3 scripts/validate_keyword_refs.py --skill SKILL.md，失效引用立即修复
7. 完整性三检（V3.6 新增·反向审计，详见 references/25-index-audit.md）：
- ① 跨模块引用缺失：主题应指向的模块清单 vs 索引实际引用 → 检出"内容存在但未索引"
- ② 完全缺失主题：主题清单 vs 索引表反向比对 → 检出"有实质内容但无条目"
- ③ 结构性遗漏：ls 实际文件 vs 索引表反向比对 → 检出"文件未入索引表"（死链检查查不出此方向）

> 问题：优化后的skill虽然内容充实，但AI回答时仍用现代语言"讲张仲景"而非"作为张仲景"在说话。缺少强制性的原文引用规则。

构建步骤

Step 1：在角色扮演规则中增加强制原文引用铁律

在SKILL.md的角色扮演规则中写入：

### ⚠️ 核心铁律：回答必须引用原文

1. 必引原文开篇 → 回答第一段必须引用该医家的原著原文
2. 必用三段式结构 → 原文引用 → 病机分析 → 出方用药
3. 至少引用1段原文 → 用 > 格式，标注出处
4. 用该医家语气说话 → 多用该医家的典型句式和高频词

并附 ✅/❌ 正误对比示范：

❌ 错误示范（无原文引用）：
"牙痛是胃火导致的，可以用清胃火的药治疗……"

✅ 正确示范（原文开篇）：
"牙痛者，足阳明之病也。手阳明之经……浊则下降，清则上升，手阳明升，足阳明降，浊气不至上壅，是以不痛。"
牙疼一证，根在中焦土湿，胃气不降，浊气壅迫……

Step 2：构建常用原文金句速查表

从原著中按场景提取20~30条经典语录，分类组织：

分类建议：
- 中气总纲（每答必备用）
- 诊断心法（辨证时用）
- 治法箴言（出方时用）
- 批判警示（论禁忌时用）

Step 3：定义回答格式模板（三段式）

第一段：原文开篇（必做）
> 引用原著对应卷次原文，标注出处

第二段：病机分析（用该医家的特有思维框架）
用其典型的因果链句式解释病机

第三段：出方用药（含加减+禁忌）
- 先出主方（标出处和组成）
- 再讲加减（按辨证）
- 最后禁治之法

Step 4：更新质量验证清单
在Phase 3质量验证中增加检查项：

参考文件清单

| 文件 | 用途 | 读取时机 / 依赖 | 优先级 |
|------|------|:------:|
| references/phase1-agents.md | 10+2 维子 Agent Prompt 模板（含变量占位符） | 时机：Phase 1 启动前；前置：无；产出：references/01-09, 12, 23, 24 analysis files | 必读 |
| references/phase2-checklist.md | 框架合成注册前检查清单 | 时机：Phase 2 合成后；前置：Phase 1 产出；产出：注册前自检 | 必读 |
| references/phase3-quality.md | 质量验证标准（15 维度覆盖率） | 时机：Phase 3 与 B5；前置：Phase 2 产出；产出：通过/不通过结论 | 必读 |
| references/dimensions.md | 15 个蒸馏维度的深化定义（14 标准 + 1 可选） | 时机：Phase 0/1/4 查阅；前置：无；产出：维度产出对应文件 | 参考 |
| references/huxishu-case.md | 胡希恕 38 万字讲稿蒸馏实战案例 | 时机：Phase 1/4 参考范式；前置：无；产出：方法论参考 | 参考 |
| references/19-huangyuanyu-v3-case.md | 黄元御 V3 深度优化实战案例 | 时机：Phase B5/S3/S4 参考；前置：无；产出：方法论参考 | 必读 |
| references/18-error-handling.md | 系统性错误处理与降级机制 | 时机：出错时查阅；前置：无；产出：降级方案选择 | 参考 |
| references/10-roleplay-template.md | 角色扮演 7 段式标准模板 | 时机：Phase 2 合成 SKILL.md 时；前置：维度 3 DNA；产出：角色规则段 | 必读 |
| references/13-cases-guide.md | cases/ 医案库构建规范 | 时机：Phase 2 cases/ 构建；前置：维度 2 决策启发式；产出：cases/00_index + 分类文件 | 参考 |
| references/14-modules-summary.md | modules/ 内容摘要表规范 | 时机：Phase 2 modules/ 整理；前置：原文模块；产出：摘要表文件 | 参考 |
| references/15-consistency-test.md | 角色一致性自测协议 | 时机：Phase 3 注册前；前置：SKILL.md 初稿；产出：自测报告（15b） | 参考 |
| references/16-distill-archive.md | 蒸馏过程留档规范 | 时机：Phase 5 交付前；前置：全部产出；产出：_distill_log + 来源分级 | 参考 |
| references/17-release-guide.md | 发布物料规范（含免责声明） | 时机：Phase 5 交付；前置：SKILL.md + modules；产出：README + 免责声明 | 参考 |
| references/20-original-text-digitalization.md | 原文数字化与行号索引方法论 | 时机：收录大部头原文时；前置：原文 TXT；产出：行号索引 + 关键词速查 | 按需 |
| references/21-acceptance-testing.md | 验收测试方法论（50 题热度实测） | 时机：S3；前置：SKILL.md + modules；产出：覆盖率报告 | 按需 |
| references/22-boundary-response.md | 非主线应答模板（角色化开场 + 安全收尾三段式） | 时机：Phase 2 角色规则；前置：维度 11 张力；产出：边界应答段落 | 按需 |
| references/23-gongfa-system.md | 功法/修炼/导引体系产出规范（维度 15，可选） | 时机：人物为道医/养生家时（Agent 11）；前置：维度 15 启用；产出：references/23 文件 | 按需 |
| references/24-formula-pattern-system.md | 方证体系产出规范（维度 10，Agent 2b 独立产出） | 时机：Phase 1 Agent 2b 运行时；前置：源素材；产出：核心方剂+类似方鉴别 | 必读 |
| references/25-index-audit.md | 索引完整性审计规范（三类反向审计+关键词选择原则+验证脚本用法） | 时机：Phase 2 索引构建 / Phase 3 健康检查 / S4 体检；前置：SKILL.md 关键词索引；产出：失效修复清单 | 必读 |
| references/26-dose-audit-workflow.md | 剂量勘误工作流（S7/S8/S9）：五步流程+问题类型定义+二次检测+分级修复+版本差异规范+三体系换算 | 时机：Phase 4 或 Pipeline B（方剂型 skill 必做）；前置：源文件+方剂清单；产出：勘误表+汇总报告+修复 | 必读（方剂型） |
| references/27-honesty-standards.md | 诚实标注规范（S10）：五类必标场景+检索防错+子 Agent 复核纪律+注册防回滚 | 时机：全流程；前置：无；产出：质量保障基线 | 必读 |
| references/28-expression-verification.md | 表达还原度验证与修复（S11）：20 题长答盲评法+六维质地差距检查表+修复 7 技法+坑位 | 时机：Phase 3 验证 / Pipeline B（人物型 skill 必做）；前置：SKILL.md 初稿；产出：还原度修复清单 | 必读（人物型） |
| references/29-archive-maintenance.md | 档案清理与索引健康维护（S12）：权威vs档案分级+档案体检五步+删除后索引健康四步法+坑位 | 时机：Pipeline B / skill 长期维护；前置：目录文件清单；产出：清理清单+索引检查报告 | 必读（维护期） |

版本变更历史：详见 CHANGELOG.md。