1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | mingli-master（SKILL.md 自述名称：“命理解读师”） | GitHub 仓库 + SKILL.md |
| 作者/维护者 | Bob（李波/波哥），个人开发者，“与你同学 Learn With You” 主理人 | GitHub API + README |
| 来源链接 | https://github.com/learnwithu/mingli-master | — |
| 许可证 | MIT | GitHub API 实测 |
| GitHub Stars / Forks | 638 / 89 | GitHub API 实测 |
| 最新版本 | v2.0（2026-08-15 发布） | GitHub Releases 实测 |
| 安装方式 | npx skills add learnwithu/mingli-master，或手动克隆到对应 Agent 的 skills 目录 |
官方 README 实测 |
2. 功能介绍与亮点
输入生辰信息，自动生成一份可视化的紫微斗数命盘解读报告（HTML）：
- 计算与解读分离：命盘排布（十二宫星曜、四化飞星、大限）由 Python 库
iztro-py精确计算，格局判定（如“杀破狼”“机月同梁”）由确定性规则引擎完成，LLM 只负责将排盘结果翻译成通俗易懂的解读文字——同一张命盘无论解读多少次，底层数据结论保持一致 - 量化仪表盘：v2.0 新增格局三维量化（风险耐受度/波动恢复力/决策激进度）、空宫借星与能量降阶标记、任意流年的“时空压力热力表”，可通过参数指定查看未来任意一年
- 校准机制：解读结束后给出一组分优先级的校准问题，用户回答后可修正取象偏差，声称将准确度从 65-75% 推向 85% 以上
- 可选手相互证：支持用户提供手相照片或文字描述，与命盘做交叉比对，标注吻合与矛盾之处
- 明确的使用边界：SKILL.md 中列出“不预言死亡、不制造恐惧、不替代决策”等禁忌，定位为“概率地图”式的自我认知参考，而非绝对预言
- 双主题可视化：生成的 HTML 命盘可在“典藏”（金黑古典）与“赛博”（发光卡片）两种视觉主题间切换
3. 适用场景
所属分类：内容创作与知识管理
适合对紫微斗数感兴趣、希望获得一份结构化且可读性强的命盘解读报告的个人用户，例如了解自己的性格底色、事业财运倾向、感情模式，或查看指定年份的运势提示。也适合内容创作者用它快速产出命理类可视化素材。技能本身仅需本地 Python 计算与 HTML 渲染，不涉及占卜以外的决策建议。
4. 跨 Agent 兼容性
- Claude Code：原生支持——README 提供官方安装路径
~/.claude/skills/mingli-master/ - Codex CLI：原生支持——README 提供官方安装路径
~/.codex/skills/mingli-master/ - OpenClaw：未验证——官方材料未列出该宿主的安装说明，但技能本身只依赖标准 SKILL.md 格式与本地 Python 脚本，不含平台专属逻辑
- Hermes Agent：未验证——同上
5. 推荐理由
多数“AI 算命”类技能依赖 LLM 直接背诵排盘规则，换个生辰就可能因记忆偏差算错；这个技能把排盘和格局判定都交给确定性的 Python 脚本与规则引擎完成，LLM 只负责它擅长的部分——把星曜语言翻译成有温度的白话解读，从架构上避免了“算错”的风险。v2.0 新增的量化仪表盘和流年压力热力表让报告不止是一段文字，而是一份结构完整、可视化程度高的命盘解读产出物，且明确写入了“不预言死亡、不制造恐惧、不替代决策”的使用边界，是这个内容品类里少见的克制设计。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | GitHub 638 stars、Forks 89（约 14%，二次分发/自用比例较高）；仓库创建于 2026-06-02，约两个半月内积累现有星数；个人开发者出品，无官方背书，亦未检索到独立于仓库本身之外的第三方具名评价 |
| 可用性 | 9 | npx skills add 一条命令即可安装；README 含完整安装路径、使用示例、原理说明与更新日志；v2.0 于 2026-08-15 发布，维护活跃；唯一依赖 iztro-py 为免费开源 Python 库，无付费依赖 |
| 安全性 | 8 | 见下方检查清单 |
| 综合 | 7.67 | 三项均值 |
安全检查清单：
① Shell 命令及权限范围：仅执行仓库自带的 4 个 Python 脚本（排盘、规则引擎、HTML 生成、校准问题库），职责单一、范围明确，已通读脚本用途说明，未见越权操作。
② 联网外发：全部计算在本地完成（iztro-py 为本地 Python 库），未发现任何网络请求代码。
③ 凭据处理：不涉及任何 API key 或第三方账号凭据。
④ 可疑指令：通读 SKILL.md 与 README 全文，未发现隐藏指令、混淆代码或要求执行无关操作的迹象。
⑤ 作者信誉：个人开发者，README 明确署名与联系方式，v2.0 更新日志中坦诚记录并修正了此前版本的四化忌星表错误，致谢社区贡献者，无造假迹象。
⑥ License：MIT，明确清晰。
⑦ 最近维护：v2.0 于 2026-08-15 发布，维护活跃；README 注明“按兴趣维护，不承诺更新频率”。
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
| bazi-ziwei-skill | 八字 + 紫微斗数双系统排盘与综合印证，同样强调算法精准排盘而非依赖 LLM 猜测 | 覆盖两套命理体系（八字+紫微），本技能专注紫微斗数单一体系但在格局量化、流年压力审计、手相互证等解读深度上做了更细的分层 |
| Numerologist_skills（ziwei-doushu 子技能） | 定位为“给赛博半仙戴上紧箍咒”的工程化框架，覆盖奇门遁甲、紫微斗数等多个术数体系 | 以减少 LLM 幻觉为核心卖点，覆盖体系更广；本技能在紫微斗数单一体系上提供了更完整的可视化报告与双主题呈现 |
| taibu | 综合性命理 App，覆盖八字、紫微斗数、六爻等十余种术数与运势查询 | 是带有 Web/移动端界面的完整应用产品，本技能是可直接安装进 Agent 的轻量 SKILL.md，无需部署即可在对话中使用 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价，GitHub 仓库的 Issue 区也暂无以该技能为主题的用户讨论。
9. 其他补充
技能依赖的排盘引擎 iztro（及其 Python 移植版 iztro-py）是独立维护的开源紫微斗数计算库；README 中致谢了一位社区贡献者（Rita）对 v2.0 格局判定与量化系统的共创贡献。
10. 安装使用方式
- 一条命令安装（推荐）：
npx skills add learnwithu/mingli-master - 手动安装：
git clone https://github.com/learnwithu/mingli-master ~/.claude/skills/mingli-master/（Codex CLI 对应路径为~/.codex/skills/mingli-master/） - 前置依赖：
python3 -m pip install iztro-py --user --break-system-packages - 安装后注意事项：无需重启 Agent；直接用自然语言描述生辰信息（如“帮我排个命盘，1991年8月15日，丑时，男”）即可触发；若 Agent 不支持技能自动加载，也可直接将 SKILL.md 全文粘贴进对话手动使用
11. 注意事项
- 命盘解读的准确度依赖初次生辰信息的准确性（尤其出生时辰），以及后续校准问答的配合
- 内容定位为自我认知参考与娱乐向内容生成，不构成医疗、法律、财务等专业决策依据
- 作者在 README 中声明“按兴趣维护，不承诺更新频率”，长期维护节奏存在不确定性
- OpenClaw、Hermes Agent 的兼容性未经官方材料证实，建议实际使用前自行验证