ML
67 stars Quality 70 Trend 70

Liki — 专业命理 Skill,按命理师的专业标准构建:排盘走天文历算引擎,断语附经典出处,结论可验证, 八字 · 紫微 · 六爻 · 奇门 · 黄历择日 · 风水 · 起名。起名,问卦,风水。 Liki — Professional Skill for Chinese Metaphysics.

Overview

专业命理 Skill 懂命理,用 Liki。 排盘由 Go 引擎计算,判断由规则表解释,依据可回溯。 八字 · 紫微 · 六爻 · 奇门 · 黄历择日 · 风水 · 起名 安装后,在支持 Agent Skills 的 AI 客户端中直接提问即可。Skill 启动时会检查版本;提示更新后重新执行: 第一次使用命理时,建议提供出生日期、尽量精确的时间、出生城市和性别。信息不全时,Skill 会追问或进入考时流程。 - 排盘由 Go 天文历算引擎完成,支持真太阳时、经纬度时区和节气计算。 - 断语来自 799 条规则真值表,命中结果保留因子依据和经典出处。 - 160 道命理师大赛真题用于独立评测;答案与评测过程隔离。 - 出生信息只保留在当前会话;Skill 不索要真实姓名,不在对话之外存储数据。 - 命理结论是传统文化视角的条件性解读,不构成医疗、法律、投资或重大人生决策建议。 Skill 会追问,或使用真实事件进入考时流程。证据不足时明确标注,不会默认时辰。 默认需要访问 JSON-RPC 引擎。高级用户可以自建 engine,并用 LIKI_RPC_URL 指向本地服务。 按提示重新执行 npx skills add ml8s/liki -y。版本校验失败时不降级调用旧 RPC。 仓库根的 engine/、tests/ 和 scripts/ 分别承载引擎、评测和构建脚本;可安装包只来自 skills/liki。调用链固定为:SKILL.md → ENTRY.md → app 卡 → Python 工具或固定 RPC。bazi / divination 通过 Python 工具层编排 RPC、snapshot、因子和断语;naming / fengshui 没有本地 Python 工具层,只使用固定 JSON-RPC 报文。

README

Liki

专业命理 Skill 懂命理,用 Liki。 排盘由 Go 引擎计算,判断由规则表解释,依据可回溯。 八字 · 紫微 · 六爻 · 奇门 · 黄历择日 · 风水 · 起名

安装

npx skills add ml8s/liki

安装后,在支持 Agent Skills 的 AI 客户端中直接提问即可。Skill 启动时会检查版本;提示更新后重新执行:

npx skills add ml8s/liki -y

快速开始

目标 直接这样问
命理 算八字,1990-05-20 12:00 北京出生,男
起名 宝宝起名,2024-06-10 广州出生,男,姓陈
问卦 这个项目能成吗?什么时候有结果?
择日 下个月哪天适合搬家?
风水 我家风水怎么样?

第一次使用命理时,建议提供出生日期、尽量精确的时间、出生城市和性别。信息不全时,Skill 会追问或进入考时流程。

能力概览

领域 覆盖能力
命理 八字、紫微、大运流年、性格、婚姻、事业、财运、健康、学业、六亲、合盘
起名 新生儿起名、成人改名、外国人中文名、自选名字评估
问卦 六爻成败与应期、奇门方向与时机、黄历择日
风水 八宅命卦与门主灶、玄空飞星、流年风水

可信度与边界

  • 排盘由 Go 天文历算引擎完成,支持真太阳时、经纬度时区和节气计算。
  • 断语来自 799 条规则真值表,命中结果保留因子依据和经典出处。
  • 160 道命理师大赛真题用于独立评测;答案与评测过程隔离。
  • 出生信息只保留在当前会话;Skill 不索要真实姓名,不在对话之外存储数据。
  • 命理结论是传统文化视角的条件性解读,不构成医疗、法律、投资或重大人生决策建议。

常见问题

不知道出生时辰怎么办?

Skill 会追问,或使用真实事件进入考时流程。证据不足时明确标注,不会默认时辰。

需要联网吗?

默认需要访问 JSON-RPC 引擎。高级用户可以自建 engine,并用 LIKI_RPC_URL 指向本地服务。

出生数据会被存储吗?

不会。出生数据只在当前会话上下文中使用;不写入本地档案,也不提交到反馈。

怎么更新?

按提示重新执行 npx skills add ml8s/liki -y。版本校验失败时不降级调用旧 RPC。

文档

文档 用途
用户指南 完整使用说明、领域流程、FAQ 与输出边界
Skill 包结构 统一 Skill 的目录、入口和打包契约
README 规范 中英文 README 的结构、标题和排版契约
八字 / 紫微模型 排盘、因子、断语和查询边界
问卦模型 六爻、奇门、黄历的 snapshot 与 answer 契约
风水模型 八宅、玄空、流年和冲突裁决
起名模型 用神策略、字池、候选名和校验边界
反馈模型 Agent feedback 的隐私和契约
版本与发布 CalVer 运行时版本和 SemVer 发行版

开发者

开发环境

make hooks         # 安装 git hooks
make check         # 所有静态检查(格式 + lint + schema + docs)
make gate          # 本地推送前门槛(lint + check + test,~3min)
make build-archive # 打包 unified Liki skill

架构

skills/liki/
├── SKILL.md              # 唯一 skill 入口:路由、安全、反馈
├── VERSION.txt           # 唯一分发版本
├── FAQ.md                # 运行失败与恢复契约
├── bazi/                 # 八字 + 紫微:ENTRY / TOOLS / app / domains / tools
├── divination/           # 六爻 + 奇门 + 黄历:ENTRY / TOOLS / app / domains / tools
├── fengshui/             # 八宅 + 玄空:ENTRY / RPC / app / domains
└── naming/               # 起名:ENTRY / RPC / app / domains

仓库根的 engine/tests/scripts/ 分别承载引擎、评测和构建脚本;可安装包只来自 skills/liki。调用链固定为:SKILL.mdENTRY.md → app 卡 → Python 工具或固定 RPC。bazi / divination 通过 Python 工具层编排 RPC、snapshot、因子和断语;naming / fengshui 没有本地 Python 工具层,只使用固定 JSON-RPC 报文。

引擎镜像

引擎镜像随 GitHub Release 自动发布:docker pull ghcr.io/ml8s/liki-engine:latest。源码构建使用 engine/deploy/docker-compose.yml

领域契约

契约 用途
bazi TOOLS 六个 Python 工具的完整 stdin 报文
divination TOOLS 六爻、奇门、黄历工具报文
naming RPC 起名与八字辅助 RPC 报文
fengshui RPC 八宅、玄空和流年 RPC 报文

测试与发布

make test           # 所有测试(pytest + Go 引擎全量)
make verify        # 端到端集成测试
make golden-engine # golden 全量

分层详见 Release modellint → check → test → verify → gate

正式发布使用 SemVer tag,运行兼容版本使用 CalVer。规则见 Release model

设计原则

  • 分层单一职责:根入口、领域入口、App 卡、领域知识和工具层不互相替代。
  • 单一事实源:工具契约来自 skill-tools.json,因子和断语来自 CSV 长表。
  • 双体系显式合参:八字和紫微分侧计算,冲突分层列证。
  • 评测驱动:golden、functional、integration、skill-up smoke 和 160 题基准分层运行。

贡献

阅读 CONTRIBUTING.md,提交 PR 前同步更新 CHANGELOG.md 和版本契约。版本历史见 CHANGELOG.md

懂命理,用 Liki。

许可与声明

MIT。命理结论为传统文化视角,仅供参考;不构成医疗诊断、法律建议、金融投资预测或重大人生决策。

View this README on GitHub

Recommended Tools

Try a different keyword or remove a filter.

Install

npx skillfish add ml8s/liki