# Ganzhi Basics

> 干支基础子技能。用于天干地支推算、六十甲子查询、节气与五运六气关系映射。适用于中医运气学说入门学习与年份干支快速查询。触发词：干支、天干、地支、六十甲子、干支纪年、节气运气、ganzhi。

- Skill: `dhicoc/ganzhi-basics` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add dhicoc/ganzhi-basics`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dhicoc/ganzhi-basics/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: dhicoc (https://skillmd.com/u/dhicoc)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/dhicoc/ganzhi-basics

---


# 干支基础（天干地支推算与节气运气映射）

## 适用范围

- 学生入门：学习天干地支基本概念与纪年方法
- 年份干支快速查询：公历年份转换为干支
- 六十甲子表查阅：确认甲子序列与对应年份
- 节气与六气交司关系：确定某节气所处之气与运
- 节气与五运交司关系：确定某节气所处之运
- 为下游运气推算子技能提供干支基础数据

## 脚本依赖

| 脚本名称 | 功能说明 | 输入 | 输出 |
|---------|---------|------|------|
| `calculate_yunqi_api.py` | 公历年份→天干地支（统一推算引擎） | 年份（整数，如2024） | 天干、地支、完整干支（如"甲辰"）、甲子序号（year_gz / sexagenary_index） |

## 推荐工作流

1. **ACT: 接收用户请求**，明确需要查询的公历年份或干支。若用户仅提供干支（如"甲辰"），需反推年份范围。
2. **ACT: 调用 `calculate_yunqi_api.py`**，传入年份参数，获取该年的天干、地支、完整干支及甲子序号。命令示例：`python scripts/calculate_yunqi_api.py 2024 --json`
3. **ACT: 查阅六十甲子表**（参考文件 `references/liushijiazi.md`），确认该干支在六十甲子中的序号位置，并关联该甲子年的大运与司天在泉信息。
4. **ACT: 查阅节气对应表**（参考文件 `references/jieqi.md`），确定当前或目标节气所处的六气步位（初之气至终之气）与五运步位（初运至终运）。
5. **ACT: 查阅天干地支基础理论**（参考文件 `references/tiangan_dizhi.md`），根据天干确定中运（大运）五行属性，根据地支确定司天在泉六气。
6. **ACT: 汇总输出**，将干支信息、甲子序号、大运、六气格局、节气运气交司关系整理为结构化结果，传递给下游子技能。

## 常见误区

| 问题 | 原因 | 解决方案 |
|------|------|----------|
| 年份干支算错 | 公历年份与农历年份混淆，或未注意立春为干支年分界 | 以公历年份为准，但需注意：立春（约2月4日）之前仍属上一年干支。脚本输入公历年份，输出该年立春后的干支 |
| 天干地支阴阳配错 | 误以为天干地支可任意配对 | 阳干配阳支，阴干配阴支。甲丙戊庚壬配子寅辰午申戌，乙丁己辛癸配丑卯巳未酉亥 |
| 六十甲子序号算错 | 未从甲子（序号1）开始计数，或误将癸亥（序号60）后接甲子 | 六十甲子从甲子（1）始，至癸亥（60）止，循环往复。用脚本计算确保准确 |
| 节气六气交司时间弄错 | 误将节气与六气的对应关系搞混 | 严格参照 `references/jieqi.md` 中的交司表。初之气从大寒始，非立春 |
| 大运五行属性取错 | 天干化运与天干本身五行属性混淆 | 大运用"天干化运"（甲己化土、乙庚化金、丙辛化水、丁壬化木、戊癸化火），非天干本身五行 |

## 输出要求

- 干支推算结果须包含：公历年份、天干、地支、完整干支、甲子序号
- 须标注推算所用脚本名称与版本
- 须注明立春分界提示（若查询日期在立春前后）
- 节气运气交司结果须标注出处（参考文件名）
- 所有五行六气术语须使用标准中医运气学说术语

## 路由上下文

- **上游入口**：用户直接请求干支查询；或由五运六气主技能路由进入
- **下游出口**：将干支、甲子序号、大运、六气格局传递给 `yunqi-classics`（经典文献验证）和 `docs-generator`（报告生成）
- **同级关联**：与 `yunqi-classics` 同级，均为五运六气技能包的子技能

---

## ACTION REQUIRED

- [ ] 确认 `calculate_yunqi_api.py` 脚本可用且路径正确
- [ ] 确认参考文件 `references/tiangan_dizhi.md`、`references/liushijiazi.md`、`references/jieqi.md` 均存在且内容完整
- [ ] 运行脚本验证至少3个已知年份（如2024甲辰、2025乙巳、2026丙午）
- [ ] 确认输出格式符合下游子技能的输入要求

---

## 任务完成自检

- [ ] 天干地支推算结果正确（与已知年份对照验证）
- [ ] 六十甲子序号与参考表一致
- [ ] 节气与六气交司关系正确引用
- [ ] 节气与五运交司关系正确引用
- [ ] 立春分界提示已包含（如适用）
- [ ] 推算脚本名称已标注
- [ ] 输出已结构化，可被下游子技能解析