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,91 @@
+# bazi_translation
+
+Codex skill for BaZi translation and naming review. It keeps BaZi/Four Pillars terms consistent across Chinese source terms, English display labels, and code identifiers.
+
+The skill is simplified-Chinese-first:
+
+- `简体` is the concept key.
+- `标准英文` is for UI/docs when an English label is needed.
+- `代码名` is for identifiers, API fields, classes, schemas, and tests.
+
+The source PDF is not included in this repository.
+
+## Install
+
+Clone the repository and copy it into Codex skills:
+
+```bash
+git clone git@git.aplexlogic.com:fireparty/bazi_translation.git
+mkdir -p ~/.codex/skills
+rsync -a --delete bazi_translation/ ~/.codex/skills/bazi-translation/
+```
+
+Validate the skill:
+
+```bash
+python ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py ~/.codex/skills/bazi-translation
+```
+
+## Use In Codex
+
+Invoke the skill by name:
+
+```text
+Use $bazi-translation to review BaZi naming in src/bazi.
+```
+
+Typical requests:
+
+```text
+Use $bazi-translation to translate these terms into approved English and code names: 日主, 天干, 地支, 大运, 用神.
+```
+
+```text
+Use $bazi-translation to review API field names in packages/bazi.
+```
+
+## Use The Checker
+
+Run the local checker against files or directories:
+
+```bash
+python ~/.codex/skills/bazi-translation/scripts/check_bazi_names.py <path>
+```
+
+Exploratory review without failing the command:
+
+```bash
+python ~/.codex/skills/bazi-translation/scripts/check_bazi_names.py <path> --no-fail
+```
+
+List approved code names:
+
+```bash
+python ~/.codex/skills/bazi-translation/scripts/check_bazi_names.py --list-approved
+```
+
+Example output:
+
+```text
+src/chart.ts:42: dayOwner -> dayMaster
+  zh: 日主; standard_en: Day Master
+  line: const dayOwner = chart.dayOwner;
+```
+
+## Core Naming Rules
+
+- Use `dayMaster`, not `dayOwner` or `dayLord`.
+- Use `heavenlyStem`, not `skyStem`.
+- Use `earthlyBranch`, not `groundBranch`.
+- Use `luckPillar`, not `fortuneColumn`.
+- Use `usefulGod`, not `useGod`.
+- Use `favorableElement` in code by default; keep `Favourable Element` for book-style display text.
+- Keep `Useful God` separate from `Favourable Element`.
+
+## Files
+
+- `SKILL.md`: Codex skill trigger and workflow.
+- `references/terms.md`: simplified-Chinese-first dictionary.
+- `references/naming-rules.md`: review rules and anti-patterns.
+- `references/pending-terms.md`: staging area for terms needing domain review.
+- `scripts/check_bazi_names.py`: source-code naming checker.