八字、紫微斗数、周易、六爻、奇门遁甲、风水、黄历、姓名学、塔罗……繁重的历法计算交给确定性 Python 脚本，Claude 依据参考文档解读。仅供文化研习与自我反思，不构成医疗、法律、金融建议。
- 20+ 种方法，一个技能 — 命卜相术全覆盖，单一自包含 skill，无需后端、无需联网。
- 确定性计算 — 13 个 Python 引擎在
lunar_python（寿星天文历 算法移植，节气误差 < 1 秒）上排盘起卦，而非让大模型手算（易错）。 - 历法严谨 — 真太阳时、节气定月、立春年界、夜子时、闰月等业余易错处全部正确，并经独立引擎 sxtwl 跨库对照 1920–2080 全网格验证。
- 渐进式披露 — Claude 先加载小路由，再按需调用对应方法的文档与脚本，上下文最小化。
- 安全护栏 — 硬红线（不预测死亡、不做医疗法律金融决断、不接诅咒）+ 危机转介，内建于技能。
- 工程化 — 977 测试 / 82% 覆盖 /
ruff+mypy+ CI 五道质量门。
从 Releases 下载 chinese-fortune-v*.zip，按平台导入：
| 平台 | 导入方式 |
|---|---|
| Claude Code | 解压到 ~/.claude/skills/ → 重启。压缩包内 chinese-fortune/ 文件夹即技能。 |
| Claude.ai | 设置 → Capabilities → Skills → 上传技能 → 选该 zip。 |
| OpenAI / 其他 | 解压到任意位置；agent 指向 agents/openai.yaml，把 scripts/ 当工具调用。 |
pip install "lunar_python>=1.4.4,<2.0" # 所有平台：精确农历 / 八字 / 黄历导入后直接对 Claude 说话即可，技能按中英文请求自动触发：
我 1990 年 5 月 10 日下午 2 点半出生，男，北京。详细批一下八字。
帮我用铜钱起一卦，问要不要跳槽。
2026 年 6 月想搬家，我属龙，哪几天合适？
脚本也可独立运行（输出结构化 JSON）：
python scripts/bazi_calc.py --year 1990 --month 5 --day 10 --hour 14 --gender male
python scripts/yijing_cast.py coins --question "要不要接这个 offer？"
python scripts/huangli_query.py --date 2026-06-15python scripts/<名>.py --help 查看完整参数。从源码自行打包：python scripts/build_skill.py。
| 分类 | 方法 | 配套脚本 |
|---|---|---|
| 命 | 八字、紫微斗数、称骨、河洛理数、七政四余 | 八字、紫微 |
| 卜 | 周易、六爻、梅花易数、奇门遁甲、大六壬、小六壬、太乙、灵签、杯筊 | 周易、六爻、梅花、奇门、大六壬、小六壬 |
| 相 | 风水（八宅 / 玄空）、面相、手相、测字 | —（文档解读） |
| 术 | 黄历择日、姓名学、合婚、解梦、生肖、星座、塔罗 | 黄历、姓名、合婚 / 生肖、塔罗 |
每种方法对应 references/ 中的参考文档，需要计算的另配 scripts/ 脚本。完整路由表见 SKILL.md。
SKILL.md 路由：frontmatter 触发词 + 方法表
references/ (23) 命理正文：理论 + 各方法解读指南
scripts/ (13) 确定性计算引擎（lunar_python + SystemRandom）
assets/ (12) JSON 查表（干支、64卦、神煞、塔罗、笔画 …）
evals/ 发布校验 + 12 场景机器断言
tests/ pytest 黄金值 + 边界 + 独立引擎差分
历法正确性（真太阳时、节气定月、立春年界、夜子时、闰月）交给 lunar_python，技能在其上叠加格局 / 用神 / 解读层。
硬红线（见 references/20-disclaimer.md）：不预测死亡日期、不做医疗 / 法律 / 金融决断、不接诅咒加害、不归咎他人、不推销付费“化解”。每次解读都以“启发性倾向”呈现并附简短免责；遇急性危机信号转介求助资源。
python -X utf8 evals/run_checks.py # 发布校验（6 项）
python -m pytest tests/ # 单元 + 集成 + 独立引擎差分CI（Python 3.11 / 3.12）强制执行五道门：
| 门 | 内容 |
|---|---|
ruff |
代码规范，0 容忍 |
mypy |
静态类型检查 |
pytest |
977 测试 — 黄金值、立春 / 夜子时 / 闰月边界、五鼠遁不变量、对 sxtwl 独立引擎差分 |
| coverage | 子进程追踪 82%，低于 80% 即失败 |
| harness | SKILL.md 校验 + 12 场景机器断言 + 脚本 JSON 合法性 |
欢迎 PR——更深的紫微 / 玄空飞星逻辑、更多 evals 场景、繁體翻译。提交前请跑 evals/run_checks.py 与 pytest，详见 CONTRIBUTING.md。
MIT。基于经典文献（《周易》《滴天髓》《三命通会》《渊海子平》《紫微斗数全书》《卜筮正宗》《梅花易数》…）与 6tail/lunar-python。仅供文化 / 教育参考——结果是概率性倾向，非确定性预言。