Add BaZi translation skill

2026-06-03 18:17:37 +08:00
commit 926acb0fe8
8 changed files with 671 additions and 0 deletions
@@ -0,0 +1,44 @@
+---
+name: bazi-translation
+description: Simplified-Chinese-first BaZi/Four Pillars terminology dictionary and code naming review workflow. Use when translating Chinese BaZi, Four Pillars, Chinese metaphysics, destiny analysis, Heavenly Stem/Earthly Branch, Ten Gods, Five Factors, luck cycle, or favorable-element terms into English; naming code identifiers, classes, files, API fields, database columns, UI labels, or documentation; or reviewing code for inconsistent or literal translations such as dayOwner, skyStem, groundBranch, fortuneColumn, useGod, or mixed BaZi vocabulary.
+---
+
+# BaZi Translation
+
+## Overview
+
+Use this skill to keep BaZi terminology readable and consistent across code, UI labels, comments, docs, schemas, and tests.
+
+The source of truth is simplified Chinese first. Use the approved English display term for user-facing text, and use the approved ASCII code name for identifiers unless an existing project convention is stronger.
+
+## Workflow
+
+1. Read `references/terms.md` when translating or naming a BaZi concept.
+2. Read `references/naming-rules.md` before reviewing code, schemas, APIs, or file names.
+3. Run the checker when a local path is available:
+
+```bash
+python ~/.codex/skills/bazi-translation/scripts/check_bazi_names.py <path>
+```
+
+Use `--no-fail` for exploratory review and `--list-approved` to print approved code names.
+
+4. Report naming findings as concrete replacements: current name, approved name, reason, and file/line when available.
+5. When a concept is not in `terms.md`, do not invent a final translation. Add or propose a row in `references/pending-terms.md` with context and a provisional English/code name.
+
+## Standards
+
+- Treat simplified Chinese as the primary key. Keep traditional Chinese and pinyin as aliases.
+- Preserve book-style English for display labels when known, for example `Favourable Element`.
+- Use project-local spelling for code when already established. If there is no project convention, default to American spelling in identifiers, for example `favorableElement`.
+- Prefer established BaZi terms over literal translation: `Day Master`, `Heavenly Stem`, `Earthly Branch`, `Luck Pillar`.
+- Keep Chinese, English display text, and code names separate. Do not force one field to serve all audiences.
+- Do not conflate `用神` (`Useful God`, advanced concept) with `喜用元素` or `有利元素` (`Favourable Element`, beginner balancing element).
+- Do not translate classical terms word by word when the approved table has a domain term.
+
+## Resources
+
+- `references/terms.md`: approved simplified-Chinese-first dictionary.
+- `references/naming-rules.md`: code naming rules, anti-patterns, and review checklist.
+- `references/pending-terms.md`: staging area for terms needing domain review.
+- `scripts/check_bazi_names.py`: scans source files for forbidden or suspicious BaZi translations and suggests approved names.