Ziwei Doushu
Generate a professional Ziwei Doushu reading with a clear split between chart facts, traditional interpretation, and practical trend summaries.
Required Workflow
- Confirm Gregorian birth date, local birth time, gender convention, birthplace, and timezone.
- Convert local birth time to the standard two-hour branch index and record the conversion.
- Install the local dependency once in this Skill directory:
npm install --no-audit --no-fund
- Run the offline engine from this Skill directory:
node scripts/ziwei_engine_js.mjs --date 1990-10-21 --time-index 8 --gender female --year 2026 --anchor-date 2026-01-01
- Preserve the JSON output as the calculation record, then interpret it with the references listed below.
Parameters
--date YYYY-MM-DD: Gregorian birth date.
--time-index 0-11: two-hour branch index; 0 is 子时, 1 is 丑时, through 11 for 亥时.
--gender male|female|男|女: gender convention used by the engine.
--year YYYY: optional target year.
--anchor-date YYYY-MM-DD: required with --year for annual triggers.
Calculation Standard
- Calendar input: Gregorian date.
- Time input: explicit branch index derived from local time.
- Engine: local
iztro JavaScript runtime.
- Output: structured JSON on stdout.
- If daylight saving, timezone, or branch-boundary handling is uncertain, state the uncertainty and calculate alternatives when it can change the result.
Deliverables
Include:
- Calculation standard and normalized inputs.
- Chart facts: 命宫、身宫、十二宫、主星组合、三方四正、四化、大限和流年触发。
- Interpretation framework: robust signals, timing-sensitive areas, and conflicting indicators.
- Practical summary: career, relationships, money, energy management, and current-year focus.
Output Guardrails
- Separate chart facts from traditional interpretation.
- Present conclusions as trends and structures, never deterministic destiny claims.
- Make calculation conventions visible.
- If the engine fails, report the error and stop rather than estimating from memory.
- Do not treat this output as medical, legal, financial, or investment advice.
Optional HTML Visualization
Use the engine JSON to render a standalone responsive HTML file when requested:
- deep blue background
#0a0e2a;
- purple highlight
#a890ff and silver text #e8e4ff;
- transformations: 禄
#ffd66e, 权 #ff8eb8, 科 #6ee0d6, 忌 #b8b4c8;
- put 命、身、大限、流年 badges inline beside palace names;
- never use absolutely positioned badges that can cover text.
HTML visualization is optional and must not gate the textual report.
References
references/mapping.md
references/interpretation-framework.md
1---2name: ziwei-doushu3description: Professional Ziwei Doushu consultation skill with an offline calculation engine. Use for life palace structure, twelve palaces, four transformations, major luck cycles, yearly triggers, and a clear split between chart facts and traditional interpretation.4---56# Ziwei Doushu78Generate a professional Ziwei Doushu reading with a clear split between chart facts, traditional interpretation, and practical trend summaries.910## Required Workflow11121. Confirm Gregorian birth date, local birth time, gender convention, birthplace, and timezone.132. Convert local birth time to the standard two-hour branch index and record the conversion.143. Install the local dependency once in this Skill directory:1516```bash17npm install --no-audit --no-fund18```19204. Run the offline engine from this Skill directory:2122```bash23node scripts/ziwei_engine_js.mjs --date 1990-10-21 --time-index 8 --gender female --year 2026 --anchor-date 2026-01-0124```25265. Preserve the JSON output as the calculation record, then interpret it with the references listed below.2728## Parameters2930- `--date YYYY-MM-DD`: Gregorian birth date.31- `--time-index 0-11`: two-hour branch index; `0` is 子时, `1` is 丑时, through `11` for 亥时.32- `--gender male|female|男|女`: gender convention used by the engine.33- `--year YYYY`: optional target year.34- `--anchor-date YYYY-MM-DD`: required with `--year` for annual triggers.3536## Calculation Standard3738- Calendar input: Gregorian date.39- Time input: explicit branch index derived from local time.40- Engine: local `iztro` JavaScript runtime.41- Output: structured JSON on stdout.42- If daylight saving, timezone, or branch-boundary handling is uncertain, state the uncertainty and calculate alternatives when it can change the result.4344## Deliverables4546Include:47481. Calculation standard and normalized inputs.492. Chart facts: 命宫、身宫、十二宫、主星组合、三方四正、四化、大限和流年触发。503. Interpretation framework: robust signals, timing-sensitive areas, and conflicting indicators.514. Practical summary: career, relationships, money, energy management, and current-year focus.5253## Output Guardrails5455- Separate chart facts from traditional interpretation.56- Present conclusions as trends and structures, never deterministic destiny claims.57- Make calculation conventions visible.58- If the engine fails, report the error and stop rather than estimating from memory.59- Do not treat this output as medical, legal, financial, or investment advice.6061## Optional HTML Visualization6263Use the engine JSON to render a standalone responsive HTML file when requested:6465- deep blue background `#0a0e2a`;66- purple highlight `#a890ff` and silver text `#e8e4ff`;67- transformations: 禄 `#ffd66e`, 权 `#ff8eb8`, 科 `#6ee0d6`, 忌 `#b8b4c8`;68- put 命、身、大限、流年 badges inline beside palace names;69- never use absolutely positioned badges that can cover text.7071HTML visualization is optional and must not gate the textual report.7273## References7475- `references/mapping.md`76- `references/interpretation-framework.md`