1. 项目概述为AI代理注入传统占卜智慧最近在折腾AI编程助手时发现一个挺有意思的需求如何让这些聪明的“代码伙伴”也能理解并运用一些传统的、非结构化的知识体系比如咱们老祖宗传下来的小六壬占卜术。这可不是简单的信息查询它涉及到一套完整的算法、一套严密的逻辑甚至还有网络上流传的各种版本纠偏。于是就有了这个“xiaoliuren-skill”项目。本质上它是一个技能包一个专门为Cursor、Claude Code、VS Code Copilot这类AI编程代理或称为AI助手设计的插件让它们瞬间获得专业级的小六壬起卦、排盘乃至解卦能力。你可能会问AI自己不能学吗理论上可以但让它从零开始理解小六壬的掌诀、五行生克、六亲体系不仅效率低而且极易出错尤其是网上资料鱼龙混杂五行归属错误比比皆是。这个技能包的作用就是把我或者说道传体系验证和整理好的一整套知识以最直接的方式“灌入”AI的上下文中。它就像一个即插即用的专业模块AI不需要再去全网搜索和甄别直接调用内置的、经过校正的算法和知识库即可。这对于需要在小六壬应用开发、传统文化内容生成或者单纯想用AI辅助起卦分析的用户来说无疑大大提升了准确性和效率。2. 核心设计思路标准化、可验证与即插即用这个项目的设计紧紧围绕着三个核心原则算法的准确性、知识的完整性和集成的便捷性。它不是简单地罗列古籍条文而是构建了一个AI可以直接理解和执行的“操作手册”。2.1 算法校正从源头杜绝常见错误小六壬在网络上传播时一个最普遍也最致命的错误就是“留连”和“小吉”两个宫位的五行归属。很多资料甚至一些流行的排盘软件都错误地将“留连”归为水“小吉”归为土。但在道传体系以及部分严谨的传承中“留连”的五行属土“小吉”的五行属水。这个差异看似微小却直接影响后续五行生克、六亲推算乃至整个解卦逻辑的根基。想象一下如果AI基于错误的数据进行推理得出的结论必然南辕北辙。注意五行归属是占卜体系的基石。留连属土象征迟滞、纠缠的土性小吉属水象征流动、通达的水性。一旦颠倒整个生克关系和象征意义全乱。本技能包的首要价值就是确保了这块基石的绝对正确。因此项目的第一要务就是明确并固化这套正确的五行体系。在SKILL.md这个核心文件中这部分被放在显眼位置并制作了清晰的对比表格确保AI以及查看源码的人第一眼就能看到这个关键校正。2.2 知识体系结构化让AI“读懂”玄学第二个设计重点是知识的结构化。小六壬不是扔三个数字进去就出结果那么简单。一个完整的占卜流程包括起卦方式时间起卦、数字起卦、随机数起卦。需要明确规则。掌诀推算从寅位大安开始如何根据数字循环定位。需要明确的算法步骤。排盘要素定位宫位后需要带出该宫位的完整信息五行、六亲父母、兄弟、子孙等、六神青龙、朱雀等并区分“活六神”与“死六神”在不同场景下的应用。解卦框架提供了“六步解卦法”之类的逻辑框架引导AI如何综合宫位、五行生克、六亲关系等信息进行层次分明的解读。所有这些知识都被系统地编写进了SKILL.md。它不是散文式的描述而是偏向于伪代码和结构化列表的格式便于AI精确提取和执行。例如掌诀推算部分会明确写成“设初始位置索引为0大安输入数字ABC。第一步从索引0开始顺时针数A次得到索引X第二步从索引X开始顺时针数B次得到索引Y第三步从索引Y开始顺时针数C次得到最终索引Z对应宫位为list[Z]。” 这种表述对AI来说毫无歧义。2.3 即插即用的交付形态第三个设计原则是极简的集成。目标用户是开发者或者深度使用AI助手的玩家他们最怕麻烦。因此整个技能包被浓缩成一个核心文件SKILL.md。AI代理如Cursor有特定的技能加载机制通常是将技能文件放在项目目录下的特定文件夹如.cursor/rules早期版本可能是.github/skills。用户只需要把xiaoliuren-skill文件夹拖进去或者把SKILL.md的内容复制到AI的系统提示System Prompt中赋能就完成了。这种设计避免了复杂的API调用、环境配置或模型微调。它利用的是现有AI代理的“上下文学习”或“技能库”功能是一种轻量级、零成本的赋能方案。examples.md文件则提供了测试用例用户或AI可以自行验证起卦结果是否正确确保了技能的可靠性。3. 技能文件深度解析与实操要点SKILL.md是这个项目的灵魂。我们来深入拆解一下它的内容编排和AI是如何与之交互的。3.1 文件内容架构一个优秀的技能文件需要引导AI扮演好“小六壬占卜师”的角色。因此它的结构通常是角色定义开篇明义告诉AI“你现在是一个精通道传小六壬的专家”并强调所使用的五行体系是校正后的版本。核心算法清晰列出掌诀推算的数学步骤。这是可执行代码的核心逻辑。知识数据库以表格或结构化列表形式列出六个宫位大安、留连、速喜、赤口、小吉、空亡的完整属性五行、六亲、六神活/死、基本含义。这部分是AI的“记忆库”。解卦流程与模板提供一个标准化的输出模板。例如输入验证与掌诀推算过程。输出排盘表宫位、五行、六亲、六神。结合五行生克分析如问财运看宫位五行与“财”的五行关系。结合六亲分析如问事业看官鬼、父母爻的强弱。综合断语。 这个模板保证了AI每次解卦的输出都是结构完整、逻辑清晰的而不是零散的句子。禁忌与注意事项明确告诉AI哪些不能做如不涉及医疗、投资具体建议以及强调“死六神”与“活六神”的应用区别通常活六神用于动态、近期事死六神用于静态、本质属性。3.2 AI如何“使用”这个技能当用户在Cursor中提问“帮我用小六壬看看今天下午的面试结果时间是农历四月初五申时。”技能触发Cursor识别到“小六壬”、“起卦”等关键词自动从加载的技能库中检索并激活xiaoliuren-skill的相关内容将其作为高优先级上下文注入本次对话。信息提取与计算AI根据技能文件中的“时间起卦法”将农历日期转换为数字。例如四月取4初五取5申时地支序数9取9。然后严格按照技能文件中的算法从大安(1)开始数4位 - 赤口从赤口开始数5位 - 小吉从小吉开始数9位因为9大于6循环数- 空亡。最终得出掌诀为“空亡”。知识查询与组装AI在技能文件的“知识数据库”中查到“空亡”的属性属土六亲为兄弟死六神为白虎活六神为玄武主谋事落空、阴人干扰等。应用解卦模板AI套用技能文件中的解卦模板进行输出“掌诀推算根据您提供的农历四月初五申时4,5,9推算得最终掌诀为‘空亡’。”“排盘信息宫位-空亡五行-土六亲-兄弟六神-白虎死/玄武活。”“五行生克分析面试可视为官鬼之事克兄弟土但空亡土性落空意味着竞争兄弟虽存在但可能无力或事情本身易有变数、难以落实。”“综合解读空亡主事不谐多有延迟、落空之象。结合玄武活六神需注意信息不明、沟通不畅或对方内部有未告知的情况。建议多做准备跟进消息但需对延期或意外结果有心理准备。”遵守禁忌AI会在最后补充“以上内容由小六壬占卜得出仅供娱乐参考人生决策还请结合现实情况。”整个过程AI就像一个严格遵循手册的操作员其“专业能力”完全来源于SKILL.md这个手册的质量。实操心得在编写技能文件时指令的明确性比语言的优美性重要十倍。避免使用“可能”、“大概”等模糊词汇。对于算法使用“当...时执行...步”的句式。对于知识使用“键值对”式的列表。这能极大减少AI的误解和幻觉。4. 在不同AI代理中的集成实操虽然技能核心是同一个SKILL.md但不同AI代理的集成方式略有差异。这里详细说明几种主流工具的实操步骤。4.1 Cursor / VS Code Copilot 集成这是最主流的使用场景。以Cursor为例它通过项目根目录下的.cursorrules文件或特定目录下的技能文件来扩展能力。具体步骤定位技能目录在你的项目根目录下查看是否存在.cursor或.github文件夹。通常Cursor的技能文件放在.cursor/rules目录下较新版本。如果不存在可以手动创建。放置技能文件将下载的xiaoliuren-skill整个文件夹复制到.cursor/rules/目录下。或者直接将SKILL.md文件的内容添加到你项目已有的.cursor/rules文件末尾。验证加载重启Cursor或重新打开项目。在Chat界面输入一个测试问题如“用小六壬数字369起卦”。如果Cursor能按照标准格式正确输出排盘结果说明技能加载成功。注意事项Cursor的技能加载有时会有缓存。如果放置后不生效尝试完全关闭Cursor再重新打开。技能文件的命名和位置可能随Cursor版本更新而变化。如果上述路径无效查阅Cursor官方文档中关于“Rules”或“Skills”的部分是最稳妥的。一个项目可以加载多个技能文件它们之间通常不会冲突。4.2 Claude Code 或网页版Claude 集成Claude没有本地项目目录的概念集成方式更直接——系统提示词。具体步骤在开启一个新的Claude对话时找到系统提示词System Prompt的输入框。在Claude API或某些支持高级配置的客户端中可以直接设置。将SKILL.md文件的全部内容复制粘贴到系统提示词中。在接下来的用户对话中你就可以直接向Claude提问小六壬相关问题了。注意事项系统提示词有字数限制通常很大但并非无限。SKILL.md文件需要精炼确保包含所有核心算法和知识但可以删除冗余的说明文字。这种方式下Claude在整个对话周期内都具备小六壬能力。但如果你开始一个全新对话且未设置系统提示能力就会消失。4.3 通用方式与其他AI代理对于其他任何支持长文本上下文或知识库检索的AI模型如OpenAI的GPTs、ChatGPT的自定义指令、各类套壳的ChatUI方法万变不离其宗。核心思路将SKILL.md的内容作为“背景知识”、“自定义指令”或“知识库文档”上传/粘贴给AI。自定义指令粘贴到模型的“自定义指令”或“角色设定”栏。知识库将文件上传到AI应用的知识库中并在提问时启用相关检索。上下文窗口在对话开始时直接将技能文本发送给AI并说“请记住以下小六壬占卜规则后续我将依此提问。”避坑指南无论哪种方式在第一次使用前务必进行验证。用一个examples.md中的例子测试一下比如输入“数字111”看AI是否输出“大安”。这是检验技能是否被正确加载和理解的最快方法。5. 扩展应用与高级技巧掌握了基础集成后这个技能包还能玩出更多花样真正融入你的开发或工作流。5.1 开发占卜类应用或机器人如果你正在开发一个微信机器人、Discord Bot或者一个独立的小六壬占卜网站这个技能包可以作为核心算法库。你不需要自己再去研究和验证算法正确性。实现思路后端逻辑将SKILL.md中的掌诀推算算法用你熟悉的编程语言Python、JavaScript等重写为一个函数。输入月、日、时或三个数字输出宫位索引和名称。数据库将六个宫位的属性五行、六亲等建表或写成配置字典。解卦引擎参考技能文件中的解卦模板编写一个简单的规则引擎。根据问题类型问感情、问事业、问健康和得出的宫位、五行组合生成相应的解读文本。前端交互提供输入界面调用后端接口将结构化的排盘和解卦结果美观地展示出来。这样你的应用从底层就保证了算法的正统性避免了市面上很多程序因采用错误五行数据而导致的系统性偏差。5.2 与AI工作流结合自动化分析与报告对于内容创作者、咨询师或研究者可以将此技能与AI的自动化能力结合。批量案例分析如果你有一系列历史事件的时间点可以编写脚本调用具备此技能的AI API批量生成每个时间点对应的小六壬排盘然后进行统计分析寻找某些宫位与特定类型事件之间的关联性。辅助写作在创作涉及传统文化、玄幻或历史题材的小说、剧本时可以用AI为某个虚拟事件“起一卦”得到的排盘结果如“速喜”逢“朱雀”可以成为描写场景、人物心理的灵感来源增加作品的细节真实感。个性化咨询模板结合用户的特定问题如“想换工作”AI不仅能排盘还能根据技能文件中更细致的分类如工作看官鬼、看驿马生成更具针对性的初步分析报告作为真人咨询师的有力参考工具。5.3 技能包的维护与自定义开源项目的魅力在于可以自定义。xiaoliuren-skill提供了一个经过校正的基准版本但你完全可以基于它进行扩展。添加更多解卦流派如果你精通其他小六壬流派如道家秘传、民间法脉可以在SKILL.md中新增章节用“## 流派BXXX体系”来区分并说明不同流派的起卦或断卦差异让AI具备多流派识别能力。丰富象意库技能文件中的宫位基本象意是核心。你可以极大地扩展它为每个宫位添加更丰富的“类神”对应具体事物例如“大安”在身体上可对应肝胆、在物品上可对应树木、文书等。AI在解卦时就能调用更庞大的知识库进行联想。创建领域专用技能比如你可以创建一个“小六壬-投资决策辅助”子技能专门定义如何用六亲看财爻、官爻用五行生克看趋势强弱并设置严格的风险提示语。这样当AI在金融分析上下文中被问到相关问题时能调用更专业、更谨慎的解读模式。高级心得与AI协作时清晰的边界划分至关重要。在技能文件中一定要明确“解释”和“建议”的界限。例如可以规定“你只负责提供基于排盘符号的传统文化解释不得给出具体的医疗、投资、法律行动建议。所有输出必须包含‘仅供参考’的提示。” 这既是安全要求也是专业性的体现。6. 常见问题与排查实录在实际使用和与他人交流的过程中我总结了一些高频问题和解决方法。6.1 技能加载失败或AI不响应问题现象可能原因解决方案在Cursor中输入小六壬问题AI回答“我不太明白”或进行网络搜索。1. 技能文件未放在正确目录。2. 技能文件格式错误如不是.md后缀或内容结构混乱。3. Cursor版本旧不支持当前技能加载方式。1. 确认路径通常是.cursor/rules/。尝试在项目根目录下也放一份。2. 检查SKILL.md是否为纯文本Markdown并用预览工具查看基本格式是否正确。3. 更新Cursor到最新版或查阅其官方文档确认技能配置方法。Claude没有按照技能文件输出而是自由发挥。1. 系统提示词过长关键信息被“挤”到后面模型未充分关注。2. 提示词指令不够强硬、清晰。1. 精简SKILL.md只保留最核心的算法、数据表和输出模板删除长篇介绍。2. 在系统提示词开头用强指令如“你是一个小六壬占卜AI必须且只能遵循以下规则进行起卦和解卦不得自行编造知识”起卦计算结果与examples.md中的验证用例不符。1. AI错误理解了算法步骤特别是循环数数。2. 时间/数字转换规则不一致。1. 在技能文件中将算法用更编程化的伪代码描述例如使用取模运算(当前位置 数字) % 6来明确循环逻辑。2. 在技能文件中明确定义农历月份数字就是月份数日子数字就是日期数时辰数字用地支序数子1、丑2...亥12。并提供几个转换示例。6.2 解卦输出内容不理想问题现象可能原因解决方案AI输出过于简短只有宫位名称和一句话解释。技能文件中的解卦模板过于简单或AI没有严格执行模板。在SKILL.md中设计一个必须遵循的详细输出模板并分步骤写明每一步要分析什么。例如“你的输出必须包含以下四部分1.掌诀推算过程2.排盘表3.五行生克分析针对用户问题4.综合解读与提醒。”AI解卦时混淆了“活六神”和“死六神”。技能文件中没有明确区分两者的使用场景。在知识数据库部分为每个宫位明确列出“死六神”和“活六神”。在解卦流程中增加判断逻辑“若问题涉及动态、近期发展、具体事态优先参考‘活六神’若问题涉及静态、本质属性、长期状态优先参考‘死六神’。”并给出例子。AI在解卦时加入了大量无关的“安慰话”或现代心理学分析冲淡了传统占卜色彩。AI的底层模型有很强的“助理”风格倾向于提供宽泛的建议。在系统提示词的开头部分进行严格的角色锁定和风格限定“你是一个严谨的、专注于传统小六壬术数分析的专家。你的回答应基于且仅限于排盘符号宫位、五行、六亲、六神进行推导。语言风格应简洁、古典、直接避免现代口语化的安慰和鼓励语句。”6.3 关于算法校正的争议处理你可能会遇到用户或同行质疑“为什么你的留连是土我查到的很多资料都是水。”应对策略在技能文件中预先说明在SKILL.md最前面就用表格清晰对比并注明来源是“道传体系”表明这是有据可依的特定流派而非个人杜撰。提供验证依据在examples.md或附加文档中可以引用一些传统文献或指出网络常见版本的逻辑矛盾例如留连若属水其“纠缠迟滞”的特性与水的“流动”特性相悖而与土的“淤塞、停滞”特性更合从义理上解释校正的合理性。保持开放选项如前所述你可以将不同流派作为扩展内容加入技能包并让AI在起卦前询问“请指定您要使用的体系1. 道传校正体系留连土小吉水2. 网络常见体系留连水小吉土。” 这既展示了专业性也尊重了用户的认知习惯。这个技能包的最终目的不是要一统江湖而是为AI世界提供一个准确、可靠、即用的小六壬工具基准。它把我们从重复纠正基础错误的劳动中解放出来让我们和AI都能更专注于解卦逻辑的深化和应用场景的开拓。当你看到AI一丝不苟地推算出掌诀并引经据典般分析五行生克时那种传统智慧与现代技术交融的感觉才是这个项目最迷人的地方。