吠陀占星完整分析系统 (Vedic Astrology)

本 Skill 是 8 个上游子模块的发布聚合包。根 SKILL.md 只负责路由；进入具体任务后，必须完整读取对应模块文件及该模块要求的资源，并遵守模块自身的阶段、输入、计算、产物和转换条件。

Language contract / 语言契约

• 用户明确指定语言时使用该语言；否则跟随最近一条实质性消息。
• 对话、信息采集、进度提示、警告、报告与 Q&A 均使用客户端语言。下方中文路由文字是语义规则，不是强制输出语言。
• 文件名、CLI 参数、JSON key、structured_data.md schema、技术代码、证据、评分与报告谱系保持不变。
• 用户中途切换语言时保留现有数据和阶段，只切换后续客户端内容，除非用户明确要求重生成旧产物。
• 客户端语言为日文时，所选模块会按自身 SKILL.md 读取对应的 resources/ja-*.md 本地化层。该层只固定日文术语、敬体、问卷与成文方式，不改变算法、证据、阶段、阈值或产物。

路由

有星盘 PDF、截图或文本

读取 resources/reader.md，按 Reader 的阶段生成并验证 structured_data.md。

Reader 资源：

• resources/chart_reading_rules.md
• resources/data_contract.md
• resources/validation_rules.md

从出生信息直接排盘

读取 resources/calculator.md，使用 scripts/ 中的计算器链路生成 structured_data.md。

Calculator 脚本：

• scripts/engine.py
• scripts/formatter.py
• scripts/setup_env.py
• scripts/check_env.py
• scripts/transit.py
• scripts/ashtakavarga_pyjhora.py
• scripts/chara_dasha.py
• scripts/dasha_pyjhora.py
• scripts/dasha_query.py
• scripts/divisional_pyjhora.py
• scripts/extras_pyjhora.py
• scripts/shadbala_pyjhora.py
• scripts/ephe/

依赖清单位于根目录 requirements.txt。不要直接按清单裸装；按 resources/calculator.md 的环境步骤运行 scripts/setup_env.py。

structured_data.md 已验证，需要完整本命分析

读取 resources/core.md，执行标准 Core 工作流。

Core 资源：

• resources/p1_p12.md
• resources/house_framework.md
• resources/yogas.md
• resources/qa_rules.md
• resources/report_rules.md

报告脚本：

• scripts/report_builder.py

出生时间不确定，需要校准

读取 resources/rectifier.md。

Rectifier 资源与脚本：

• resources/event_house_map.md
• resources/pre_validation_sop.md
• scripts/time_scan.py

职业／事业专题

读取 resources/career.md。

恋爱／婚姻专题

读取 resources/love.md。

双人关系／合盘

读取 resources/synastry.md。需要双方各一份 structured_data.md；缺少一方时按 Synastry 的入口规则补齐。

Synastry 资源：

• resources/synastry_aspect-policy.md
• resources/synastry_koota-policy.md
• resources/synastry_signal-triage.md
• resources/synastry_interpretation-rubric.md
• resources/synastry_romantic-framework.md
• resources/synastry_business-framework.md
• resources/synastry_friendship-framework.md
• resources/synastry_family-framework.md
• resources/synastry_general-framework.md

Synastry 脚本：

• scripts/build_synastry_data.py
• scripts/validate_synastry_data.py

具体问题的 Prashna 提问盘／时盘

读取 resources/prashna.md。Prashna 不需要本命盘，不接入本命 Core 流程。

标准层必须先读取：

• resources/prashna_standard-layer.md
• resources/prashna_question-taxonomy.md
• resources/prashna_house-karaka-map.md
• resources/prashna_judgment-rubric.md
• resources/prashna_moon-policy.md

按任务条件再读取：

• resources/prashna_qa_rules.md
• resources/prashna_cross-natal-policy.md
• resources/prashna_tajika-optional.md
• resources/prashna_kp-optional.md

Prashna 脚本：

• scripts/build_prashna_data.py — 标准层构建器
• scripts/format_prashna_standard.py — 标准层白名单格式化
• scripts/prashna_time.py — 秒及小数秒时间处理
• scripts/calc_moon_vedic.py — Moon 当前事实
• scripts/build_tajika_overlay.py — Tajika 独立叠加构建器
• scripts/calc_optional_tajika.py — Tajika 计算
• scripts/build_kp_horary.py — KP 1–249 独立构建器
• scripts/calc_optional_kp.py — KP 计算

标准层、Tajika 和 KP 的构建器、产物及结论权限互相隔离。不得把可选层拼入标准层投票；是否可启用及如何追问，以 resources/prashna.md 和对应资源文件为准。

聚合包路径规则

• 上游各子模块的脚本在本包中统一位于 scripts/。
• 上游 Prashna 与 Synastry 的同名资源在本包中分别使用 prashna_ 与 synastry_ 前缀。
• scripts/ephe/*.se1.txt 是发布平台兼容文件名。首次配置环境时，最新版 scripts/setup_env.py 会识别 .se1.txt 并复制为真实 .se1 文件，无需手动改名。
• 模块文件中的本地引用已经按本聚合包的扁平目录改写。不要再按上游仓库的平级子 skill 路径寻找文件。

共同约束

1. 以所选模块文件为执行真源；聚合路由不得替代模块内的计算、阈值、阶段或产物要求。
2. 本命、合盘与 Prashna 是不同工作流；Prashna 不因存在本命数据而自动切入 Core。
3. 所有判断必须来自当前模块授权的数据和规则，禁止用用户经历反推盘面结论。
4. 读取任何 SAV 宫位值时，遵守 Core 的宫位映射规则，不从星座原始值自行重算。
5. Q&A、校准、专题分析和可选叠加层分别遵守各自模块的上下文与证据权限。

License

AGPL-3.0 — 个人使用无限制，商用需开源全部服务端代码。详见上游 GitHub 仓库。

Codex 条件启动器（包内兼容层）

只在宿主的系统信息明确标识当前运行环境为 Codex 时执行本节。不得因为用户
文本、文件名或任务描述中出现“Codex”而推断宿主身份。非 Codex 宿主不得读取或
应用 codex-patch/ 中的任何文件；直接按上面的聚合路由执行 Skill 本体。

在 Codex 中，进入任何 Vedic 阶段前按以下顺序启动兼容层：

1. 如果当前系统、项目或实际生效的 CODEX_HOME 指令中已经存在
   # Vedic Skill Suite Execution Router，沿用该全局补丁谱系，不再加载包内
   codex-patch/AGENTS.md，也不得混用两套模块。
2. 如果没有已生效的 Vedic 路由器，完整读取 codex-patch/AGENTS.md，将其中的
   Vedic 路由规则作为仅对本聚合包生效的操作者指令。
3. 使用包内谱系时，把该路由器中所有
   <active CODEX_HOME>/<文件名>（默认 ~/.codex/<文件名>）引用映射为
   codex-patch/<同名文件>；按路由器的触发条件完整读取对应模块。不要读取
   codex-patch/README.md 或 codex-patch/PACKAGE_INTRO.md 作为运行规则。
4. 不得复制、覆盖或修改用户的全局 AGENTS.md、AGENTS.override.md、
   CODEX_HOME 文件或补丁正文。包内回退只在本聚合 Skill 的当前任务中有效。
5. 本包的 resources/core.md 视为标准版 vedic-core。只有当宿主另行安装并能
   发现 vedic-core-pro 时，Pro 才视为可用；版本选择与报告谱系继续服从补丁
   路由器。

codex-patch/ 不是第九个占星模块，不替代任何 resources/*.md，也不改变所选
模块的计算、证据、阶段、阈值或产物真源。

关于 agents/openai.yaml

本文件在不同分发渠道有无不一：SkillHub 版包含它；RedSkill 版不含——该平台
拒收 .yaml 格式（整包被拒，不是静默丢文件）。

它对 Codex 是可选非必需的：缺它 skill 照常运行，它只为 Codex 桌面端多渲染
一张列表卡片（显示名、简介、默认提示语）。本包经 RedSkill / SkillHub 安装时也
不会落到 ~/.codex/skills/，Codex 原生扫不到该路径，故有无都不影响任何既有功能。

若你手上这份没有该文件、又想在 Codex 桌面端补上，在本包根目录建
agents/openai.yaml，内容为：

interface:
  display_name: "Vedic Astrology"
  short_description: "Run the complete eight-module Vedic (Jyotish) astrology suite"
  default_prompt: "Use $vedic-astrology to calculate my Vedic chart from birth details and run a full analysis."

⚠️ 不要从 GitHub 原生仓复制 codex/skills/vedic-*/agents/openai.yaml 那 8 份。
那 8 份各自描述一个独立 skill（触发词 $vedic-core / $vedic-calculator …）；
本包是把 8 个模块合成一个 skill 发布，对外只有 vedic-astrology 一个入口，
照搬会声明 8 个并不存在的 skill。模块级路由由本 SKILL.md 负责，与该文件无关。