中医思维蒸馏器
下载地址
https://api.skillhub.cn/api/v1/download?slug=%40user_ff4d9420%2Ftcm-distiller将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ff4d9420/tcm-distiller。中医思维蒸馏器TCM-Distiller是开源中医AI蒸馏流水线,不堆砌中医典籍素材,而是搭建标准化体系,把倪海厦、胡希恕、黄元御、吴鞠通、苏华仁等医家的著作、讲稿、医案,提炼成可被AI调用、还原真人辨证思路的专属思维技能。系统采用15维度蒸馏架构拆解医者心智模型、用药逻辑、剂量习惯与诊疗边界,搭配S1-S12十二重质控模块,依靠原文溯源、剂量勘误、盲评校验、索引审计等规则,解决普通AI训练杜撰医理、辨证混乱的问题。
项目以棘轮迭代机制稳步优化还原度,仅用于中医研习与学术研究,内容不可作为临床诊疗方案,以数字化工程模式,打通传统中医与现代AI的传承通路。 TCM-Distiller is an open-source pipeline for TCM intellectual inheritance.
阅读全文 (展开查看完整说明)
概述
中医师思维蒸馏器
将任意中医师蒸馏为可被 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:新蒸馏流程
| 优先级 | 来源 | 示例 |
|---|---|---|
| 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 必须包含
- YAML frontmatter:name(kebab-case≤64字符) + description(触发词+不适用边界)
- 关键词索引:分组(六经/方剂/症状/饮食/剂量/理论),含搜索位置
⚠️ 索引引用格式铁律(V3.6 新增·nihaixia 事故教训):
- SKILL.md 检索索引的"搜索位置"一律用
文件 搜"关键词"格式(如<模块文件> 搜"关键词"),禁止在 SKILL.md 正文直写行号(详见第357-396行/L4868/约1009行)——行号在文件更新后必然错位(实测:nihaixia L4868 实际内容在 4965 行)。- 行号仅允许存在于独立 INDEX 文件(
modules/00_index.md、references/20场景的篇目导航表),且必须由脚本自动生成校验,禁止手工 hardcode。- 关键词必须真实存在于目标文件:新增/修改索引后跑
scripts/validate_keyword_refs.py验证,0 失效才能注册。- 关键词选择原则:按行 grep 统计命中数;命中 <5 行的主题不单独建索引(并入邻近条目);命中 >400 行属噪音无定位价值(改用聚焦词);用聚焦词替代泛词(如"月经"84 行 vs "妇人"6 行,选"月经")。
- 完整性三检(跨模块引用缺失/完全缺失主题/结构性遗漏)见
references/25-index-audit.md。
- 诊断公式:适配该中医师的辨证体系公式
- 方证/方剂速查:类似方鉴别表
- 角色扮演规则:
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;不启用时此段可省略。
- 内在张力:该中医师观点冲突/实践落差/立场矛盾 ≥3 组(取自 06-tensions.md,写在角色扮演规则之后,让 AI 回答时呈现两面而非和稀泥)
- 智识谱系:受谁影响→影响谁→思想地图定位(取自 07-intellectual-lineage.md)
- 常见问题速查FAQ:5~15 个高频问题直答(取自 08-faq.md,免检索快速响应)
- 临床安全层:误治急救/传变预警/用药铁律(取自 09-clinical-safety.md,写入安全要求章节)
- 调研来源表:一手/二手/本地三级分级
- 安全声明:SKILL.md 首部或角色扮演规则之后固定一段——"本技能仅供学术研究与角色演绎,不构成医疗建议,具体诊疗请咨询执业医师";若含毒性药/重剂内容,同步在临床安全层标注"严禁自行试药"
- 前置表达速查卡 + 输出形态铁律(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/诚实边界;否则可交付。
原文数字化与验收测试
若蒸馏产物收录大部头原文(医书合集/全本讲稿),必检两项:
- 原文数字化:按
references/20-original-text-digitalization.md建立行号索引体系(书目总览+关键词速查+逐篇目行号,校验 0 错误)+ OCR 噪音清理 + 维基对照校对 - 验收测试:按
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自动转码)
- 检查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 坑)
| 坑 | 现象 | 解决方法 |
|---|---|---|
| 原文素材与蒸馏本混淆 | 二手蒸馏本缺乏原文直接引用 | 优先用原著全文,蒸馏本作为参考对照 |
| OCR 文件过大 | 3.5MB 文件分析不完整 | 先定位关键章节(总目录→行号),针对性读取 |
| OCR 格式噪音 | 孤立页码/书眉页脚/LaTeX 残留/乱码/空行冗余 | 多轮清理脚本;HTML 表格与标题必须保留 |
| 古籍内容违规 411006 | 古籍敏感词触发注册拒绝 | 导入前 grep 排查,温和化替换 |
B. 调研与合成阶段(7 坑)
| 坑 | 现象 | 解决方法 |
|---|---|---|
| YAML 缺失 | 411003(frontmatter 缺失或格式错误) | 必须加 YAML frontmatter |
| 子 Agent 压缩过度 | 产出 ~50KB 被压到 12KB | 不要压缩,保留完整产出 |
| sub-agent 产出未落盘 | research 类型只读不改 | 主 Agent 必须主动 file_write |
| 无 modules/ | 缺乏原文检索能力 | 完整讲稿复制到 modules/ |
| SKILL.md 过短 | 显著低于同复杂度医家 skill 行数 | 按 15 维度覆盖率补齐 |
| SKILL.md 被追加超长 | 盲目追加超过 5000 行难维护 | 按差距优先级分批增量 |
| 引用死链 | 文件名与实际不符 | 全量体检 grep 核对 |
| 行号引用失效(V3.6 新增·nihaixia 实测) | SKILL.md 写"详见第357-396行"/"L4868",文件更新后行号错位(实测 L4868 实际内容在 4965 行) | 检索索引禁写行号,一律 文件 搜"关键词";行号只留在独立 INDEX 文件且由脚本校验 |
| 子代理漏查部分 modules(V4.4b 新增·nihaixia 实测) | 核查子代理只查了部分模块就判"未收录"(桂枝加龙骨牡蛎汤实际在 modules/05:759 有完整 7 味+临床口述,子代理仅查 modules/07 的"汤意"一句误报未收录) | 子代理任务书必须写明"遍历全部 modules/*.md";主代理对"未收录/缺失"结论必须 grep 全库复核后再采信 |
| OCR 异写漏检(V4.4b 新增·nihaixia 实测) | 预筛脚本精确匹配漏掉异写:黄耆=黄芪、橘枳生姜=橘枳姜、䗪虫=蛰虫、连轺=连翘、苓桂术甘=茯苓桂枝白术甘草 | 预筛 MISSING 名单必须二次异写复查(同义词/近形字/简繁/省字),确认真缺才标未收录 |
| 中文文件名(V4.4c 新增·规范强制) | 产出文件用中文/下划线/大写/空格命名(01-伤寒论.md、01_xxx.md),脚本路径处理与跨平台兼容出问题,且与 kebab-case 规范不一致 | 文件名一律 NN-english-kebab-name.ext(英文小写+连字符),中文只允许出现在文件内容里;SKILL.md 索引引用与实际文件名逐字一致 |
C. 验证与发布阶段(6 坑)
| 坑 | 现象 | 解决方法 |
|---|---|---|
| 缺乏对标基准 | 不知道优化到什么程度够 | 使用 15 维度覆盖率(达标≥9/15,优秀≥12/15,标杆≥14/15);nihaixia 仅作方向参考(已非唯一基准) |
| 古今病名不互通 | "糖尿病"提问 AI 不知道"消渴" | 构建现代→古代病名映射 |
| AI 回答无原文风味 | 回答用现代语言而非该医家口吻 | 强制原文引用+三段式模板 |
| 缺饮食 | 完整度下降 | Phase 4 补充(剂量已由 Agent 10 前置) |
| 每次改完不重注 | 用户拿到旧版 | 改完立即 ima_skill_create |
| 未注册文件被回滚(血泪) | 本地文件全部丢失(含 CHANGELOG 同日多版本漏记:nihaixia 15 实测 v15c 记录消失) | 注册三步防护(V4.5 升级):①注册前把完整目录 zip 备份到 /sandbox/workspace/(唯一持久位置)②注册后立即 grep 关键改动点验证未被平台快照覆盖③被覆盖则从备份恢复重放;CHANGELOG 每次注册前检查当日条目是否已记录(含同日多次修改) |
| file_edit 吞标题(V4.4b 新增·nihaixia 实测) | old_string 含"## 三、XX"标题行时,替换后该标题被连带删除,文件章节编号错乱 | 替换锚点避开标题行本身(用行尾文本作锚);编辑后 grep 章节标题清单验证无丢失 |
| CHANGELOG 同日多次修改不同步(V4.4b 新增·nihaixia 实测) | 同一天早上/下午多次大改,CHANGELOG 只记了早上的条目,下午改动全部漏记 | 每次注册前检查 CHANGELOG 是否已记录本次改动;同日多次修改合并为"vX.Yb 当日补记"或分条目 |
Pipeline B:优化已有 skill 工作流
适用场景:已有skill需要利用新素材进行升级(非从零蒸馏)
实战案例:利用《四圣心源》《长沙药解》《黄元御医书十一种》优化
huang-yuanyuskill(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行 |
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/。
必检维度(黄元御实战标准):
| 检查项 | 通过标准 |
|---|---|
| SKILL.md 行数 | ≥ 原始行数 × 2(或 200-400 行) |
| 新增原文模块 | ≥ 1个完整原文 |
| 案例库 | ≥ 5则完整医案(证-机-方-效) |
| 诊断公式 | ≥ 10个结构化公式 |
| 方剂速查 | ≥ 30首方剂 |
| 索引健康检查(V3.6) | python3 scripts/validate_keyword_refs.py --skill SKILL.md 失效=0 + 无行号残留 + 完整性三检通过 |
| 差距项闭环 | P0-P2项100%完成,P3-P5项≥70% |
| 注册成功 | ima_skill_create 返回 status=1(success) |
注册
ima_skill_create -d "/root/.skills/{skill_name}/"共享模块 S1:古今病名映射索引(原 Phase 6.6)
问题:现代人用"糖尿病""痛风""冠心病"提问,但古代医籍中只有"消渴""历节""胸痹"。如果不建立映射,AI无法将现代病名关联到古代辨证体系。
构建步骤
Step 1:提取古代病名全表从原著中按章节提取所有古代病证名称:
grep -n "根原|解|病|证" modules/*.md | grep -E "根原$|解$" | sortStep 2:按现代医学分类映射按13个现代医学分类组织映射表:
| 分类 | 条目数 | 示例 |
|---|---|---|
| 代谢/内分泌 | ~6 | 糖尿病→消渴,痛风→历节 |
| 心脑血管 | ~8 | 冠心病→胸痹,脑梗→中风 |
| 呼吸 | ~11 | 哮喘→齁喘,肺炎→肺痈 |
| 消化 | ~20 | 肝硬化→鼓胀,胃炎→脾胃病 |
| 泌尿生殖 | ~8 | 结石→淋沥,前列腺炎→白浊 |
| 妇科 | ~12 | 肌瘤→癥瘕,痛经→经行腹痛 |
| 风湿免疫 | ~11 | 类风湿→历节,红斑狼疮→阴阳毒 |
| 神经精神 | ~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文件众多,需全量体检确保引用连通、维度完整。
检查项:
- 死链检查(正向):
grep -roh "modules/...|references/...|cases/..."提取全部引用路径 → 逐一核对文件存在 - 章节连通:知识链路索引(如37)引用的modules章节号 vs 实际章节(
grep "^## 7." modules/07) - 维度覆盖:对标V2.2标准(公式≥10/决策树8/关键词200+/张力≥4/FAQ/安全层/医案≥5/映射100+)
- 小文件甄别:7-12行文件可能是精炼分析报告(非占位符),人工判断后保留
- 修复即注册:发现死链等立即修复+注册持久化
- 关键词引用验证(V3.6 新增):
python3 scripts/validate_keyword_refs.py --skill SKILL.md,失效引用立即修复 - 完整性三检(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质量验证中增加检查项:
| 检查项 | 标准 |
|---|---|
| 古今病名映射表 | ≥ 100条现代病名对应 |
| 强制原文引用规则 | 角色扮演中有明确铁律 |
| 原文金句速查 | ≥ 20条经典语录 |
| 回答格式模板 | 有三段式结构定义 |
| ✅/❌ 示范 | 有正误对比示例 |
参考文件清单
| 文件 | 用途 | 读取时机 / 依赖 | 优先级 |
|---|---|---|---|
| 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。