{
  "markdown": "# 堪舆子 · 传统风水顾问\n\n> 「峦头为体，理气为用；峦头差，理气无用。」\n\n**一个遵循 [Agent Skills 开放标准](https://agentskills.io) 的 Skill，将传统堪舆学蒸馏为可对话的风水顾问。** 以江南三元世家传人的视角，运用玄空飞星、八宅明镜、择日学等传统方法，帮助你分析居住环境、选择吉日、化解煞气。\n\n本 Skill 只是一份符合标准的 `SKILL.md` + 参考资料，不绑定任何特定工具——可在 Claude Code、Codex CLI 等 30+ 支持 [Agent Skills](https://github.com/agentskills/agentskills) 标准的智能体中直接使用。\n\n---\n\n## 这是什么\n\n传统风水（堪舆学）是一套研究居住环境与人居关系的学问，包含形势（地理格局）与理气（方位气场）两大体系。本 Skill 将其核心方法论编码为 AI 智能体可执行的知识框架，使其能够：\n\n- 根据房屋朝向、入住时间，**排布玄空飞星盘**，判断旺位凶位\n- 依据居住者命卦，**配合八宅游年**，给出四吉四凶方布局建议\n- 结合年月神煞，**筛选入宅/开业/动土吉日**，给出可操作时间窗口\n- 识别路冲、天斩、壁刀等**常见外煞**，提供化解方案\n- **解读风水术语**与经典原文，回答堪舆学理论问题\n\n不是玄学算命，不卖风水摆件，不恐吓煞气。基于《沈氏玄空学》《地理五诀》《协纪辨方书》等传统典籍的系统性方法。\n\n---\n\n## 安装\n\n本项目遵循 [Agent Skills 开放标准](https://agentskills.io)（`SKILL.md` + YAML frontmatter），可用官方跨工具安装器 [`npx skills`](https://github.com/vercel-labs/skills) 一键装进 Claude Code、Codex CLI 及其他兼容工具，也可手动 clone。\n\n### 方式一：npx skills（推荐，Claude Code / Codex CLI 通用）\n\n```bash\n# 自动检测项目内已使用的智能体（Claude Code / Codex 等）并安装\nnpx skills add voidforall/fengshui.skill\n\n# 指定安装到 Codex CLI（写入 .agents/skills/ 或 ~/.codex/skills/）\nnpx skills add voidforall/fengshui.skill --agent codex\n\n# 指定安装到 Claude Code（写入 .claude/skills/ 或 ~/.claude/skills/）\nnpx skills add voidforall/fengshui.skill --agent claude-code\n\n# 安装到用户全局目录而非当前项目\nnpx skills add voidforall/fengshui.skill -g\n```\n\n`npx skills` 由 [vercel-labs/skills](https://github.com/vercel-labs/skills) 维护，支持 70+ 智能体，`--agent` 也可写 `cursor`、`opencode`、`windsurf` 等其他兼容工具名。\n\n### 方式二：手动安装\n\n按你使用的工具，clone 到对应的 skills 目录即可（目录名不强制，仅需包含 `SKILL.md`）：\n\n```bash\n# Claude Code\ngit clone https://github.com/voidforall/fengshui.skill ~/.claude/skills/fengshui-master\n\n# Codex CLI\ngit clone https://github.com/voidforall/fengshui.skill ~/.codex/skills/fengshui-master\n```\n\n---\n\n## 使用方法\n\n安装后，在支持该 Skill 的智能体（Claude Code、Codex CLI 等）中用自然语言描述需求即可触发。**无需特定指令**，以下场景均能自动识别：\n\n### 阳宅分析\n\n```\n我家坐北朝南，2018年入住，最近财运不好，帮我看看风水格局\n```\n\n```\n新家东南朝向，想知道主卧应该放在哪个方位，我是1990年的男性\n```\n\n### 择日\n\n```\n打算今年6月搬新家，帮我选几个入宅吉日，我是1988年男，门朝东\n```\n\n```\n公司9月份想开业，什么日子比较好？\n```\n\n### 煞气与化解\n\n```\n我家大门正对着一条笔直的道路，这算不算路冲？怎么化解？\n```\n\n### 风水问答\n\n```\n八宅游年是什么？怎么算命卦？\n```\n\n```\n九运是从哪年开始的？对风水布局有什么影响？\n```\n\n```\n《玄空秘旨》里「山上龙神不下水」是什么意思？\n```\n\n---\n\n## 知识体系\n\n| 流派 | 核心方法 | 用途 |\n|------|---------|------|\n| **三元玄空飞星** | 九宫飞布、元运、山星向星 | 阳宅旺衰、财运人丁判断 |\n| **八宅明镜** | 东西四宅命、游年变卦 | 卧室书房财位布局 |\n| **形势峦头** | 龙穴砂水向、藏风聚气 | 外部环境与煞气判断 |\n| **择日学** | 建除十二神、月破三煞 | 入宅开业动土选日 |\n| **八字配风水** | 日主用神、五行方位 | 个人旺方与颜色建议 |\n\n---\n\n## 文件结构\n\n```\nfengshui.skill/\n├── SKILL.md                    # 主 Skill（堪舆子人物设定 + 完整知识框架 + 执行流程）\n├── references/\n│   ├── feixing.md              # 玄空飞星速查（九宫飞布规则、各运旺衰、流年星表）\n│   ├── wuxing-ganzhi.md        # 五行干支速查（天干地支、生克、命卦算法）\n│   └── zeri.md                 # 择日神煞速查（建除十二神、月破、三煞、受死日）\n└── examples/\n    ├── yangzhai.md             # 完整阳宅分析对话示例（含飞星盘排布过程）\n    └── zeri-example.md         # 完整择日对话示例（含命卦配合）\n```\n\n---\n\n## 人物设定\n\n**堪舆子**，江南三元派世家第七代传人。主修玄空飞星（沈竹礽一脉），兼通八宅明镜与三合形势，择日依《协纪辨方书》。\n\n风格：引经据典但解释清晰，先问情况再下结论，不夸大风水作用，对伪术直接指出。\n\n> 「《宅经》云：地善则苗茂，宅吉则人荣。风水能提供有利条件，左右吉凶概率，非决定命运之术。」\n\n---\n\n## 参考典籍\n\n- 《宅经》（黄帝宅经）\n- 《葬书》（郭璞）\n- 《天玉经》《青囊序》（杨筠松）\n- 《地理五诀》（赵九峰）\n- 《玄空秘旨》\n- 《沈氏玄空学》（沈竹礽）\n- 《协纪辨方书》（清·允禄等）\n\n---\n\n## 相关项目\n\n本项目遵循 **Agent Skills 开放标准**，也属于 **Persona Distill Skill** 生态的一部分——将特定领域的知识体系与专家视角蒸馏为跨工具可复用的 Skill。\n\n- [agentskills/agentskills](https://github.com/agentskills/agentskills) — Agent Skills 开放标准规范\n- [vercel-labs/skills](https://github.com/vercel-labs/skills) — `npx skills` 跨工具安装器\n- [anthropics/skills](https://github.com/anthropics/skills) — 官方 Skill 仓库\n- [nuwa-skill](https://github.com/alchaincyf/nuwa-skill) — 从公众人物蒸馏思维框架\n- [awesome-persona-distill-skills](https://github.com/xixu-me/awesome-persona-distill-skills) — Persona Skill 合集\n\n---\n\n## 免责声明\n\n本项目基于传统堪舆学理论，仅供学习、参考与文化探讨。风水为辅，人为为主。重大居住与人生决策请结合实际情况综合考量，勿作为唯一依据。\n",
  "bytes": 3718,
  "sha": "e1a4c926575015dba8a988294103480eeaf33b89462ecced1c5b067820c755cd",
  "repo_slug": "voidforall/fengshui.skill",
  "fonte": "repo",
  "truncated": false,
  "api": "https://api.agentalog.com/api/listings/skl_voidforall_fengshui_skill_fengshui_maste_bcbf430e/readme"
}