vedic-astro-skills安装教程:skill_sync.py一条命令装好全部8个占星AI技能
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 技能,环境诊断通过后即可从出生信息直接排盘,进入完整吠陀占星分析。