前言¶
本命盘需要准确的行星位置、轮图绘制，以及可读的占星解读。若把这些步骤拆成查表、画图和写说明，对话式 Agent 往往缺少统一流程，回答也容易前后不一致。SkillHub 上的社区 Skill「星盘」（@user_5fed1d94/astrology-chart）把触发条件、能力与用法写进 SKILL.md，让 Agent 在用户提出占星相关需求时按同一套路径处理。下面介绍它是什么、能做什么，以及如何安装与使用。
这是什么¶
「星盘」是 SkillHub 社区来源（community）的 life-service 类 Skill，当前版本 v1.0.2，由发布者 user_5fed1d94 维护。官方坐标为 @user_5fed1d94/astrology-chart；Skill 页面与 API 入口分别为：
- SkillHub：https://www.skillhub.cn/skills/user_5fed1d94/astrology-chart
- API：https://api.skillhub.cn/user_5fed1d94/astrology-chart
页面标注 requires_api_key=false，安装后一般不需要额外配置 API Key。SkillHub 上该 Skill 评分为 100000，下载 1773 次（统计以页面展示为准）。
一句话定位：当用户要生成或分析占星出生图（本命盘）时启用；支持计算行星位置、绘制星盘轮图并提供占星解读。
核心功能¶
依据官方简介，已核实的能力包括：
- 行星位置计算：为本命盘提供天文/占星计算基础。
- 星盘轮图绘制：输出可视化的星盘轮图，便于对照宫位与行星分布。
- 占星解读：在盘图与位置信息之上给出文字向的解读说明。
Agent 侧常见触发表述（官方列出）：astrology chart、birth chart、natal chart、horoscope、star chart，以及中文 星盘、星座盘、占星。
安装与启用¶
安装前确认本机已有 SkillHub CLI；若没有，可先按官方安装文档检查版本或执行安装脚本。
command -v skillhub && skillhub --version
未安装时可使用 SkillHub 文档中的推荐方式（完整安装 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装「星盘」时，必须用 --dir 指向当前 Agent 实际读取的 skills 目录；装到错误路径时 Agent 不会加载该 Skill。SkillHub 文档给出的常用路径如下，按你当前使用的客户端择一：
| 客户端 | skills 目录（示例） |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
在对应目录下执行安装（坐标与 SkillHub 页面一致）：
skillhub install @user_5fed1d94/astrology-chart --dir ~/.cursor/skills/
若你使用 Claude Code 或 Codex，将 --dir 换成上表中该环境的路径即可，命令其余部分相同。
另一种方式是把 SkillHub 页面提供的提示词发给 AI，由 Agent 按安装文档拉取 Skill：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_5fed1d94/astrology-chart`。
安装完成后，按你所用 Agent 的说明重启或刷新 skills 加载（SkillHub 安装文档提示：未装到正确目录时即使执行安装也可能需要重启后才生效）。
典型用法¶
官方未在抓取资料中附带独立 CLI 子命令示例；用法以对话触发 + Skill 内指引为主。可与 Agent 自然语言交互，并带上简介中的关键词，例如：
帮我用星盘看一下本命盘：出生日期 1990-05-01，时间 14:30，地点北京。需要行星位置和轮图，并做简要占星解读。
或英文触发：
Generate a natal chart (birth chart) with planet positions, a star chart wheel, and a short horoscope-style interpretation for my birth data: ...
实际计算精度、宫位制、输出格式等细节以安装后 Agent 加载的 SKILL.md 为准；若 Agent 追问出生时间、地点或时区，按 Skill 要求补全即可。
适用场景与注意¶
适合谁
- 希望在 Cursor、Claude Code、Codex 等支持 Skills 的环境里，用统一流程做本命盘生成与解读的用户。
- 需要中英文关键词都能触发、且不想自建占星计算与绘图链路的场景。
限制与注意
- 来源为社区 Skill，解读风格与占星体系以 Skill 作者定义为准，不宜替代专业咨询或医疗、法律等正式判断。
- 本命盘对出生时间、地点、时区敏感；信息不全时结果仅供参考。
- 安装统计中的「安装 0」与「下载 1773」并存，可能反映统计口径或用户手动拷贝 Skill；以你本机
skillhub install是否成功、Agent 是否识别为准。 - 占星内容为娱乐与自我探索向工具，使用时应明确其非科学验证结论。
结尾¶
「星盘」把本命盘的计算、轮图与解读收敛到一个 Agent Skill，通过 natal chart、星盘 等关键词即可触发，且无需 API Key。若你正在 SkillHub 上找 life-service 类占星能力，可直接从官方页面安装 v1.0.2 的 @user_5fed1d94/astrology-chart：
https://www.skillhub.cn/skills/user_5fed1d94/astrology-chart
