vedic-astro-skills安装教程:skill_sync.py一条命令装好全部8个占星AI技能

原创2026-10-22 23:42:321,869 阅读

vedic-astro-skills安装教程:skill_sync.py一条命令装好全部8个占星AI技能

vedic-astro-skills 是一款吠陀占星(Vedic / Jyotish)AI 分析工具包,能从出生信息直接排盘并完成本命、职业、感情、双人合盘等完整分析。本教程带你用 skill_sync.py 一条命令装好全部 8 个占星 AI 技能,兼容 Claude Code、Codex、Antigravity 等所有支持 Skill 的平台。

一、vedic-astro-skills 是什么?先认识这 8 个技能

安装前花 30 秒了解你将装到本地的 8 个模块,它们是整套工包的"能力单元":

Skill 干什么用
vedic-calculator 排盘引擎:由出生日期、时间、地点直接计算完整星盘与时间线
vedic-reader 数据校验、16 条校验规则与"验前事"流程
vedic-core 标准版完整本命分析(P1-P12 审计、十大人生板块)
vedic-career 职业方向、生态位与时机
vedic-love 关系模式、情感需求与时间窗口
vedic-rectifier 出生时间校准
vedic-synastry 双人合盘与六维矩阵
vedic-prashna 独立提问时刻盘(即时盘)

建议完整安装八个技能:运行时按任务调用相应模块,不会同时加载全部工作流。各技能说明见 skills/ 目录下对应的 SKILL.md。

二、安装前准备:环境要求与仓库克隆

环境要求很简单:一台装有 Git 的电脑 + Python 3.8~3.13(暂不支持 3.14,因为核心依赖 pysweph 是 C 扩展,尚无对应预编译 wheel)。

先克隆仓库:

git clone https://gitcode.com/gh_mirrors/ve/vedic-astro-skills.git

三、一条命令安装全部8个技能(推荐方式)

进入仓库目录后,执行这一条命令:

python vedic-astro-skills/skill_sync.py install

skill_sync.py 会自动把 8 个技能装到本机:

  • ~/.claude/skills/(Claude Code)
  • ~/.gemini/config/skills/(Antigravity)

关于这条命令的几个安心点

  • 不执行任何 git 操作:脚本只复制文件,不会 commit 或 push;
  • 只覆盖与新增、不删除:本机多出的文件会以 [ORPHAN] 列出,确认无用后加 --prune 才清理;
  • 支持预演:加 --dry-run 只查看差异、不写文件,适合首次安装前检查。
python vedic-astro-skills/skill_sync.py install --dry-run

四、Codex 用户注意:需手工复制

~/.codex/skills/ 不在自动安装范围内,Codex 用户请手工复制:

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

codex/skills/ 是八个原生技能引擎。要获得推荐的 Codex 执行效果,还应配套安装 codex-patch/(全局路由器 + 11 个按需模块),完整步骤见 codex-patch/README.md。注意:不要用仓库的 AGENTS.md 直接覆盖已有的 ~/.codex/AGENTS.md,需按说明安全合并。

五、其它客户端:通用 Skill 格式直接复制

Claude Code 及任何读取 Claude Skill 格式的客户端(Antigravity、各类国产 Agent),把发布基准目录下的 8 个 vedic-* 文件夹复制到客户端实际使用的 Skill 目录即可:

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

skills/ 是发布内容基准,不含任何平台专属元数据;claude-code/skills/ 与其逐文件一致,可运行 scripts/check_skill_parity.py 校验。

六、安装后一步:Python 环境诊断与自动修复

技能装好后,第一次使用前先做环境诊断:

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

check_env.py 会检查依赖是否齐全,并跑一个最小计算验证(SAV=337),输出明确的 ✅/❌ 结果和修复指令。如果诊断要求修复环境,再运行:

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

setup_env.py 会选兼容的 Python、创建隔离环境、按正确顺序装依赖、补齐星历文件(ephe/ 下的三个 .se1 文件),并验证最小 SAV 计算。建议走这个脚本而不是直接 pip install,手工安装容易漏掉星历文件而静默退回低精度模式。

七、验证安装成功:第一次排盘试试

一切就绪后,向你的 AI 客户端发起第一条指令即可验证:

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

若 vedic-calculator 成功算盘、vedic-reader 完成校验,说明 8 个技能已全部就位,可以继续职业、感情、合盘等分析。更多用法示例见 README.md 的"快速开始"章节。

常见问题

Q:更新到新版本怎么办? 在仓库执行 git pull,再跑一次 python skill_sync.py install 即可,脚本会自动比对差异、只写有变化的文件。

Q:装错文件了会怎样? 脚本只增不删,误装的文件会以 [ORPHAN] 提示列出,确认无用后再加 --prune 清理,不会误伤。

Q:这个工包能商用吗? 代码采用 AGPL-3.0,SKILL.md 等指令文件另有商用限制,个人与非商业使用可自由学习和修改,详见 LICENSE。


至此,vedic-astro-skills 安装完成:skill_sync.py install 一条命令装好 8 个占星 AI 技能,环境诊断通过后即可从出生信息直接排盘,进入完整吠陀占星分析。

登录后查看全文
vedic-astro-skills