fengshuiskill

堪舆子 · 传统风水顾问

「峦头为体，理气为用；峦头差，理气无用。」

一个遵循 Agent Skills 开放标准 的 Skill，将传统堪舆学蒸馏为可对话的风水顾问。 以江南三元世家传人的视角，运用玄空飞星、八宅明镜、择日学等传统方法，帮助你分析居住环境、选择吉日、化解煞气。

本 Skill 只是一份符合标准的 SKILL.md + 参考资料，不绑定任何特定工具——可在 Claude Code、Codex CLI 等 30+ 支持 Agent Skills 标准的智能体中直接使用。

这是什么

传统风水（堪舆学）是一套研究居住环境与人居关系的学问，包含形势（地理格局）与理气（方位气场）两大体系。本 Skill 将其核心方法论编码为 AI 智能体可执行的知识框架，使其能够：

• 根据房屋朝向、入住时间，排布玄空飞星盘，判断旺位凶位
• 依据居住者命卦，配合八宅游年，给出四吉四凶方布局建议
• 结合年月神煞，筛选入宅/开业/动土吉日，给出可操作时间窗口
• 识别路冲、天斩、壁刀等常见外煞，提供化解方案
• 解读风水术语与经典原文，回答堪舆学理论问题

不是玄学算命，不卖风水摆件，不恐吓煞气。基于《沈氏玄空学》《地理五诀》《协纪辨方书》等传统典籍的系统性方法。

安装

本项目遵循 Agent Skills 开放标准（SKILL.md + YAML frontmatter），可用官方跨工具安装器 npx skills 一键装进 Claude Code、Codex CLI 及其他兼容工具，也可手动 clone。

方式一：npx skills（推荐，Claude Code / Codex CLI 通用）

# 自动检测项目内已使用的智能体（Claude Code / Codex 等）并安装
npx skills add voidforall/fengshui.skill

# 指定安装到 Codex CLI（写入 .agents/skills/ 或 ~/.codex/skills/）
npx skills add voidforall/fengshui.skill --agent codex

# 指定安装到 Claude Code（写入 .claude/skills/ 或 ~/.claude/skills/）
npx skills add voidforall/fengshui.skill --agent claude-code

# 安装到用户全局目录而非当前项目
npx skills add voidforall/fengshui.skill -g

npx skills 由 vercel-labs/skills 维护，支持 70+ 智能体，--agent 也可写 cursor、opencode、windsurf 等其他兼容工具名。

方式二：手动安装

按你使用的工具，clone 到对应的 skills 目录即可（目录名不强制，仅需包含 SKILL.md）：

# Claude Code
git clone https://github.com/voidforall/fengshui.skill ~/.claude/skills/fengshui-master

# Codex CLI
git clone https://github.com/voidforall/fengshui.skill ~/.codex/skills/fengshui-master

使用方法

安装后，在支持该 Skill 的智能体（Claude Code、Codex CLI 等）中用自然语言描述需求即可触发。无需特定指令，以下场景均能自动识别：

阳宅分析

我家坐北朝南，2018年入住，最近财运不好，帮我看看风水格局

新家东南朝向，想知道主卧应该放在哪个方位，我是1990年的男性

择日

打算今年6月搬新家，帮我选几个入宅吉日，我是1988年男，门朝东

公司9月份想开业，什么日子比较好？

煞气与化解

我家大门正对着一条笔直的道路，这算不算路冲？怎么化解？

风水问答

八宅游年是什么？怎么算命卦？

九运是从哪年开始的？对风水布局有什么影响？

《玄空秘旨》里「山上龙神不下水」是什么意思？

知识体系

文件结构

fengshui.skill/
├── SKILL.md                    # 主 Skill（堪舆子人物设定 + 完整知识框架 + 执行流程）
├── references/
│   ├── feixing.md              # 玄空飞星速查（九宫飞布规则、各运旺衰、流年星表）
│   ├── wuxing-ganzhi.md        # 五行干支速查（天干地支、生克、命卦算法）
│   └── zeri.md                 # 择日神煞速查（建除十二神、月破、三煞、受死日）
└── examples/
    ├── yangzhai.md             # 完整阳宅分析对话示例（含飞星盘排布过程）
    └── zeri-example.md         # 完整择日对话示例（含命卦配合）

人物设定

堪舆子，江南三元派世家第七代传人。主修玄空飞星（沈竹礽一脉），兼通八宅明镜与三合形势，择日依《协纪辨方书》。

风格：引经据典但解释清晰，先问情况再下结论，不夸大风水作用，对伪术直接指出。

「《宅经》云：地善则苗茂，宅吉则人荣。风水能提供有利条件，左右吉凶概率，非决定命运之术。」

参考典籍

• 《宅经》（黄帝宅经）
• 《葬书》（郭璞）
• 《天玉经》《青囊序》（杨筠松）
• 《地理五诀》（赵九峰）
• 《玄空秘旨》
• 《沈氏玄空学》（沈竹礽）
• 《协纪辨方书》（清·允禄等）

相关项目

本项目遵循 Agent Skills 开放标准，也属于 Persona Distill Skill 生态的一部分——将特定领域的知识体系与专家视角蒸馏为跨工具可复用的 Skill。

• agentskills/agentskills — Agent Skills 开放标准规范
• vercel-labs/skills — npx skills 跨工具安装器
• anthropics/skills — 官方 Skill 仓库
• nuwa-skill — 从公众人物蒸馏思维框架
• awesome-persona-distill-skills — Persona Skill 合集

免责声明

本项目基于传统堪舆学理论，仅供学习、参考与文化探讨。风水为辅，人为为主。重大居住与人生决策请结合实际情况综合考量，勿作为唯一依据。