fengshui-master
voidforall/fengshui.skill · skills.sh
Open source Repository Open in the app JSON README (API)
About
Skill publicada por voidforall/fengshui.skill no skills.sh. Instale com: npx skills add voidforall/fengshui.skill@fengshui-master
Details
- Kind
- Agent skills
- Publisher
- voidforall
- Origin
- skillssh
- Category
- ferramentas
- Stars
- 305
- Forks
- 47
- Last push
- 2026-09-20T17:57:55Z
- Repository state
- ativo
- Added
- 2026-10-07 06:29:46
- Updated
- 2026-10-07 06:29:46
- Origin id
voidforall/fengshui.skill/fengshui-master
README
# 堪舆子 · 传统风水顾问
> 「峦头为体，理气为用；峦头差，理气无用。」
**一个遵循 [Agent Skills 开放标准](https://agentskills.io) 的 Skill，将传统堪舆学蒸馏为可对话的风水顾问。** 以江南三元世家传人的视角，运用玄空飞星、八宅明镜、择日学等传统方法，帮助你分析居住环境、选择吉日、化解煞气。
本 Skill 只是一份符合标准的 `SKILL.md` + 参考资料，不绑定任何特定工具——可在 Claude Code、Codex CLI 等 30+ 支持 [Agent Skills](https://github.com/agentskills/agentskills) 标准的智能体中直接使用。
---
## 这是什么
传统风水（堪舆学）是一套研究居住环境与人居关系的学问，包含形势（地理格局）与理气（方位气场）两大体系。本 Skill 将其核心方法论编码为 AI 智能体可执行的知识框架，使其能够：
- 根据房屋朝向、入住时间，**排布玄空飞星盘**，判断旺位凶位
- 依据居住者命卦，**配合八宅游年**，给出四吉四凶方布局建议
- 结合年月神煞，**筛选入宅/开业/动土吉日**，给出可操作时间窗口
- 识别路冲、天斩、壁刀等**常见外煞**，提供化解方案
- **解读风水术语**与经典原文，回答堪舆学理论问题
不是玄学算命，不卖风水摆件，不恐吓煞气。基于《沈氏玄空学》《地理五诀》《协纪辨方书》等传统典籍的系统性方法。
---
## 安装
本项目遵循 [Agent Skills 开放标准](https://agentskills.io)（`SKILL.md` + YAML frontmatter），可用官方跨工具安装器 [`npx skills`](https://github.com/vercel-labs/skills) 一键装进 Claude Code、Codex CLI 及其他兼容工具，也可手动 clone。
### 方式一：npx skills（推荐，Claude Code / Codex CLI 通用）
```bash
# 自动检测项目内已使用的智能体（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](https://github.com/vercel-labs/skills) 维护，支持 70+ 智能体，`--agent` 也可写 `cursor`、`opencode`、`windsurf` 等其他兼容工具名。
### 方式二：手动安装
按你使用的工具，clone 到对应的 skills 目录即可（目录名不强制，仅需包含 `SKILL.md`）：
```bash
# 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](https://github.com/agentskills/agentskills) — Agent Skills 开放标准规范
- [vercel-labs/skills](https://github.com/vercel-labs/skills) — `npx skills` 跨工具安装器
- [anthropics/skills](https://github.com/anthropics/skills) — 官方 Skill 仓库
- [nuwa-skill](https://github.com/alchaincyf/nuwa-skill) — 从公众人物蒸馏思维框架
- [awesome-persona-distill-skills](https://github.com/xixu-me/awesome-persona-distill-skills) — Persona Skill 合集
---
## 免责声明
本项目基于传统堪舆学理论，仅供学习、参考与文化探讨。风水为辅，人为为主。重大居住与人生决策请结合实际情况综合考量，勿作为唯一依据。