算命风水 Skill 生态调研报告

一、执行摘要

在各大 AI Agent 社区（Hermes 社区、Claude Code 社区、GitHub、Hacker News、Reddit、X）调研「算命风水类 skill」后发现：

• GitHub 是绝对主阵地：发现 60+ 个相关仓库，其中约 20 个达到可安装、可用的质量，覆盖周易（易经）、八字（四柱）、紫微斗数、风水堪舆、六爻、梅花易数、小六壬、塔罗、占星、起名、择日等全部主流术数。
• 官方与主流聚合仓库全部空白：anthropics/skills（Anthropic 官方）、obra/superpowers、awesome-claude-code、davila7/claude-code-templates 等知名聚合仓库中均无算命类 skill。这个赛道完全由独立开发者/民间生态支撑。
• Hermes 生态现状：Hermes Agent 官方 Skills Hub（agentskills.io）是格式标准与文档站，不托管具体算命 skill；但多个社区仓库明确标注兼容 Hermes（支持 SKILL.md 格式），可直接安装。
• 生态最大共识：「LLM 做推理解读，确定性计算交给脚本」——头部仓库（mingli-skills、Know-your-fate、astro-tarot-bazi-divination-skills 等）均采用 Python 脚本排盘/起卦 + LLM 解卦的架构，明确反对"让模型凭幻觉算卦"。
• Reddit / X 渠道受限：VPS 数据中心 IP 被 Reddit 反爬（403），X API 工具未配置——这两渠道无法直接检索，报告以 GitHub + HN + 直接抓取为主。

推荐速览（详见第九章）：

• 想装一个全能命理工具 → weizeW/mingli-skills（5 大体系、114 文件、工程化程度最高）
• 想要带 Web 界面的完整应用 → tf1993614/Know-your-fate（6 技能 + 暗色 Web 客户端）
• 想装最纯正的周易起卦 → neallydare-svg/iching-divination（真随机、一事一占）
• 想装风水专项 → voidforall/fengshui.skill（堪舆子，玄空飞星+八宅明镜）
• 想要 MCP 服务器集成 → sapuyou45-bit/ai-divination-skills（pip 安装）

二、调研范围与方法

2.1 调研渠道

2.2 搜索关键词（18 组）

iching skill / claude iching / yijing skill / bazi skill / 八字 skill / fengshui skill / divination skill / tarot skill claude / 算命 claude / zodiac skill / fortune telling skill / 紫微斗数 / 六爻 claude / 周易 claude / astrology skill claude / 占卜 skill / qimen / 梅花易数 / claude 风水 / claude 八字 / claude 周易 / claude 占卜 / claude 算命 / agent skill 命理

2.3 数据可信度标注

三、渠道生态总览

3.1 生态地图

• GitHub（主阵地）：60+ 仓库，中文开发者为主，2025-2026 年集中爆发。质量分层明显：头部工程化项目（多术数、脚本排盘、CI 测试）vs 长尾个人项目（单术数、纯 prompt）。
• Claude Code 社区：官方和主流聚合仓库无算命类，但大量算命 skill 以独立仓库形式存在且明确标注 "Claude Code Skill"——它们不进官方列表，靠 GitHub 搜索发现。
• Hermes 社区：agentskills.io 是开放格式标准（Agent Skills），Hermes 原生支持 SKILL.md；社区仓库可直接安装到 ~/.hermes/skills/。
• Hacker News：主要是独立 Web App（BaziAI 八字 AI、castiching 周易模拟器、塔罗生成器等），不是 skill 格式。
• Reddit / X：被反爬或工具缺失，无法直接调研；从 GitHub 仓库的自述和 README 看，很多项目通过 X/知乎传播（如"傅佩荣数字卦""倪海厦讲风水"等知识型 skill 明显源自中文社区传播链）。

3.2 关键发现：为什么官方聚合仓库是空白？

算命/玄学类 skill 未被 anthropics/skills、superpowers 等官方/主流聚合收录，可能原因：
1. 合规与价值观：官方仓库倾向规避迷信/玄学内容；
2. 质量参差：算命 skill 天然存在"幻觉起卦"问题，官方不愿背书；
3. 中文生态隔离：这个赛道几乎全部由中文开发者主导，而主流聚合仓库以英文为主。

结论：找算命 skill 的正确路径就是 GitHub 搜索 + 口碑传播，而非官方目录。

四、分类全景图

按术数体系分类，各流派均有可用 skill：

五、重点仓库深度档案（Top 12）

以下仓库均实际抓取 README/SKILL.md 验证。

5.1 weizeW/mingli-skills — AI 命理工程化（综合首选）

• 定位：一套工程化的命理分析 Skill 系统，专为 Claude Code / LLM Agent 设计
• 规模：5 大命理体系（紫微斗数/八字/六爻/印占/奇门遁甲）+ 跨体系交叉验证框架，114 个文件，约 1.4MB 方法论 + 排盘引擎
• 核心理念：LLM 做推理解读，确定性计算交给脚本，每个结论可追溯、可验证
• 许可：MIT ✅
• 评级：⭐⭐⭐⭐⭐ 工程化程度最高，多术数交叉验证是独有亮点

5.2 tf1993614/Know-your-fate — 命数天问（Web 应用型首选）

• 定位：暗色主题 Web 客户端 + 六个可离线运行的 Claude Code 占卜技能
• 覆盖：四柱八字排盘、周公解梦、黄历择日、占事吉凶、塔罗占星、新生儿起名、风水堪舆
• 架构：本地 Python 确定性脚本 + 传统数术典籍 + 现代 Web 对话界面
• 许可：MIT ✅
• 评级：⭐⭐⭐⭐⭐ 唯一带完整 Web UI 的开源项目，体验最好

5.3 CharlotteShen/astro-tarot-bazi-divination-skills — 七术数 One Toolkit

• 定位：七种命理技能集合（西方本命占星、塔罗、八字、紫微斗数、宿曜占星、中西合参、astro-MBTI 游戏）
• 亮点：所有计算确定性脚本化（deterministic scripted calculation），中英双语
• 许可：MIT ✅
• 评级：⭐⭐⭐⭐ 中西合璧，覆盖最广

5.4 ShousenZHANG/chinese-fortune — 20+ 术数综合工具箱

• 定位：一个 Claude Skill 把中国五术（山·医·命·相·卜）的 20+ 种命理方法装进一个可移植技能
• 亮点：带 CI（GitHub Actions）和测试，质量工程化
• 许可：MIT ✅
• 评级：⭐⭐⭐⭐ 单 skill 装全 20+ 方法，可移植性强

5.5 neallydare-svg/iching-divination — 真随机起卦（周易首选）

• 定位：真随机起卦的开源易经占卜 skill：密码学级随机、一事一占、凶卦直断、事后对账
• 亮点：明确反对"模型编卦"——起卦由 scripts/cast_hexagram 确定性执行，LLM 只负责解卦
• 许可：MIT ✅
• 评级：⭐⭐⭐⭐⭐ 起卦方法论最严谨（针对大模型算卦的"讨好式编卦"顽疾做了机制化防御）

5.6 voidforall/fengshui.skill — 堪舆子（风水首选）

• 定位：传统风水顾问 Claude Code Skill——三元玄空飞星、八宅明镜、择日学
• 特色：以江南三元世家传人的视角，排玄空飞星盘、判断旺位凶位、择吉日化解煞气
• 许可：未注明 ⚠️
• 评级：⭐⭐⭐⭐ 风水领域最专业的开源 skill

5.7 dzcmemory-web/bazi-ziwei-skill — 八字+紫微排盘

• 定位：AI 八字 + 紫微斗数排盘与综合印证 Skill：算法精准排盘（不靠 LLM 猜）
• 亮点：三种分析模式，一键生成水墨风 HTML 命盘海报
• 兼容：Claude / Codex / Cursor / Workbuddy 等 SKILL.md Agent
• 许可：MIT ✅
• 评级：⭐⭐⭐⭐ 排盘算法精准，水墨风海报是独特卖点

5.8 xuemian168/bazi-skill — 八字排盘全家桶

• 定位：八字排盘、紫微斗数、星座合参、奇门六爻、合盘与择日择时 Skill
• 自述："用最科学的方式，做最不科学的事情"，确定性精确计算 + prompt engineering
• 附带：Web App（dockon.de 产品层）
• 许可：未注明 ⚠️
• 评级：⭐⭐⭐⭐ 覆盖极广，有商业产品背书

5.9 sapuyou45-bit/ai-divination-skills — MCP 服务器版

• 定位：MCP server + Python CLI，供 AI agents 做塔罗、I Ching、小六壬占卜
• 亮点：audited local scripts 生成结果，模型只负责解读；可 pip 安装（PyPI）
• 许可：MIT ✅
• 评级：⭐⭐⭐⭐ 唯一走 MCP 标准路线的，适合需要进程级集成的场景

5.10 yepco/claude-skill-mingli — 蒸馏式命理全才

• 定位：八字 / 奇门遁甲 / 六爻 / 大六壬 / 风水 / 梅花易数 / 紫微斗数 / 塔罗 / 相法都能起局断事
• 架构：由"蒸馏课程"母 skill 从一套命理课程素材自动蒸馏而成，含知识卡、问答对、案例库，完全自包含、不联网
• 许可：未注明 ⚠️
• 评级：⭐⭐⭐ 知识蒸馏思路独特，但确定性计算弱于头部项目

5.11 rgvsp1993-commits/liuyao-divination — 六爻占卜

• 定位：基于朱熹《周易本义》+ 野鹤老人《增删卜易》的完整六爻占卜系统
• 亮点：纳甲 → 定世应 → 配六亲 → 配六神 → 断卦分析 → 应期推断全流程
• 许可：MIT ✅
• 评级：⭐⭐⭐⭐ 六爻领域考据最严谨（有古籍出处）

5.12 muyen/meihua-yishu — 梅花易数

• 定位：适用于 Claude、ChatGPT、Gemini、DeepSeek 等 AI/LLM 的占卜技能
• 许可：CC BY-NC-SA 4.0 ⚠️（非商用）
• 评级：⭐⭐⭐ 跨平台兼容好，但许可限制商用

5.13 其他值得关注

六、横向对比表

七、质量评估标准（选 skill 看什么）

基于头部项目的共性，评估一个算命 skill 是否值得装：

1. 确定性计算分离（最重要）：起卦/排盘是否由脚本执行而非 LLM 凭空生成？头部项目全部遵循"LLM 解读、脚本计算"——这是防止"模型讨好式编卦"的唯一机制。
2. 古籍/方法出处：是否注明方法论来源（如《周易本义》《增删卜易》、傅佩荣数字卦、玄空飞星）？
3. SKILL.md 规范：是否标准 SKILL.md 结构（frontmatter + 指令），能否被 Hermes/Claude Code 自动发现？
4. 许可：MIT/Apache 可自由商用；PolyForm 非商用；CC BY-NC-SA 禁商用。
5. CI/测试：有测试的项目质量明显更高（chinese-fortune 带 GitHub Actions CI）。
6. 安装路径：clone 到 ~/.claude/skills/（Claude Code）或 ~/.hermes/skills/（Hermes）即可，或 pip 安装（MCP 版）。

八、安装指南（Hermes / Claude Code）

8.1 安装到 Hermes

# 以 mingli-skills 为例
git clone https://github.com/weizeW/mingli-skills.git /tmp/mingli-skills
mkdir -p ~/.hermes/skills/
cp -r /tmp/mingli-skills/* ~/.hermes/skills/  # 按仓库结构放置 SKILL.md

安装后 Hermes 的 /skills 命令即可发现。注意：仓库若含多个 skill（如 astro-tarot-bazi 含 7 个），每个 skill 子目录需按 SKILL.md 规范放置。

8.2 安装到 Claude Code

mkdir -p ~/.claude/skills/
git clone https://github.com/neallydare-svg/iching-divination.git ~/.claude/skills/iching-divination

或使用 claude CLI 的 skill 管理。多数仓库 README 自带安装命令。

8.3 MCP 安装（ai-divination-skills）

pip install ai-divination-skills
# 按 README 配置 MCP server 到 claude_desktop_config.json 或 Claude Code

九、推荐方案（按使用场景）

场景 A：想要一个全能命理工具箱（最推荐）

首选：weizeW/mingli-skills（5 大体系、114 文件、交叉验证、MIT）

• 理由：工程化程度最高，紫微/八字/六爻/印占/奇门五大体系可交叉验证，结论可追溯
• 备选：ShousenZHANG/chinese-fortune（20+ 术数单 skill，更轻量）

场景 B：想要带界面的完整应用

首选：tf1993614/Know-your-fate

• 理由：唯一带完整暗色 Web 客户端 + 6 个离线 skill，开箱即用体验最好

场景 C：只想用最纯正的周易起卦

首选：neallydare-svg/iching-divination

• 理由：密码学级真随机起卦 + 一事一占 + 凶卦直断，机制上杜绝"模型编卦"
• 备选：pnedfff/fupeirong-digital-iching-skill（傅佩荣数字卦，可审计可复现）

场景 D：风水专项

首选：voidforall/fengshui.skill

• 理由：玄空飞星 + 八宅明镜 + 择日学，风水领域最专业
• 备选：sanshanchen/ni-haixia-fengshui-skill（倪海厦风格知识型）

场景 E：MCP 进程级集成

首选：sapuyou45-bit/ai-divination-skills

• 理由：唯一 MCP 标准路线，pip 安装，audited 脚本保证结果确定性

场景 F：六爻专项

首选：rgvsp1993-commits/liuyao-divination

• 理由：考据最严谨（《周易本义》+《增删卜易》），全流程自动

组合建议

• 休闲体验：iching-divination + tarot.skill
• 认真研究命理：mingli-skills（主）+ bazi-ziwei-skill（辅助排盘海报）
• 产品化：Know-your-fate（Web UI 参考）+ ai-divination-skills（MCP 后端）

十、风险与边界（如实告知）

1. 娱乐性质：所有算命 skill 本质是传统文化知识 + 随机/规则计算的组合，不具备预测功能。头部项目自身也强调"不作确定性预测"（如 yangjin-xuan-skill 明示"用于文化解读和个人反思，不作确定性预测"）。
2. 幻觉风险：不采用确定性计算的 skill（纯 prompt 型）仍可能"编卦"——选 skill 时优先脚本计算型。
3. 隐私：八字排盘需要出生时间等个人信息，优先本地运行（所有推荐项目均为本地脚本，数据不出机器）。
4. 许可合规：商用前检查许可——PolyForm 非商用、CC BY-NC-SA 禁止商用；MIT 可自由商用。
5. 内容边界：涉及医疗/投资/重大决策的"指点"应明确拒绝——多数 skill 内置伦理边界（如 bazi-ziwei-mingli-cn 含"命理伦理边界"模块）。

十一、结论

算命风水 skill 生态是中文开发者主导、GitHub 为核心、质量分层明显的民间生态。官方聚合仓库空白，但社区仓库已覆盖全部术数体系，且头部项目在工程化（脚本排盘、CI 测试、Web UI、MCP 集成）上已达到相当水准。

核心判断：这个生态的"最佳实践"已经收敛——确定性计算 + LLM 解读是共识架构。推荐优先选择符合此架构的仓库（mingli-skills、Know-your-fate、iching-divination 等），它们既好用又可验证，也最符合第一性原理的工程标准。