ziwei-iztro-reader
Ziwei Doushu charting and layered interpretation engine. Analyzes natal, yearly, monthly, and daily horoscopes using structured data, offering systematic, evidence-based astrological insights.
Introduction
Ziwei Iztro Reader is a specialized software agent skill designed for precise Ziwei Doushu (Purple Star Astrology) charting and automated interpretation. It bridges the gap between raw astrological calculations and meaningful, layered life analysis. The tool is intended for users seeking rigorous, structured insights into their natal charts, as well as those looking for predictive analysis across yearly, monthly, and daily cycles. It enforces a strict evidence-based approach, ensuring that all conclusions are derived directly from the underlying chart mechanics rather than vague generalizations.
-
Automated Charting: Utilizes the iztro engine to generate precise natal charts based on birth date, time, location, and gender.
-
Layered Interpretation: Provides a logical flow from natal analysis to yearly, monthly, and daily predictions, ensuring that each layer respects the foundational natal structure.
-
Evidence-Based Reasoning: Requires clear links between star configurations, palace domains, and specific 'mutagen' (four transformations) tags to validate each interpretive conclusion.
-
Future Trend Analysis: Enables forward-looking trend assessment using futureDetailed snapshots for strategic planning and decision support.
-
Standardized Data Handling: Enforces strict input validation and timestamp protocols, including solar/lunar calendar conversions and localized timezone handling.
-
Users must provide accurate birth information; the system will halt and report missing fields if data is incomplete.
-
Outputs prioritize full-depth detailed reporting over brief summaries to ensure comprehensive coverage of all 12 palaces.
-
Interpretations follow strict hierarchy rules, preventing cross-layer attribution errors.
-
The tool is designed for research, cultural study, and entertainment, and excludes真太阳时 (true solar time) corrections by default to maintain algorithmic consistency.
-
Inputs expected include JSON structured schemas; outputs provide detailed object-oriented astrology data, including stars, minor auxiliary stars, and various Shen (deity) indicators.
Repository Stats
- Stars
- 0
- Forks
- 0
- Open Issues
- 0
- Language
- TypeScript
- Default Branch
- main
- Sync Status
- Idle
- Last Synced
- May 4, 2026, 12:23 AM