Fortune Skill — 中国传统命理 AI 分析技能

Source-available，非商用使用。详见 LICENSE 和 THIRD_PARTY_NOTICES.md。

隐私与示例数据声明

本仓库 README、文档、测试脚本（含 scripts/verify.mjs）以及任何示例命令中 出现的出生日期、时辰、出生地、姓名等命主信息均为虚构演示数据， 不对应任何真实人物。请勿据此推算真人命盘或还原个人画像。

用户在本地使用本 Skill 生成的命理报告默认存放于 reports/， 该目录已加入 .gitignore，不上传到任何远程仓库。如需提交相关变更， 请先运行 node scripts/privacy-check.mjs 自查。

---

30 秒上手

git clone https://github.com/ai-freer/fortune-skill.git
cd fortune-skill
./install.sh

install.sh 会自动安装依赖、检测本地 agent 平台（Claude Code / Codex / Cursor / Trae）并把仓库 symlink 到对应 skill 目录。重启 agent，对话里说 "算八字 / 看紫微 / 今年运势 / 合婚" 等触发词即可调用。

完整安装指引（分平台手动安装、依赖要求、验证、升级、卸载、常见问题）见 INSTALL.md。

---

项目概述

为 OpenClaw agent 构建一个中国传统命理分析 Skill，支持紫微斗数和八字命理两大体系。用户通过自然语言对话提供出生信息，系统自动排盘并结合经典典籍进行专业分析。

设计目标：对 OpenClaw / Claude Code / Codex 等 agent 平台原生友好。

时间基准原则

本项目以出生地校正后的真太阳时为排盘基准。用户提供的现代标准时间只作为原始输入，脚本会自动进行夏令时和真太阳时校正；未校正 Raw Time 不作为正式命盘依据。

外部 benchmark 或预计算命盘如果使用未校正时间，其结果只用于研究参考，不作为本项目正确性标准。需要验证分析质量时，应使用本项目自己的时间校正规则重新排盘。

---

协议与公开发布边界

本仓库的原创代码、文档、脚本、prompt 和 skill 材料默认按 PolyForm Noncommercial License 1.0.0 发布，仅限非商用使用；这不是 OSI 意义上的开源协议。

第三方依赖、vendored 代码和引用材料保留各自的原始协议或权利状态，详见 THIRD_PARTY_NOTICES.md。其中 vendor/bazi/ 对应的上游 china-testing/bazi 在本地审查时未发现声明式 license，本仓库保留 该目录用于个人、研究和非商用场景，但不对其作额外转授权。

---

核心依赖

核心排盘依赖优先选择成熟项目；第三方协议状态以实际仓库和 THIRD_PARTY_NOTICES.md 为准。

项目	⭐	语言	License	最近更新	用途
SylarLong/iztro	3,617	TypeScript	MIT	2026-04-15	紫微斗数排盘引擎（12 宫、运限、四化、三方四正、插件系统）
6tail/lunar-javascript	1,502	JavaScript	MIT	2026-04-30	万年历+八字排盘（四柱、十神、五行、大运、流年、神煞、纳音）
china-testing/bazi	1,285	Python	未声明 / accepted risk	2026-02-03	三命通会论断、冲刑合会分析、五行分数、格局判定、合婚
jinchenma94/bazi-skill	1,208	Markdown	MIT	2026-04-04	分析流程框架 + 经典典籍 references（穷通宝典等九本）

参考项目（不直接依赖）

项目	⭐	参考价值
hhszzzz/taibu	119	AGENTS.md / CLAUDE.md 的 agent 友好设计、MCP 工具定义方式、taibu-core 的 API 设计思路
DestinyLinker/MingLi-Bench	133	LLM 命理评测基准（160 道题），可作为题库和评测流程参考；若预计算命盘未校正真太阳时，不作为本项目排盘标准

---

架构

fortune-skill/
├── SKILL.md                    # OpenClaw Skill 入口
├── AGENTS.md                   # Codex agent 指引
├── CLAUDE.md                   # Claude Code agent 指引
├── package.json                # npm 依赖（iztro, lunar-javascript）
├── requirements.txt            # Python 依赖（lunar-python, colorama, bidict）
├── scripts/
│   ├── ziwei-chart.mjs         # iztro → 紫微盘 JSON
│   ├── bazi-chart.mjs          # lunar → 八字盘 JSON
│   └── bazi-classic.py         # china-testing/bazi → 三命通会评判 JSON
├── vendor/
│   └── bazi/                   # china-testing/bazi（git clone）
└── references/                 # 命理知识库（LLM 分析时读取）
    ├── classical-texts.md      # 九本经典典籍核心规则摘要
    ├── wuxing-tables.md        # 五行、天干地支、十神参考表
    ├── dayun-rules.md          # 大运顺逆排规则
    ├── shichen-table.md        # 时辰对照表
    ├── ziwei-guide.md          # 紫微斗数解盘指南
    └── bazi-guide.md           # 八字命理分析指南

---

三层计算架构