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:

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:

python ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py ~/.codex/skills/bazi-translation

Use In Codex

Invoke the skill by name:

Use $bazi-translation to review BaZi naming in src/bazi.

Typical requests:

Use $bazi-translation to translate these terms into approved English and code names: 日主, 天干, 地支, 大运, 用神.

Use $bazi-translation to review API field names in packages/bazi.

Use The Checker

Run the local checker against files or directories:

python ~/.codex/skills/bazi-translation/scripts/check_bazi_names.py <path>

Exploratory review without failing the command:

python ~/.codex/skills/bazi-translation/scripts/check_bazi_names.py <path> --no-fail

List approved code names:

python ~/.codex/skills/bazi-translation/scripts/check_bazi_names.py --list-approved

Example output:

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.

2.4 KiB Raw Permalink Blame History