从bazi-skill到你的AI命理工具SKILL.md提示工程与references知识文件架构完全指南【免费下载链接】bazi-skill四柱八字命理分析项目地址: https://gitcode.com/gh_mirrors/ba/bazi-skillbazi-skill 是一个基于 Claude Code 的四柱八字命理分析工具一份 SKILL.md 提示词 五份 references 知识文件 一个零依赖排盘脚本就能让 AI 像专业命理师一样收集出生信息、排出四柱大运并引用九本经典典籍给出分析。本文带你完整拆解它的 SKILL.md 提示工程技巧与 references 知识文件架构你也可以照着搭出自己的 AI Skill。一、3步装好 bazi-skill关键词触发排盘安装只需要两条命令。本机需已安装python33.6 即可只用标准库无需 pip 装任何包# 安装到当前项目在 git 仓库根目录执行 mkdir -p .claude/skills git clone https://gitcode.com/gh_mirrors/ba/bazi-skill .claude/skills/bazi # 或安装到全局所有项目都能用 git clone https://gitcode.com/gh_mirrors/ba/bazi-skill ~/.claude/skills/bazi注意Claude Code 从仓库根目录的.claude/skills/查找 skill请在正确位置执行。安装后在对话中输入算八字、看八字、排盘、命盘、bazi等任意关键词即可触发。Skill 会逐步引导你提供姓名、生日、时辰、性别、出生地然后自动跑排盘脚本并输出综合分析。二、SKILL.md 提示工程一个文件如何教会AI 算命SKILL.md 是整个项目的入口也是提示工程的精华所在。它只有 250 多行却包含了四个关键设计。1. YAML 元数据头告诉 AI什么时候该出场文件开头的 frontmatter 定义了 skill 的触发规则name: bazi— 技能名description— 用中英文双语描述能力并列出算八字、四柱、fortune telling、birth chart等一长串触发词Triggers还写明即使只是提到算命、八字而没有明确说要用 skill也应该使用此 skill。启示description 不是写给人看的简介而是写给 AI 的路由规则。触发词覆盖得越全中英文、口语化说法都列上AI 越不容易该出手时不出手。2. 角色设定 参考文件索引给 AI 一本工作手册角色设定 一句话立住人设你是一位中国传统四柱八字命理的专业研究者并列出九本熟读的典籍。紧接着 重要参考文件 一节用清单形式索引了全部 6 份外部文件文件职责scripts/pai_pan.py排盘计算四柱/大运/流年以脚本 stdout 为准references/wuxing-tables.md五行、天干地支、十神、藏干参考表references/shichen-table.md时辰对照表、日上起时法五鼠遁元references/dayun-rules.md大运顺逆排规则、起运年龄计算references/shensha-table.md神煞吉凶、查法与口诀references/classical-texts.md九本经典典籍核心规则摘要启示不要在提示词里塞满所有知识。用索引 按需查阅的方式把大知识拆进独立文件AI 需要时才去读上下文更省、规则更准。3. 三阶段流水线信息收集 → 排盘 → 综合分析SKILL.md 把整个流程切成三阶段每阶段都有明确的操作指令第一阶段信息收集Step 1-9— 9 小步逐一收集姓名、阳历/农历生日、时辰、性别、出生地等并明确要求不要一次问所有问题一步一步来。有选项的步骤用选择题工具自由文本姓名、地址直接文字询问最后用一张汇总卡片让用户确认第二阶段排盘计算命令行示例— 确认信息后必须先跑脚本并给出 字段到 CLI 参数的映射表如阳历生日 →--solar、时辰不确定 → 两参都不传第三阶段综合分析八大分析框架— 日主强弱 → 十神 → 神煞 → 五行平衡 → 格局 → 大运 → 流年 → 历史事件校准 → 综合建议且要求所有分析都引用经典典籍的论断并标注出处。4. 用硬规则约束 AI杜绝幻觉提示工程最难的不是教会 AI而是禁止它乱来。SKILL.md 里反复出现的强约束值得抄作业见 排盘计算阶段禁止口算、禁止查记忆中的万年历、禁止自行推日柱/月柱/大运后覆盖脚本结果节气交界 / 立春前后只看脚本警告严格采用脚本给出的那套年柱/月柱神煞以脚本为准只解释脚本已列出的条目不要补算未列出的神煞解释必须服从脚本数字不能反过来改盘。启示凡是能交给确定性代码算的干支、节气、起运年龄就让脚本算提示词只负责解释和裁决。把以 X 为准禁止 Y写死AI 的输出才会稳定可复现。三、references 知识文件架构让规则与计算保持同一口径references/目录的 5 份 Markdown 是这份架构的第二个亮点。它们不是随便写的笔记而是被设计成与代码互相咬合的知识库 每份文件只解决一类问题wuxing-tables.md纯查表数据——十天干阴阳五行、十神推导规则、十二长生、地支藏干shichen-table.md时辰对照 早晚子时处理 五鼠遁元口诀与完整查表dayun-rules.md大运顺逆规则表阳男阴女顺排与起运年龄公式shensha-table.md神煞吉凶、查法与口诀分吉与凶/中性两块classical-texts.md九本典籍的核心规则摘要调候用神、格局论命、旺衰判断……把厚重古籍压缩成 AI 可直接引用的条目。 唯一口径设计shensha-table.md 开头 明确声明本表是本仓库唯一神煞口径与scripts/pai_pan.py的计算规则完全一致。SKILL.md 也对应要求 AI 解释时读references/shensha-table.md与脚本同一口径。规则文档、计算脚本、提示词三处指向同一张表AI 解释的每个神煞都能在脚本输出里找到出处——这是知识文件架构最核心的价值不是知识越多越好而是知识与计算零偏差。四、pai_pan.py零依赖脚本给 AI 打好数学底座scripts/pai_pan.py约 1400 行只用 Python 标准库却实现了完整的排盘引擎文件头部的算法锚点注释 本身就是一份精妙的QA 规格书日柱儒略日JDN→ 六十甲子公式gz_index (JDN 49) % 60并给了1990-05-15 庚辰这样的可验证锚点年柱/月柱以立春、十二节的精确太阳视黄经时刻分界立春 黄经 315°而不是写死2 月 4 日节气与农历用 Meeus 简式太阳黄经 定朔算法精确到小时覆盖 1900–2100 年大运阳年男/阴年女顺排起运年龄 出生日到最近节的天数 ÷ 3与 dayun-rules.md 完全一致输出结构化stdout 按## 输入 / ## 四柱 / ## 大运 / ## 流年 / ## 神煞 / ## 警告分段AI 直接引用。配套还有 test_pai_pan.py 回归测试——每个关键算法日柱锚点、立春分界、早晚子时、顺逆排都有测试用例保证唯一口径永不漂移。启示给 AI 写工具链时确定性计算 结构化输出 回归测试三件套比在提示词里反复叮嘱要算得准有效得多。五、复刻指南4步搭出你自己的 AI Skill想把这套架构搬到自己的领域比如塔罗、星座、起名、占星照下面 4 步走写 SKILL.md 入口YAML 头写全name/description/ 触发词中英文 口语变体正文写角色设定、参考文件索引、分阶段流程拆 references 知识文件按查表数据 / 规则流程 / 理论摘要拆成独立 md每份文件只回答一类问题开头声明本文件与脚本同一口径写确定性脚本能算的绝不靠 AI 口算。只用标准库或最小依赖输出结构化 stdout头部注释写清算法锚点建回归测试 硬规则给脚本写锚点测试在 SKILL.md 中用以 X 为准 / 禁止 Y句式锁死 AI 的行为边界并加好边界情况表与免责说明参考 边界情况处理 与 注意事项。六、常见问题Q1为什么 AI 不直接背下万年历偏要跑脚本因为 LLM 记忆中的干支数据不可靠口算日柱、大运容易出错且无法复现。脚本 锚点测试是确定性底座提示词只负责解释错误率与波动都最小。Q2references 知识文件会占满上下文吗不会。SKILL.md 只放文件索引AI 在排盘/分析时才按需读取对应文件——这正是索引式知识架构的初衷。Q3没有 python3 能用吗不能。排盘计算依赖本机 python33.6 即可无 pip 依赖。⚠️ 免责声明bazi-skill 仅供传统文化学习与娱乐参考分析结果不构成任何决策依据。命理分析仅供参考人生在于自身的努力和选择。把 SKILL.md 当作提示工程模板、把references/当作知识库目录结构来读你会看到一套可复用到任何垂直领域的 AI Skill 设计方法论——这才是 bazi-skill 最值得学习的地方。【免费下载链接】bazi-skill四柱八字命理分析项目地址: https://gitcode.com/gh_mirrors/ba/bazi-skill创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考