Wuyun Liuqi Skills

wuyun-liuqi-skills
TCM Yunqi Skills Router · 五运六气技能路由包

天人合一，五运六气

  AI 自动路由 + 确定性推算引擎 + RAG 知识库 + 自进化经验库
  支持 Claude Code / Cursor / Codex CLI / Cline / OpenClaw 等 AI 客户端

  这是什么 ·
  适合谁用 ·
  快速上手 ·
  核心能力 ·
  项目结构 ·
  贡献

  🌐 English

这是什么
如果你是 AI Agent，直接跳转到 README_AI.md，严格按照内容要求执行。

当用户对 AI Agent（Claude、Cursor、Codex 等）说「今年运气怎么样」「我出生那年的体质倾向」「历代医家怎么治头痛」时，这个技能包让 Agent 调用确定性推算引擎算出干支运气格局，从 3727 条真实医案中检索相关病机与治法，再用通俗语言讲给用户听——而不是凭记忆胡编。

当前状态

路由核心由一个 routing.yaml 驱动，跨工具薄壳自动发现，推算引擎与知识库分离。

(返回顶部)

为什么需要这个项目：
- 大模型容易对干支、司天在泉、客主加临产生幻觉--本包用确定性推算引擎，大寒定年，结果可复现
- 运气知识分散在经典中，普通人难以系统掌握--本包把 51 篇公版文献蒸馏成可 Grep 的结构化指南
- 缺少专为 Agent 设计的运气学技能包--本包提供路由契约、ReAct 工作流、自进化经验库，开箱即用
⚠️ 运气学为中医传统理论，本包用于学习研究与辅助推理，不构成医学诊断或治疗建议。临床决策须由执业医师处理。

适合谁用

- 中医学生 / 研究者 —— 需要准确推算某年某步运气格局，检索历代医家临证经验
- AI 应用开发者 —— 想给 Agent 加一个可靠的运气学能力，而非自己从头实现
- 运气学爱好者 —— 想通过自然对话理解天人合一、气化、中和这些思想，而不是背表格

快速上手

最短安装（推荐）

把下面这段话直接发给 Claude（或其他支持技能的 AI）：

AI 会完成：克隆 → 注册全局技能 → 验证。之后在任意项目里说「五运六气」即可激活。

手动安装

环境要求：Python 3.8+ / Node.js 14+。

三十秒验证

激活方式

配置好后，直接对 Agent 说话即可：

- 「今年运气对养生有什么启发？」
- 「我出生那年的运气格局和体质有什么关系？」
- 「用简单语言解释司天在泉」
- 「历代医家怎么治头痛？给我对比孙一奎和叶天士」

核心能力

🔮 确定性推算引擎

干支推算 · 大运太过不及 · 司天在泉 · 客主加临六步 · 平气判定 · 天符岁会。Python 主链路 + JS 可选接口，双引擎一致性校验，大寒定年，结果可信。

📚 3727 条真实医案 · 21 部公版典籍

从维基文库公版原文逐字蒸馏，零占位、零编造，每条医案附 source_quote 原文存证。覆盖名医类案、续名医类案、古今医案按、丁甘仁、伤寒九十论、临证指南、回春录、张聿青、吴鞠通、寓意草、洄溪、花韵楼、杏轩（184 条）、孙文垣（390 条）等 21 部。

🔍 多维检索

🧠 Agent 自进化 Fallback

工具答不上来时，Agent 不拒绝、不硬编，而是：联网搜索 -> 总结回答（标注来源 + 免责声明）-> 沉淀经验到 case-journal/field-journal/ -> 下次优先查经验库。越用越聪明。

📖 五层注释链（公版蒸馏指南）

全部零依赖，Agent 直接 Grep + Read。

🎭 注家人格 Perspective

刘完素（寒凉派）与张介宾（温补派）做成可运行的 perspective skill，Agent 激活后能切换到注家视角回答问题，而非「替注家说话」。两方原文均可 Grep，形成运气学史上最尖锐的立场对照。

🏥 医学安全边界

- 所有临床输出强制附加免责声明
- 运气理论分析 ≠ 医疗建议，后者必须建议就医
- 方药标注「参考方药，须辨证加减」
- 不给出具体药物剂量

完整功能清单
共 54 个脚本 · 6 个子技能模块 ·…