skills: move translation skills to ./skills/, symlink from ~/.hermes/skills/

pptx-translate, chinese-text-normalize, dharma-translation: canonical location now ./skills/ with symlinks in ~/.hermes/skills/. translation-review: merged CSV/XLSX review + .dj comparison workflows into single SKILL.md. Added buddhist-terminology.md and terms-db-alignment.md references from Hermes version.
2026-06-09 19:46:23 +08:00
parent 10c449f4d9
commit 7e8ba4b291
9 changed files with 693 additions and 51 deletions
@@ -0,0 +1,47 @@
+# Buddhist Text Translation — Terminology
+
+Terms encountered in Chinese-English translation of Dharma study materials. These may vary by translator/context; document actual usage per-project.
+
+## Section headers (common triad)
+
+| Chinese | English options seen | Notes |
+|---------|---------------------|-------|
+| 法义 | Understanding, Dharma Teachings | |
+| 思考 | Contemplation, Reflection | Consistency within a document matters more than which word |
+| 练习 | Practice, Application, Exercises | "Application" seen as section header; "Practice"/"Exercise" in running text |
+
+## Key Buddhist terms
+
+| Chinese | English | Pitfalls |
+|---------|---------|----------|
+| 慈经 | Metta Sutta (Karaniya Metta Sutta) | NOT "Mettavihari Sutta" |
+| 回向 | Dedication (of merit) | |
+| 因缘之网 | Web of Causes and Conditions | Also "Network of Causes and Conditions" |
+| 感恩 | Gratitude | |
+| 众生 | sentient beings | Consistent throughout |
+| 使人内心调柔 | makes one's heart gentle | 使人 = makes ONE(self), never "makes others" |
+| 利益思维 | benefit-oriented thinking | NOT "mindset of benefiting others" — it's about considering benefits TO oneself |
+| 恩田 | field of gratitude / gratitude as a field of merit | |
+| 观照 | attend to the mind / mindful observation | Contemplative practice, not intellectual study. NOT "observe" (passive) or "study" (analytical). |
+| 闻思修 | hearing, contemplating, cultivating | 修 = broad cultivation/practice, not specifically 禅 (meditation). Distinct from 禅修 (meditative cultivation). |
+| 八步三禅 | Eight Steps and Three Meditations | Community-specific structured contemplative method |
+| 传帮带 | transmit, help, guide (three-part mentoring) | Core community methodology |
+| 分灯 | lamp-dividing (decentralization) | Deliberate decentralization of authority across nodes |
+| 自觉 | self-awareness, voluntary commitment | First of the "Three Spirits" |
+| 法治 | rule-based governance | Second of the "Three Spirits" |
+| 无我利他 | selfless service to others | Third of the "Three Spirits" |
+| 凡夫心 | ordinary mind | Mind governed by afflictions, contrasted with awakened mind |
+| 贪嗔痴 | greed, anger, ignorance (三毒) | The three root poisons: rāga, dveṣa, moha |
+| 愿心 | mind of vows, bodhicitta aspiration | Plural "vows" in English |
+| 重要感、优越感、主宰欲 | sense of importance, superiority, desire to control | Three ego-driven motivations |
+
+## Structural patterns
+
+- Section numbering: Chinese uses 一、二、三... English should pick one style (Part One/Two, First/Second, I/II) and stick with it.
+- Poetry/prayer blocks: Chinese uses parallel structures (感恩... 感恩...; 愿... 愿...). English must match the parallelism.
+- 愿 (yuàn) at sentence start = optative "May..." — not "we hope that", not "we should".
+
+## Formatting artifacts
+
+- Stray spaces between Chinese characters (eg. `感 恩 研 究`) are justified-text paste artifacts from the source document — remove them.
+- `<!-- === Progress : Below are unprocessed === -->` is a processing marker — remove from final file.
@@ -0,0 +1,61 @@
+# Terms Database Alignment
+
+Batch-align translation glossary entries and body text against the MPI terms database.
+
+## Setup
+
+Start the HTTP API server if not running:
+```
+python3 /home/user/documents/mpi/terms-search/server.py &
+```
+Server listens on port 8910.
+
+## Batch lookup pattern
+
+Use Python via execute_code to query the API for multiple terms:
+
+```python
+import urllib.request, json, urllib.parse
+
+terms = ["三无漏学", "八步三禅", "闻思修", ...]
+
+for term in terms:
+    q = urllib.parse.quote(term)
+    resp = urllib.request.urlopen(f"http://localhost:8910/search?q={q}&limit=5", timeout=10)
+    data = json.loads(resp.read())
+    # Filter to authoritative sources
+    author_sources = ["DoT定稿", "内部特色词", "佛教术语", "经论名"]
+    relevant = [r for r in data["results"] if r["source"] in author_sources]
+    # Compare against current translation, report mismatches
+```
+
+Or with curl:
+```
+curl -s "http://localhost:8910/search?q=三级修学&limit=5" | python3 -c "import sys,json; ..."
+```
+
+## Priority ranking
+
+When the same term has entries in multiple source tables, prefer:
+1. DoT定稿 (highest authority — final translation decisions)
+2. 内部特色词 (MPI internal terminology)
+3. 佛教术语 (general Buddhist terminology)
+4. 经论名 (sutra/shastra titles)
+
+## Alignment workflow
+
+1. Extract all Chinese glossary terms from `{% "TERM" ... %}` blocks in the .dj file
+2. Extract body-text domain terms that may not have glossary entries
+3. Batch-query each term against the HTTP API
+4. Filter results to authoritative source tables
+5. Compare DB canonical translation against current file translation
+6. Flag mismatches where DB entry differs materially from current
+7. Apply fixes with `patch` tool — fix both glossary comments AND body text occurrences
+8. Verify with `grep` that no old terms remain
+
+## Pitfalls
+
+- `replace_all` can create doubled words when the surrounding context already contains the replacement string (e.g., "The Eight Steps" → "The The Eight Steps"). Prefer targeted single-replacement patches.
+- The `search.py` CLI does not support `src:` or `loc:` filters — use the HTTP API.
+- Start patches from the bottom of the file upward to preserve line numbers.
+- Some DB entries are contextual phrases (e.g., "珍惜法缘" → a full sentence), not standalone term translations. Use standalone term entries where available.