# TCM.Skill
**Repository Path**: MitchellSorin/TCM.Skill
## Basic Information
- **Project Name**: TCM.Skill
- **Description**: 中医skill
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-12
- **Last Updated**: 2026-07-12
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# 中医 Skill
> **v3.0** · 第三个大版本(**终版**) · 2026-07-07
> 一个**家庭中医参谋** Skill:不只是查得到(结构化教材库+经典温病医家三层典籍、查表而非凭记忆),更是用得上——问诊式分析、病种直达、按穴与艾灸指导、经典溯源、医家方论、处方解读与安全复核、就医准备、分级调理建议。
## 这是什么
**十六部著作逐字通读**后整编的知识库型 Skill,三层知识结构:
- **教材层**(骨架):《中医基础理论》《中医诊断学》《中药学》(七版)《方剂学》(七版)《中医内科学》(七版)《针灸学》(现行本)六部规划教材;
- **经典层**(溯源):《素问》《灵枢》《难经》《伤寒论》《金匮要略》五部经典;
- **温病与医家层**(纵深):叶天士《温热论》、薛生白《湿热病篇》、吴鞠通《温病条辨》三部温病书,程国彭《医学心悟》、张锡纯《医学衷中参西录》两部医家专著。
核心设计:
- **SKILL.md 只放工作流程与索引**(问题分流、辨证七步骤、涉药四关、选方路径),事实细节全部在 `references/`(50 个文件)按需加载(渐进披露);
- **理论→诊断→病种→中药→方剂→针灸→经典溯源→医家方论→温病条文链条完整**:从症状分析证型或直达病种、由证型立治法、按治法给候选药群与成方比选,同一辨证下药物与按穴/艾灸两条干预线并行,全程有出处;**教材为用、古籍为源**——现代结论可回溯到经典与医家原文,古籍条文不改变现代用药与安全结论,显著分歧在条目内并陈两说;
- **安全表是硬约束**:十八反十九畏、妊娠禁忌分级、101 味毒性药剂量上限、马兜铃酸警示、含毒成方用法边界,凡涉具体药物与成方必先过表;非药物手段另有 A/A⁻/B 安全分级(**针刺等有创外治绝对禁自行**);古籍剂量配伍毒性内容一律不进用药通道;
- **定位是"参谋"而非"医师"**:如实声明 AI 身份,不扮演执业医师;所有建议按 A(可直接执行:起居/忌口/药食两用食疗/煎服操作/按穴按摩热熨;艾灸悬灸与耳穴压豆为 A⁻ 亚级——必须连同要领禁忌一起给)、B(须医师把关:一切药物与成方;有创外治只解释指路)、C(立即就医)分级明示,身体不适类回答一律以"现在能做什么"收尾。
## 能做什么
- 讲解中医核心概念(阴阳五行、脏象、气血津液、经络、病因病机、治则治法),注明教材出处
- 解读舌象、脉象(28 脉)与症状含义;按八纲/脏腑/气血津液/六经/卫气营血/三焦辨证,走"证候诊断七步骤"输出证型+病机+治法方向
- **病种直达**:感冒、咳嗽、哮喘、心悸、胸痹、不寐、胃痛、泄泻、便秘、头痛、眩晕、水肿、淋证、消渴、痹证、腰痛等《中医内科学》50 余病种——定义、鉴别(含与危重病鉴别)、分证论治表、**危重指征**、调护,主诉对得上病名时不必绕证型直接查
- 查询 470 余味中药的性味归经、功效应用、用法用量与禁忌;校验配伍安全(十八反/十九畏)、妊娠用药与毒性药剂量;按 103 种病证反查候选药群
- 查询约 340 首教材方剂(180 正方+160 附方)的组成用量、功用主治、君臣佐使方义、加减变化与使用禁忌;由证型经 `00` 总索引直达代表方并做类方比选
- **穴位与家庭外治**:查十四经 361 穴与常用奇穴的定位(教骨度分寸/同身寸取穴法)、主治与注意;按 27 病证给配穴,转为**按穴按摩(A 级)与艾条悬灸(A⁻ 级,连同禁忌要领)**;灸法、按摩十法、热熨熏洗敷贴、耳穴压豆的完整要领;孕妇禁按清单与眼区/颈前动脉区等按压红线随建议给出;**针刺、拔罐等有创外治只解释原理与风险,绝不指导自行操作**
- **资源受限适配**(海外等买药不便场景):按你声明的可得资源(可购药材/同名中成药/仅食材)在集合内比选替代方案;教材成方与市售**同名**中成药可做指认(仍须核对成分说明书);药物通道走不通时以按穴/艾灸+食疗+起居组成可执行方案
- 解答煎服法(先煎后下包煎等)、炮制、剂型与服药宜忌;养生与体质调养咨询(含足三里/关元等保健灸)
- **问诊式分析**:描述身体不适后,按十问歌多轮追问关键鉴别项(教你自看舌象),再辨证并给分级建议
- **处方解读与安全复核**:把医师开的方子逐药讲明白,并做配伍(十八反十九畏逐对排查)、人群禁忌、毒性药剂量三重核对——只解读、只核对,发现疑点表述为"建议与开方医师确认",不评判处方对错
- **就医沟通单**:就诊前把主诉、病程、刻下症、舌象、既往用药整理成中医师能直接使用的陈述
- **经典溯源**:《素问》《灵枢》《难经》《伤寒论》《金匮要略》五书全本通读整理——病机十九条、六经提纲与主要方证条文、金匮杂病与妇人三篇提纲、治则养生名句、经典禁例与死证红线,回答"经典怎么说/出自哪一篇"并给原文引用
- **温病条文**:温病三书全本通读整理——卫气营血四层治法总纲("在卫汗之可也…")与三焦治则("治上焦如羽…")原文、温病舌诊六系与验齿辨斑疹细则、银翘散白虎汤清营汤等温病名方的原书方证煎服法、**白虎四禁/湿温三禁/斑疹二禁**等诸禁例、下之不通五方、复脉三甲定风珠层级
- **医家方论**:《医学心悟》医门八法原论与止嗽散、启膈散等名方原书出处;《医学衷中参西录》教材名方原书全论(镇肝熄风汤、升陷汤、固冲汤、玉液汤、活络效灵丹等)、大气下陷与脑充血学说(五类先兆、建瓴汤、**补阳还五汤误用之戒**)、生石膏/山萸肉/生赭石等药物经验与"药贵生用"总纲——古方剂量一律只作文献记载,不作用药依据
- **非致命急症应急支持**:急性吐泻、扭伤、落枕、痛经发作、轻烫伤等排不上正规医疗时,给"等待期支持"——先排红线征象(优先取用病种文件现成的"危重指征"栏),再给基础照护常识+中医 A 级措施(含应急按穴:落枕穴、腰痛点、承山、内关等),**必附**升级指征(什么变化立即去急诊)与就医时限;疑似致命征象一律立即急救,不给应急替代
- **原文检索与临时研读**:内嵌 42 部原书全文(素问/灵枢/伤寒论/金匮/温病条辨/濒湖脉学/本草纲目/医宗金鉴/医学衷中参西录/中医内科学七版/中医养生学/中医饮食营养学等)。要原话给原话、要出处查出处;遇到整理库未覆盖而原书有载的问题,会**像医生翻书一样现场研读相关篇章、学会再运用**(读篇章而非摘孤句、与教材交叉印证、明确声明"临时研读"的可靠度状态);原文中的剂量配伍**永不作为用药依据**(仍以 references+安全表为准)
## 不能做什么(边界)
- **不是诊断工具,不开处方**:输出止于"证型+治法方向+候选药群/成方比选",具体用药必须由执业中医师面诊确定
- **疑似致命征象与疑似药物中毒一律指向立即急救**,不提供家庭解毒方案;非致命急症的应急支持仅限"等待就医期间",不构成不就医的理由
- **针刺绝对禁自行**:穴位条目所附刺灸法仅供理解与就医参考,本 Skill 不教针刺操作;艾灸、耳穴压豆等 A⁻ 级手段必须连同禁忌一起给,不做"裸建议"
- 终版**明确不含**:经典与温病书的逐条注家考据与版本校勘(收要义与主要条文,非逐条全录;运气七篇、刺法篇章、金匮食忌、痘证诸论等存目)、脉学专著深化、《药典》法定剂量(现有剂量为七版教材值,古方原量仅为文献记载,均未经药典校准)、教材外的时方验方与中成药品种(同名中成药只做指认)、针刺操作教学与推拿专业整复手法、刮痧与功法要领(仅有安全分级)、五运六气(仅存目)、外妇儿专科病(涉及处仅作鉴别与指路)——涉及时会明确告知超出收录范围,而非凭记忆作答;其中有原书在库者可走临时研读接口现场翻书
- 《医学衷中参西录》所引西医学说与中西药并用方案为 **1920 年代水平,永不作现代医学依据、一律不可仿行**;书中硫黄铅汞马钱子内服诸方及狂犬伤、霍乱、鼠疫等法定传染病治法全部存目,处置一律以现代医学为准
- 现代疾病(高血压、糖尿病等)不做"病名→药"直译,先转中医病证再辨证,且不建议自行停用西药
## 文件结构
```
skill-中医/
├── SKILL.md # 工作流程与索引(分流表/辨证七步骤/涉药四关/选方路径/安全边界)
├── README.md # 本文件
├── CHANGELOG.md # 版本沿革(含每轮通读与自查记录)
├── references/
│ ├── 00-证型直达选方总索引.md # 证型→治法→药群→代表方四级路由+病种/针灸/经典/医家/温病直达索引(跨书衔接层)
│ ├── 01~08 # 《中医基础理论》:哲学基础/脏象/脏腑关系/精气血津液/病因/病机/治则/经络体质
│ ├── 09~14 # 《中医诊断学》:望闻问切(舌诊/28脉)/八纲/病因气血津液/脏腑/六经卫气营血三焦辨证
│ ├── 15~23 # 《中药学》七版:总论药性理论+八个各论文件(470余味)+103病证用药反查索引
│ ├── 24~30 # 《方剂学》七版:总论(八法/君臣佐使/古方药量换算)+六个分章文件(每章末有"场景→首选方"速查表)
│ ├── 31~37 # 《中医内科学》七版:七大系统 50 余病种(定义/鉴别/分证论治表/危重指征/调护)
│ ├── 38~41 # 《针灸学》:经络腧穴总论与定位法/十四经361穴与奇穴逐穴表/灸法按摩外治与非药物分级/27病证配穴
│ ├── 42~45 # 经典五书:素问要义(病机十九条全录)/灵枢难经要义/伤寒论六经方证条文/金匮杂病方证与妇人三篇
│ ├── 46 # 《医学心悟》:医门八法原论/类伤寒十六辨/杂病分型口诀/教材名方原书出处/妇人门提纲
│ ├── 47 # 温病三书:卫气营血与三焦原书方证/温病舌诊验齿/名方煎服法与诸禁例/产难儿难提纲
│ ├── 48 # 《医学衷中参西录》:教材名方原书全论/大气下陷与脑充血学说/张氏药物经验/存目红线
│ └── 安全-配伍妊娠禁忌与毒性药.md # ⚠ 硬约束:十八反十九畏/妊娠分级/毒性药101味剂量表/马兜铃酸警示/方剂级安全警示/忌口
└── sources/ # 42 部原书全文(28MB),按需 grep 检索/研读;整理状态见 _目录与状态.md
```
## 工作机制
1. **分流**:SKILL.md 按问题类型路由——概念解释直答;身体不适主诉对得上病种时先进 31~37 病种节,否则走辨证七步骤;涉药问题过"性能→配伍→人群→剂量炮制"四关;选方先查 `00` 总索引再入对应方剂文件核对类方鉴别;穴位/艾灸咨询走 38~41 并过非药物分级;经典条文、医家方论与温病条文走 `00` 第六~九节→42~48(需逐字全文再进原文库核对)。**references 每个文件都有明确的路由入口**(SKILL 索引表+分流表+`00` 九节直达),不存在"不点名就用不到"的孤文件。
2. **互链**:中药文件↔方剂文件双向指引;病种分证表回指方剂文件;针灸病证配穴与病种危重指征互指;经典/医家/温病文件与理论、诊断、中药、方剂、病种各层双向互链(如素问病证篇↔内科病种、伤寒死证条文↔危重指征、镇肝熄风汤↔原书全论、药物条目附"张锡纯:"经验注);诊断文件直指 `00`;全库统一以 `[[安全-配伍妊娠禁忌与毒性药]]` 挂钩安全表。
3. **引用规范**:引用经典与医家注篇名出处、区分教材转述与原典原文;剂量一律注明"七版教材参考值,未经《药典》校准";特殊服法(桂枝汤啜粥温覆、十枣汤平旦枣汤送服、银翘散"香气大出即取服勿过煎"等)原样传达——服法是方义的一部分。
## 安装
```bash
# 全局启用
cp -r skill-中医 ~/.claude/skills/中医
# 或仅当前项目
cp -r skill-中医 <项目>/.claude/skills/中医
```
## 数据源与质量说明
- 十六部著作均为**逐字通读后提炼**,每本完成后做过条目级机械自查(中药逐味、方剂逐首、病种逐节、腧穴逐经、古籍按篇章方论对照原书清点),自查记录见 CHANGELOG;
- 《中医内科学》七版文本缺《痢疾》《便秘》两节,据五/六版系教材补编并逐条注明出处;源文本的 OCR 错字经与库内互证交叉核对后订正收录,订正清单见 CHANGELOG;
- **古籍校勘披露**:经典五书与温病医家诸书底本为网络通行电子文本,生僻字占位码、HTML 标签残留与个别讹字均已按通行本核读订正,存疑处在文件内注明;古籍与教材表述冲突时**以教材为用、古籍为源**,显著分歧在条目内并陈(如水蛭生用与药典炮制、柴胡与青蒿截疟、温病六经与三焦分治之争);
- **同名异方警示机制**:通读中发现的同名异方(清中汤、蠲痹汤、半夏白术天麻汤、宣痹汤、青蒿鳖甲汤等)已建清单,引用时注明出处书与篇名;
- 教材原文中仅提及方名而未展开的方剂,在库内标"※锚点",不虚构条目;
- 剂量、炮制均为七版教材所载,**未经《中华人民共和国药典》现行版校准**——这是终版最重要的已知局限:凡涉毒性药剂量,回答时一律附此声明。
## 来时路(版本史)
知识库按"逐字通读→提炼落盘→机械自查→反哺互链"推进,三轮读了十六部书,发过三个大版本:
| 里程碑 | 通读整理的著作 | 该版带来的变化 |
|---|---|---|
| **v0.1~v0.4**
教材整理期 | 《中医基础理论》→《中医诊断学》→《中药学》(七版)→《方剂学》(七版) | 库的主体骨架:理论与诊断层、470 余味中药、约 340 首方剂;**安全表**建成;轮末大整理产出《证型直达选方总索引》,打通诊断↔选方 |
| **v1.0** 🚩
第一个大版本 | (整备发布,无新书) | 定稿为可独立使用的 Skill:能力边界与"指路"规则、README 与安装说明 |
| **v1.1~v1.3**
实用化升级 | (功能升级;原文库入库 42 部原书全文) | 定位从"知识库"升级为**家庭中医参谋**:A/B/C 建议分级、问诊式分析、处方解读与安全复核、就医沟通单;**应急处置流程**;**原文检索与临时研读接口** |
| **v1.4**
病种层 | 《中医内科学》(七版) | 50 余内科病种直达:定义/鉴别/分证论治表/**危重指征**/调护 |
| **v1.5** 🚩
发布版 | 《针灸学》(现行教材) | 针灸层:361 经穴+奇穴逐穴表、27 病证配穴;**非药物手段安全分级 A/A⁻/B**;**资源受限适配(核心版)**上线 |
| **v2.0** 🚩
第二个大版本 | 《素问》《灵枢》《难经》《伤寒论》《金匮要略》 | **经典层**:病机十九条全录、六经提纲与主要方证条文、金匮杂病与妇人三篇、经典禁例与死证红线;**经典反哺**全库;古籍内容分流规则定档 |
| **v2.1**
医家经验层 | 《医学心悟》 | 医门八法原论、类伤寒十六辨、九种心痛等分型口诀、止嗽散/启膈散等教材名方原书出处;同名异方警示机制建立 |
| **v2.2**
温病条文层 | 《温热论》《湿热病篇》《温病条辨》 | 卫气营血/三焦原书方证全程、温病舌诊验齿细则、白虎四禁/湿温三禁等诸禁例、稚阴稚阳说原始出处;`14` 辨证纲领升级"原书细则" |
| **v2.3**
近代医家层 | 《医学衷中参西录》(约 53 万字,全项目最大单书) | 教材名方(镇肝熄风/升陷/固冲/玉液/活络效灵丹等)原书全论、大气下陷与脑充血学说(五先兆/建瓴汤/**补阳还五汤误用之戒**)、张氏药物经验与"药贵生用"总纲、白虎加人参代换定例;16 个文件获"张锡纯"经验注反哺;1920 年代西说警示与存目红线机制 |
| **v3.0** 🚩
**第三个大版本(终版,本版)** | (收束整备,无新书) | 全库终检(50 文件零坏链、零孤文件、路由零未点名);版本定级与边界措辞收束(不再排期);README 重写为"来时路+未来展望" |
## 未来展望(留给后来者的迭代指南)
本 Skill 到 v3.0 收束。原三轮路线图尚余四步未走完——书都在 `sources/` 原文库里,方法都已定型,后来者(人或 AI)可以从任何一步接着做。以下是推荐的续作路线与做法。
### 续作路线(承接原规划,按序推进;每完成一步发一个小版本)
| 序 | 著作 | 预期增强 | 续作提示 |
|---|---|---|---|
| 1(原第 4 步) | 《医林改错》《脾胃论》《傅青主女科》 | 五逐瘀方系与补阳还五原书、脾胃学说(补中益气汤源头)、完带汤/易黄汤/生化汤原书 | 三部小书可一次做完。**库内已留对读埋点**:`48` 镇肝熄风汤节有"批补阳还五汤"之论,读《医林改错》时对读并陈;`48` 固冲汤节与产后下血案有傅青主血崩方化裁,读《傅青主女科》时接上 |
| 2(原第 5 步) | 《神农本草经》+《医宗金鉴·四诊心法要诀》 | 本经原文校核、四诊歌诀 | 本经**以并入为主**:给 `16`~`22` 相应药物条目加"《本经》:"原文行,不必新开文件;四诊心法要诀小篇,并入 `09`/`10` 或附 `46` 均可 |
| 3(原第 6 步) | 《医方集解》+《医宗金鉴·删补名医方论》 | 方论深化,提升 B 级建议的说理质量 | 以并入 `25`~`30` 方剂条目为主("汪昂:""《金鉴》:"方论行)。**已留一戒**:`47` 收有吴鞠通"万物各有偏胜"论点名批《医方集解》"统治"语——读该书时带此批判眼光,勿照收其"通治"表述 |
| 4(原第 7 步,压轴) | 《中医养生学》《中医饮食营养学》 | 功法(八段锦等)与刮痧要领入 `40`、系统食疗层、体质调养细化;随之解锁**资源受限适配完整版**(SKILL 既有流程从"核心版"升级) | 保健食疗是医学层之上的应用层,置于最后是有意安排;两书均为现代教材,走教材整理法而非古籍分流法 |
**并行专项(不依赖上表顺序,建议最先做)**:《中华人民共和国药典》现行版剂量校准——对照药典逐味复核安全表 101 味毒性药的剂量上限与毒性分级,补药典独有警示,然后移除全库"未经药典校准"声明。这是唯一影响安全边界精度的未竟项。做法:逐块落盘+按药典目录逐味机械自查,完成后按名单二次校核。
**可选(不入必修,价值递减)**:《丹溪心法》>《本草备要》(与教材重叠高)>《脉经》(脉形不可自测,收益有限)>《汤头歌诀》;《医宗金鉴》其余部分维持检索源。另有待寻数据源:《中成药学》类文本(解锁中成药品种库)、官方药食同源目录(A 级食疗白名单依据)。
### 续作方法(本库定型的工作法,照做即可保持质量一致)
1. **每本书的流程**:逐字通读 → 提炼落盘 → 条目级机械自查(逐味/逐首/逐篇对照原书清点,历史证明必能查出遗漏)→ 反哺互链 → 收口。大书(≳30 万字)先读目录出落盘计划、分块读写。
2. **古籍内容分流四路**:**路A 并入既有条目**(补强性内容,前缀出处如"张锡纯:",单点 ≲10 行);**路B 新开文件**(体系性贡献,49 号起续编,命名"NN-类别-主题",标注层次:溯源层/方证条文层/医家经验层);**路C 升级规则层**(改变流程或安全分级的,动 SKILL 与规则文件);**路D 存目**(时代局限、毒剧禁行、无仲裁价值的冲突项,只记名不展开)。单书 0~2 个新文件为度,能并入不新开。
3. **三条硬规则(不可破)**:①古籍与教材冲突,**教材为用、古籍为源**,显著分歧条目内并陈;②**古籍剂量配伍毒性永不进用药通道**(只作文献,现代用量回 `15`~`30`+安全表);③**零孤文件**——新文件必须双向互链+进 `00` 直达索引+进 SKILL 索引表与分流表,收口跑全库链接与路由核查。
4. **收口固定动作清单**(每本书完成时逐项做):路A 反哺相关文件 → 落盘完整性复审(对照原书目录查漏)→ 全库互链与路由核查 → `00` 加直达行 → SKILL 常规动作(版本头/收录范围/索引表/分流表)→ `sources/_目录与状态.md` 状态改"已整理" → CHANGELOG 记详录 → README 只动路线表状态行(整体随大版本更新)。
5. **既有惯例**:同名异方入警示清单(SKILL 使用原则#6);教材提及而未展开的方标"※锚点"不虚构;OCR 讹字与库内互证订正并记 CHANGELOG;医家书中的西医内容按其时代标注警示(参照 `48` 的 1920 年代处理);法定传染病与危重症治法一律存目转红线。
各书整理状态见 `sources/_目录与状态.md`,逐版详细变更见 CHANGELOG.md。
## 免责声明
本 Skill 为**学习参考工具**,不构成医疗建议,不能替代执业中医师的面诊(尤其舌脉——文字描述无法替代亲见)与现代医学诊疗。急危重症请立即就医。