dhicoc 五运六气
运气学说为中医传统理论，非现代医学诊断标准。临床输出须附加免责声明。 详见
case-journal/precedent-disclaimer.md。
Always Read
case-journal/precedent-disclaimer.mdrules/calculation.mdrouting.yamlworkflows/routing-contract.md
首次使用另读：workflows/bootstrap.md
路由协议（摘要）
- 读
routing.yaml匹配任务（三轴：时间 + 意图 + 知识层级） - 意图模糊 →
prompts/onboarding_prompt.md - 进入目标子技能
SKILL.md后执行 - 推算 MUST 调脚本，MUST NOT 凭记忆推算
完整契约见 workflows/routing-contract.md。人类可读路由摘要见 routing.md。
Common Tasks
| 用户说 | 路由 |
|---|---|
| 今天/某日运气 | tasks/quick-lookup → calculate_yunqi_api.py today --summary |
| 最近/当前步位 | tasks/current-step → --focus current-step |
| 完整年度分析 | tasks/full-year-analysis → yunqi_report.py |
| 推算某年运气 | tasks/year-calc → modules/yunqi-calc/SKILL.md |
| 运气病机 | tasks/pathogenesis → modules/yunqi-pathogenesis/SKILL.md |
| 治法/方药/养生 | tasks/clinical → modules/yunqi-clinical/SKILL.md |
| 七篇大论/文献 | tasks/classics → modules/yunqi-classics/SKILL.md |
| 学概念/思想 | tasks/learn-concept → --explain-concept |
| 个人运气/体质 | tasks/personal-profile → personal_yunqi_profile.py |
| 结合天气 | tasks/weather-alignment → weather_alignment.py |
| 导出摘要/卡片 | tasks/export-thought → export_thought.py |
| 写医案 | tasks/case-journal → case-journal/_template.md |
| Claude Code 插件 | tasks/claude-plugin-install → workflows/claude-plugin-install.md |
| 画个运气时间轴 | tasks/timeline → scripts/visualize_timeline.py --output reports/generated/timeline_<年份>.html |
| 安装/一致性自检 | tasks/ops-selfcheck → scripts/health_check.py |
未命中 → 查 routing.yaml 的 axes 与 on_miss，不得强行匹配。
讲解模式：学概念/思想/注家对照 → expression_style.md（运气导师）+ teaching-modules/ + rag-knowledge-base/*_guide.md；深度注家扮演 → perspectives/（刘完素/张介宾）。双语态见 system_prompt.md §1.1。
延伸索引
| 需求 | 文件 |
|---|---|
| 规则索引 | RULES.md → rules/ |
| 常见踩坑 | references/gotchas.md |
| 任务闭环 | workflows/task-closure.md |
| 模块地图 | references/module-index.md |
| 脚本速查 | references/script-index.md |
| Agent 全链路 | README_AI.md |
| 跨工具薄壳 | AGENTS.md、CLAUDE.md、.cursor/skills/wuyun-liuqi/SKILL.md |
| Claude 插件 | .claude-plugin/、workflows/claude-plugin-install.md |
| 路由场景测试 | tests/routing_scenarios.json、scripts/check_routing_scenarios.py |
| 路由同步 | scripts/sync_routing.py（改 routing.yaml 后 --write） |
| 一致性/孤儿 | conformance.yaml、scripts/check_conformance.py、scripts/audit_orphans.py |
| ReAct 推理 | agent-workflow/react_workflow.md |
| 报告规范 | modules/docs-generator/SKILL.md |
| 思想地图 / 苏格拉底 / CLI / 仪表盘 | export_thought_map.py · socratic_learn.py · yunqi_cli.py · learning_dashboard.py |
| RAG 检索 | rag_search.py --date today · --key · --asset asset9 同格局岁图 · --asset asset11-32 历代名家医案（1994条/21部库，病证路由见 system_prompt.md §2.4）· --asset asset33 疾病易感性（33条，含33669例+691例高血压运气研究） · --asset asset26,asset27 逗号多库 · --field herbs 石膏 按字段 · --semantic 口语 |
| 公版文献库/蒸馏指南 | rag-knowledge-base/literature/（51篇原文177.4万字）· *_guide.md（五层注释链+分组合并，Grep+Read 零依赖） |
| 医案库 | asset9 圣济总录岁图 + asset11-32 历代名家21部库共1994条（含杏轩184/孙文垣390/临证指南330等，按病证检索，含 herbs+formulas_referenced 结构化字段） |
| 医案渐进加载（P1-3） | 按病证/运气查医案库前先调 cases_routing.py 拿首选+补充+强制库清单，再只开命中库，避免整包 22 部撑爆上下文——cases_routing.py --syndrome 湿温 · --rag-key water_excess · --list-assets。瘟疫/痈疽等高风险病证自动附加强制联动库 |
| 讲解人格/教学模块/注家 | expression_style.md + teaching-modules/ + perspectives/（刘完素/张介宾） |
| 可导入包 | wuyun_liuqi（from wuyun_liuqi import calculate, semantic_search） |
| HTML 报告 | generate_html_report.py（含知识库精确命中章节） |
| 病机推理链 | infer_pathogenesis.py <年份>（岁运->司天在泉->六步->方剂五层推理） |
| Fallback 经验库 | case-journal/field-journal/（联网搜索沉淀，非原文存证；含 source_quote + confidence 字段；知识库未命中才查） |
| 医案关联图谱 | case_relations.py --compare/--related（跨医家对比+相似检索，1994条×402证型） |
| 运气时间轴 | visualize_timeline.py <年份>（六步客主加临时间轴 HTML） |
| 医案浏览器 | generate_case_browser.py（1994条静态HTML浏览+搜索+筛选） |
| pip 安装 | pip install -e ".[lunar]" → python tests/smoke_pip_install.py |
| Py/JS 一致性 | scripts/compare_py_js_yunqi.py |