cnwu16/vedic-astro-skills

🔱 Vedic Astro Skills v8.0 从出生信息直接排盘，进入完整吠陀占星分析

Calculate a Vedic chart from birth details and continue directly to full analysis
出生情報から出生図を直接計算し、そのまま総合分析へ

🌐 简体中文 · English documentation · 日本語ドキュメント

---

八个专精 Skill 协同工作：从出生信息直接排盘，到数据校验、完整本命分析、职业、感情、出生时间校准、双人合盘与 Prashna。

兼容 Codex、Claude Code，以及任何读取 Claude Skill 格式的客户端（Antigravity、各类国产 agent 等）；PDF、截图与文本星盘是可选导入方式，不是使用前提。

✨ 这套 Skill 能做什么

这不是一个只负责解释现成 PDF 的提示词集合。多数用户可以直接从出生信息开始：

1. 提供出生日期、准确时间和地点；
2. vedic-calculator 计算完整吠陀星盘；
3. vedic-reader 校验数据、评估时间风险并完成验前事流程；
4. 生成统一的 structured_data.md；
5. 继续进入完整本命分析、职业、感情、出生时间校准或双人合盘。

如果已经有 JHora 或其他占星软件导出的 PDF、截图或文本，也可以直接读取并与计算 结果交叉验证。但文件不是前置条件，从出生信息直接排盘并进入完整分析才是主入口。

主要能力包括：

• 从出生信息直接计算星盘，不依赖外部排盘网站或预先生成的 PDF；
• 统一的结构化数据契约，供全部本命分析模块复用；
• P1-P12 行星审计、分盘交叉、十二宫诊断、十大人生板块和技术附录；
• 职业、关系时机、出生时间校准和四类关系框架的双人合盘；
• 完整 Vimshottari MD/AD/PD 时间线与输入时间稳定性审计；
• 独立的 Prashna 提问时刻盘，不与本命分析混跑；
• 中文、英文、日文的对话、采集、问卷、报告、Q&A 与 HTML 外壳；
• 真源 skills/ 与 Codex、Claude Code 两个发行面保持内容一致。

🔄 整体工作流

flowchart LR
    A["出生日期、准确时间、地点"] --> B["vedic-calculator直接排盘"]
    C["PDF、截图或文本星盘"] --> D["vedic-reader提取与交叉验证"]
    B --> D
    D --> E["已验证的structured_data.md"]
    E --> F["vedic-core标准版完整分析"]
    E --> G["vedic-career职业"]
    E --> H["vedic-love感情"]
    E --> I["vedic-rectifier出生时间校准"]
    E --> J["vedic-synastry双人合盘"]
    K["一个具体问题提问时刻与地点"] --> L["vedic-prashna独立即时盘"]

本命链路共享同一份经过验证的 structured_data.md。vedic-prashna 使用独立的 structured_prashna.md 和判读目录，不需要本命盘，也不会自动调用本命 Dasha、 分盘或 SAV 给提问盘下结论。

🧩 八个 Skill

建议完整安装八个 Skill。实际运行时按任务调用相应模块，不会把所有工作流同时加载。

🔍 各模块详细说明

🧮 技术架构与数据完整性

计算架构

Canonical 数据契约

本命工作流以 structured_data.md 为统一接口。它包含：

• 出生元信息、时区、Ayanamsa 和数据来源；
• 行星、Lagna、Nakshatra、Chara Karaka；
• Shadbala、SAV/BAV、Dignity、Graha Drishti、宫主、AL/UL；
• D1 与关键分盘、Vargottama 和分盘可信度声明；
• 完整 MD/AD/PD 时间线、当前过运与校验结果。

语言切换不会翻译或改写 canonical 文件名、schema 标题、JSON key、CLI 参数、 证据标签、评分、阶段状态或报告谱系。

校验与精度边界

• Reader 的完整规则集执行 16 条数学与结构校验；
• Calc 路径必须得到 9 MD、81 AD、729 PD，并验证各层无断裂、无重叠；
• D1、D9、D10、D4、D5 在出生时间不确定区间内逐分钟重算 Lagna，分别标记稳定、 边界敏感或未审计；
• 输入来源可靠度和分盘数学稳定度分开报告；
• Shadbala 先保存 calc 基准，有同一出生时间的有效 JHora PDF 时才逐行交叉验证；
• 需要月份级判断时必须读取 PD，不能用 AD 或按年比例近似制造月级精度；
• 关键依赖或校验失败时直接停止并给出修复路径，不输出看似完整的错误结果。

仓库在 v6.1 中记录过以下回归样本：

这些是可回查的仓库回归记录，不是对所有地点、时间边界和盘型宣称一个笼统准确率。 因此本版没有恢复旧 README 中无法持续审计的“准确率 >97%”说法。详细历史见 CHANGELOG.md。

📦 安装

建议先克隆仓库，再一次安装全部八个 Skill：

git clone https://github.com/CNWU16/vedic-astro-skills.git

一条命令装好（推荐）

python vedic-astro-skills/skill_sync.py install

自动装到 ~/.claude/skills/（Claude Code）与 ~/.gemini/config/skills/（Antigravity）。 加 --dry-run 只看差异、不写文件。脚本不执行任何 git 操作，且只覆盖与新增、不删除； 本机多出的文件以 [ORPHAN] 列出，确认后加 --prune 才清理。

Codex 请用下一节的手工复制——~/.codex/skills/ 不在自动安装范围，且 Codex 还需配套 安装 codex-patch/。

Codex

cp -r vedic-astro-skills/codex/skills/vedic-* ~/.codex/skills/

codex/skills/ 是八个原生 Skill 引擎。为了获得本仓库推荐的 Codex 执行效果， 还应安装独立的 codex-patch。补丁安装涉及安全合并 AGENTS.md，不要直接覆盖已有全局规则，完整步骤见后文。

Claude Code

cp -r vedic-astro-skills/claude-code/skills/vedic-* ~/.claude/skills/

Claude Code 以各 Skill 的 SKILL.md 为唯一工作流来源，不再维护旧式 .claude/commands 全量副本。

其它读取 Claude Skill 格式的客户端

包括 Antigravity 以及各类国产 agent：把 vedic-astro-skills/skills/ 下的八个 vedic-* 文件夹复制到该客户端实际使用的 Skill 目录即可。skills/ 是发布内容基准， 不含任何平台专属元数据。

Python 环境

支持 Python 3.8～3.13。当前不支持 Python 3.14 运行计算环境，因为 pysweph 是 C 扩展，尚无对应的预编译 wheel。

首次使用先运行诊断：

python3 vedic-astro-skills/skills/vedic-calculator/scripts/check_env.py

如果诊断要求修复环境，再运行：

python3 vedic-astro-skills/skills/vedic-calculator/scripts/setup_env.py

Codex 或 Claude Code 用户也可以把路径换成对应安装目录中的同名脚本。setup_env.py 会选择兼容的 Python、创建隔离环境、按正确顺序安装依赖、补齐星历文件并验证 最小 SAV 计算。

建议走 setup_env.py 而不是直接 pip install -r requirements.txt：星历文件下载、 安装顺序和安装后的 SAV 自检都在脚本里，手工安装容易漏掉星历而静默退回低精度模式。

⚡ 快速开始

从出生信息开始

帮我用吠陀占星直接排盘并做完整分析。
出生日期：1990-01-01
出生时间：08:00
出生地点：北京市，中国
报告使用中文。

计算与 Reader 验证完成后，可以继续说：

用标准版做完整本命分析。

读取已有星盘

上传 JHora PDF、截图或文本，然后说：

读取并验证这份星盘，完成后继续标准版完整分析。

职业与感情

分析我的职业方向、适合的角色和接下来几年的职业时机。

分析我的关系模式、情感需求和可能的关系时间窗口。

出生时间校准

我的出生时间可能不准。请按出生时间校准流程，先告诉我需要准备哪些重大事件。

双人合盘

提供双方的出生信息或两份已验证的 structured_data.md：

比较这两张星盘。先做中性性质平扫，再让我选择关系框架。

Prashna 即时盘

请用 Prashna 判断这个具体问题。
问题：我提交的这个申请能否获批？
提问时间：2026-08-15 14:32:10
提问地点：上海市，中国

Prashna 的问题必须对应一个可观察结果。新对象、新目标或新行动属于新问题，不会 为了获得更满意的结果反复重起同一张盘。

指定英文或日文

Calculate my Vedic chart from these birth details and write the full report in English.

この出生情報からヴェーダ占星術の出生図を作成し、総合鑑定を日本語で書いてください。

🛡 Codex 推荐补丁

Skill 本体可以独立运行。codex-patch 是面向 Codex 的执行兼容层，不改动任何 SKILL.md，也不替代八个 Skill。它主要处理：

• 阶段纪律与必要参考文件的按需读取；
• 用户已知经历与盘面证据的隔离；
• Standard/Pro 报告谱系选择与防混合；
• 完整报告、普通 Q&A、盲问、分析师编辑和 HTML 的产物路由；
• 出生时间校准中的候选结算、反证审计与问题设计；
• 客户正文、十大板块与 QA 的可读性规则。

安装步骤：

1. 先安装八个 vedic-* Skill；
2. 将 codex-patch/AGENTS.md 中从 # Vedic Skill Suite Execution Router 开始的完整段落安全合并到实际生效的 Codex 全局指令；
3. 将 11 个 codex-patch/vedic_*.md 文件复制到实际 CODEX_HOME 根目录；
4. 新建 Codex 任务，确认新规则已经加载。

cp -r vedic-astro-skills/codex-patch/vedic_*.md ~/.codex/

不要用仓库的 AGENTS.md 直接覆盖已有的 ~/.codex/AGENTS.md。如果设置了 CODEX_HOME，或者存在会覆盖全局规则的 AGENTS.override.md，应以实际生效路径 为准。完整安装、更新和卸载说明：

• 中文说明
• English guide
• 日本語ガイド

如果用户另外安装了 vedic-core-pro，不需要第二份补丁；同一补丁会负责 Standard 与 Pro 的选择和报告谱系隔离。公开仓库默认提供的核心引擎是标准版 vedic-core。

🌐 多语言机制

三个语言版本共享同一套计算、证据、评分、阶段与文件契约，不复制三份算法正文。

日文本地化资源只固定术语、敬体、采集措辞、问卷与报告标签，不改变计算、阶段、 证据或结论。report_builder.py 支持 cn/en/ja 三种 HTML 外壳：

python report_builder.py  --name "Name" --lang en
python report_builder.py  --name "山田" --lang ja

语言在运行中切换时，既有数据和报告谱系保持不变，只切换之后的客户端内容。

🗂 仓库结构与更新

vedic-astro-skills/
├── README.md / README.en.md / README.ja.md
├── CHANGELOG.md
├── skills/                    # 发布内容基准（真源）
│   ├── vedic-calculator/
│   ├── vedic-reader/
│   ├── vedic-core/
│   ├── vedic-career/
│   ├── vedic-love/
│   ├── vedic-rectifier/
│   ├── vedic-synastry/
│   └── vedic-prashna/
├── claude-code/skills/        # 与基准逐文件一致
├── codex/skills/              # 额外包含 agents/openai.yaml
├── codex-patch/               # Codex 推荐执行兼容层
├── scripts/check_skill_parity.py
└── assets/

skills/ 是发布内容基准。Claude Code 发行版必须逐文件一致；Codex 只 允许每个 Skill 额外包含一个 agents/openai.yaml。修改或同步后运行：

python3 scripts/check_skill_parity.py

更新本机安装时，先在仓库执行 git pull，再整体复制八个 Skill。Codex 用户还应把 路由器和 11 个模块作为同一个补丁版本更新，避免新旧模块混用，并在更新后新建任务。

📋 版本历史

完整记录和历史口径变更见 CHANGELOG.md。较早版本的说明不一定代表 当前行为，以上方 Unreleased 和当前 SKILL.md 为准。

⚖ 许可与使用边界

本仓库实现传统吠陀占星的结构化计算与分析工作流，适用于文化学习、研究和个人探索。 它不能替代医疗、法律、金融或其他安全关键领域的专业判断。

• 代码采用 AGPL-3.0；
• SKILL.md、提示模板和 resources/、references/ 下的指令文件另有 商用限制；
• 个人、非商业使用可以自由学习和修改；
• 未经书面授权，不得把指令文件用于向第三方提供收费 API、网页服务或商业产品。

☕ 支持项目

如果这套 Skill 对你有帮助，可以通过微信或支付宝支持后续维护：