1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | bazi-ziwei-skill |
| 作者/维护者 | dzcmemory-web（GitHub 个人开发者） |
| 来源链接 | https://github.com/dzcmemory-web/bazi-ziwei-skill |
| 许可证 | MIT（数据来自 GitHub API） |
| GitHub Stars | 698（数据来自 GitHub API） |
| Forks | 108（数据来自 GitHub API） |
| 最新版本 | 未发布正式 Release/Tag；算法层 package.json 标注内部版本 0.1.0 |
| 安装方式 | 克隆仓库后复制到对应 Agent 的 skills 目录（见第 10 章） |
2. 功能介绍与亮点
bazi-ziwei-skill 是一个遵循 SKILL.md 开放标准的命理分析技能，核心解决“大模型自己排盘容易出错”的问题：
- 算法层强制排盘：八字四柱、紫微十二宫、大运流年全部由内置算法库（基于开源项目 Yiqi，已 vendored 入库）计算，SKILL.md 明确要求“绝对不要让 AI 自己排八字或紫微”，杜绝 LLM 凭记忆排错日柱、日主、格局的常见问题。
- 格局补层：在原始排盘之上再叠加一层格局、旺衰、调候、刑冲合害的算法判定，为后续的 LLM 分析提供有依据的结构化输入，而非纯靠模型自由发挥。
- 八字紫微交叉印证：把两套独立命理体系的结论做交叉对账，判断主轴是否一致、并在两者冲突时按固定规则给出取舍依据——这是区别于单一体系工具的核心增量能力。
- 一键生成分享海报：综合印证模式可输出单文件 HTML 水墨风命盘海报，包含紫微十二宫盘、八字四柱盘与六维交叉对账，适合截图分享。
- 本地隐私优先：全部计算在本地完成，无需联网，运行产物默认加入 .gitignore。
3. 适用场景
固定分类：内容创作与知识管理。
适合对中文传统命理（八字、紫微斗数）感兴趣、希望借助 AI Agent 获得有算法依据（而非模型臆测）分析结果的用户；也适合内容创作者用其“一键海报”功能产出可在社交平台分享的命盘长图；仓库自带的车牌号推荐等扩展原型（社区贡献）显示其也可作为命理相关小工具的开发基座。
4. 跨 Agent 兼容性
README 的安装说明逐一给出四个目标平台的具体 skills 目录路径，判断依据均来自该文档：
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 文档给出 ~/.claude/skills/bazi-ziwei/ 具体安装路径 |
| Codex | 原生支持 | 文档给出 ~/.codex/skills/bazi-ziwei/ 路径，或通过项目内 AGENTS.md 引用 |
| OpenClaw | 原生支持 | 文档给出其 skills 目录路径，并支持通过 ClawHub 本地安装 |
| Hermes Agent | 原生支持 | 文档给出 ~/.hermes/skills/bazi-ziwei/ 具体安装路径 |
5. 推荐理由
它用一层不可绕过的确定性算法解决了 LLM 命理排盘“一步错、全盘错”的根本缺陷，并在此之上做八字与紫微的交叉印证，这是同类工具少见的设计；本地计算、无需联网与凭据，安全边界清晰；同时内置了对投资/婚恋/医疗类决策“给信号不给指令”的护栏与固定免责声明，工程态度审慎。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | GitHub 698 Stars / 108 Forks；4 名独立用户在 Issue 中反馈真实使用体验（含一例基于此技能搭建在线入口分享给朋友），watcher/star 比例处于正常区间，无刷星迹象 |
| 可用性 | 8 | MIT 许可，唯一运行时依赖 lunar-typescript（同为 MIT）；README 提供中英双语文档与四平台具体安装路径，另附 7 组回归测试用例；需要 Node.js 环境与 npm install 步骤，非严格意义的一键复制即用 |
| 安全性 | 8 | 见下方安全检查清单 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行范围 | 仅在 skill 目录内调用本地 Node 脚本完成排盘计算与 HTML 渲染，用途单一且流程逐步文档化，可审计 |
| ② 运行时联网外发 | 无。文档明确“所有排盘在本地完成，无需联网” |
| ③ API Key/凭据 | 不需要任何外部凭据 |
| ④ 可疑指令 | 通读 SKILL.md 全部执行流程未发现隐蔽指令或数据外发迹象；反而内置对投资/婚恋/医疗类决策“给信号不给指令”的护栏、对违禁请求的拒答规则，以及强制免责声明 |
| ⑤ 作者信誉 | 个人开发者账号，描述用语克制、技术化，无刷星或 SEO 操纵措辞迹象 |
| ⑥ License | MIT，明确 |
| ⑦ 最近维护 | 仓库创建于 2026-06-13，代码最后提交 2026-06-14，未被标记 archived |
7. 跟同类 Skills 相比的优势
| Skill | 定位 | 与本技能的差异 |
|---|---|---|
| xuemian168/bazi-skill | Codex/Claude Code 八字排盘技能，声明支持真太阳时校正、合婚与择日 | 未附开源许可证，仓库在创建后一天内即完成主要开发；本技能附 MIT 许可证与 7 组回归测试案例，且额外提供紫微体系与两盘交叉印证能力 |
| shanrichard/ziwei-skill | 专注紫微斗数单一体系的 Claude Code / OpenClaw 技能 | 仅覆盖紫微一套体系；本技能在紫微之外叠加八字体系，并做两套体系的交叉对账，冲突时按固定规则给出取舍依据 |
8. 用户评价
- shesl-tinkerland（GitHub Issue #4）：基于本技能搭建了一个在线入口，分享给朋友直接查看流日运势，认可其排盘输出可直接对外分享的实用性。
- mononly2011-cpu（GitHub Issue/PR #5）：提交了一个基于八字信息的车牌号推荐功能原型，将本技能的排盘能力扩展到了新的应用场景。
- LookKit / iopl46739-coder（GitHub Issue #2、#3）：在使用中分别反馈了紫微大运细节问题、以及分析结论前后表述不一致的情况，反映出真实用户在深度使用中的具体体验；截至目前这些 Issue 尚未获维护者回复。
9. 其他补充
仓库同时提供简体中文与英文两版 README；TEST-GUIDE.md 与 fixtures/ 目录包含 7 组人工核对过的回归测试案例（Case A–G），用于验证排盘算法准确性。
10. 安装使用方式
# 1. 克隆仓库
git clone https://github.com/dzcmemory-web/bazi-ziwei-skill.git
# 2. 安装算法层依赖（需 Node.js >= 18）
cd bazi-ziwei-skill/calculator
npm install随后将整个 bazi-ziwei-skill/ 文件夹放入对应 Agent 的 skills 目录：
| Agent | skills 目录 |
|---|---|
| Claude Code / Claude Desktop | ~/.claude/skills/bazi-ziwei/ |
| Codex | ~/.codex/skills/bazi-ziwei/，或项目内 AGENTS.md 引用 |
| Hermes Agent | ~/.hermes/skills/bazi-ziwei/ |
| OpenClaw | 其 skills 目录，或通过 ClawHub 本地安装 |
安装后无需额外重启或运行自检命令——SKILL.md 明确要求“装好不自检”，等用户实际提供生辰信息时再触发。使用时直接向 Agent 说出出生日期、时刻（24 小时制）与性别，Agent 会先询问希望做哪种分析（八字独立 / 紫微独立 / 两者交叉印证），再决定是否需要生成 HTML 海报。
11. 注意事项
- 排盘直接使用钟表时间，不做真太阳时经度校正，跨时区/精确择日场景可能存在偏差。
- 若未提供出生时辰，Agent 会主动询问，不会默认按子时处理，请如实提供以免影响日柱与命宫判断。
- Windows 环境下建议在 git bash 或 WSL 中运行算法层脚本，PowerShell 可能出现中文路径编码错乱。
- 结果仅供文化研究与娱乐参考，SKILL.md 明确不会替用户在投资、婚恋、医疗等事项上给出决策性结论。
- 目前仓库尚无正式 Release/Tag，版本管理依赖 Git 提交历史。