++

2026-07-03 20:33:32 +08:00
parent ebfd057e2d
commit 3f5fdadce2
8 changed files with 354 additions and 45 deletions
@@ -1,3 +1,5 @@
 .codegraph/
 .firecrawl/
 .~lock.*
+__pycache__/
+__pypackages__/
@@ -0,0 +1,7 @@
+# MPI Project Instructions
+
+You are working on the Mindful Peace International Chinese-English Buddhist/Dharma translation project.
+- Before translating, load the `translation` and `terms-search` skills.
+- Before reviewing, load `self-review` (and `other-review` for peer review).
+- The agent IS the model: do not call external translation APIs.
+- The workflow is not as rigid as the state machine in AGENTS.md. The user may ask for you to deviate from the default workflow (described by the state machine). Be flexible when asked.
@@ -2,19 +2,7 @@

 ## Skills

-Skills in `skills/`. Loaded via `~/.hermes/config.yaml`:
-
-```yaml
-skills:
-  external_dirs:
-  - $MPI_PROJECT_ROOT/skills
-```
-
-{% `hermes config set` stringifies list values — edit config.yaml directly. %}
-
-When creating a new translation-related skill, use `skill_manage` with a
-`$MPI_PROJECT_ROOT/skills/` path. Do NOT create skills under `~/.hermes/skills/`
-— those are for personal/general skills, not project-specific workflows.
+Skills in `skills/`.

 Available: `translation`, `terms-search`, `self-review`, `other-review`, `chinese-text-normalize`, `pptx-translate`, `pdf-to-docx-conversion`.

@@ -34,13 +22,51 @@ translate-files/<topic>/<article>/
  bilingual.dj   — interleaved (source line, blank, target line, blank)
 ```

-`.docx` output → `/tmp/`. Don't commit binaries.
+Put `.docx` output in `/tmp/`. Don't commit binaries.

 ---

+## Translation State Machine
+
+All translation work follows this deterministic workflow. Non-deterministic LLM work (drafting, reviewing) happens at the edges; the states and transitions are fixed.
+
+```mermaid
+stateDiagram-v2
+    [*] --> idle
+    idle --> translating: SOURCE_LOADED
+    idle --> other_reviewing: BILINGUAL_LOADED
+    translating --> bilingual_ready: TRANSLATION_DRAFTED
+    bilingual_ready --> self_reviewing: BILINGUAL_GENERATED
+    self_reviewing --> translating: SELF_REJECTED
+    self_reviewing --> other_reviewing: SELF_APPROVED [peer review required]
+    self_reviewing --> approved: SELF_APPROVED [no peer review]
+    note right of self_reviewing
+        peer_review_required flag decides the branch
+    end note
+    other_reviewing --> translating: PEER_REJECTED
+    other_reviewing --> approved: PEER_APPROVED
+    approved --> typesetting: TYPESET_REQUESTED
+    approved --> done: COMPLETE
+    typesetting --> done: TYPESET_COMPLETE
+    done --> [*]
+```
+
+States:
+
+| State | Meaning | Output artifact |
+|---|---|---|
+| `idle` | Waiting for source or an existing bilingual file. | — |
+| `translating` | Agent loads `translation` + `terms-search` skills and drafts `target.dj`. | `target.dj` |
+| `bilingual_ready` | `bilingual.dj` generated from `source.dj` + `target.dj`. | `bilingual.dj` |
+| `self_reviewing` | Three-pass review: terminology → mechanical → flow. | `commented.dj`, `translation-findings.dj` |
+| `other_reviewing` | Peer review of someone else's translation. | `review-comments.dj` |
+| `approved` | Translation accepted. May typeset or finish. | — |
+| `typesetting` | Producing PDF/DOCX from approved bilingual content. | `.pdf` / `.docx` |
+| `done` | Complete. | — |
+
 ## Workflow A: Translation（翻译）

-Translate Chinese source into English. The agent IS the model — no external APIs.
+Translate Chinese source into English. The agent IS the model — no external APIs. This workflow covers the state machine path `idle` → `translating` → `bilingual_ready` → `self_reviewing`.

 ### Input

@@ -76,7 +102,7 @@ After translating, run `self-review` skill to check:

 ## Workflow B: Proofread / Review（校对/审阅）

-Two distinct sub-workflows depending on WHO did the translation.
+Two distinct sub-workflows depending on WHO did the translation. Both follow the review portion of the translation state machine (`self_reviewing` and `other_reviewing`).

 ### B1: Self-Review（自审）

@@ -116,27 +142,10 @@ and produces a diff you can review.

 For producing PDFs from bilingual Chinese-English articles:

- Repo / project root: `~/documents/mpi/`
- Template directory (contains `lib/`): `~/documents/mpi/translate-files/`
 - Template: `translate-files/lib/mpi-bilingual-template.typ`
 - Example host: `translate-files/从物品整理到心灵整理/mindful-organizing.typ`
 - Design notes: `references/typst-template-design.md`
-
-Host files should contain only one `#import` and one `#show:` rule; all
-formatting is handled by the template.
-
-Compile with the helper script:
-
-```bash
-~/documents/mpi/scripts/compile-typst.fish ./从物品整理到心灵整理/mindful-organizing.typ [output.pdf]
-```
-
-Or manually from the template directory:
-
-```bash
-cd ~/documents/mpi/translate-files
-typst compile --root . ./从物品整理到心灵整理/mindful-organizing.typ
-```
+- Produce rendered PDF files in: /tmp/

 ## Scripts

@@ -1,6 +1,8 @@
 ---
 name: other-review
 description: Editorial polish for CN→EN Buddhist translations you did NOT translate — voice, flow, readability. Load self-review first for terminology/accuracy.
+inputs: bilingual.dj (or source.dj + target.dj), or Google Doc
+outputs: review-comments.dj
 ---

 {% Serves AGENTS.md Workflow B2 (Other-Review) %}
@@ -486,8 +488,9 @@ Quoted text: `even discarded. Consequently, while countless companies emerged, t
 - **Google Docs anchor limitation**: The Drive API cannot create anchored comments
  on Google Docs. Use Mode B (output to review-comments.dj) for Google Doc targets.
  The user manually inserts comments in the browser UI. See the journey log at
-  `docs/google-docs-comment-journey.dj` for full details.
+  `references/google-docs-comment-journey.dj` for full details.
 - **Quoted text must be exact and unique**: when writing review-comments.dj, each
  quoted snippet must match the document text case-exactly and be long enough to
  find unambiguously with Ctrl+F. Short words like "consequently" are unacceptable
  — quote the full sentence or a 10+ word phrase.
+- **Mine review comments for reusable patterns**: when a review-comments.dj is produced, scan it for recurring calques and Buddhist term register issues and add them to `../self-review/references/translation-pitfalls.md` and `../self-review/references/buddhist-terminology.md`. The *人生百问* review produced a reusable pattern library — follow that example.
@@ -1,6 +1,8 @@
 ---
 name: self-review
 description: Review your own CN→EN translations — three-pass review (terminology → mechanical → flow). Edit commented.dj with patch. For reviewing someone else's work, load other-review.
+inputs: bilingual.dj, or CSV/XLSX (Chinese + English columns)
+outputs: commented.dj, translation-findings.dj (optional)
 ---

 {% Serves AGENTS.md Workflow B1 (Self-Review) %}
@@ -105,6 +107,7 @@ category of error. Don't try to catch everything in one scan.
 **Pass 3 — flow/tonal/calques** (read the whole English as prose):
 - Re-read the full English target. Does it hang together as prose, or does it read as "translationese"?
 - Dramatic verbs that are calques of Chinese: "draw forth," "into full play," "shoulder," "look to with hope." See `references/translation-pitfalls.md` for the full calque checklist.
+- New: review the *人生百问* pattern tables in `translation-pitfalls.md` for stiff calques ("keen on," "wisdom culture," "more ultimate," "choice difficulty," "serve as reference") and idiom renderings ("tree wishing stillness," "straddling two boats").
 - Subject-shift calques: English substitutes a concrete agent (practitioners, people) for an abstract system noun (Buddhism, religion) — see pitfalls.
 - Factual inconsistencies across paired descriptions of the same person/place/thing.
 - Tonal coherence inside parallel lists: verb choice should be identical across First/Second/Third items.
@@ -206,6 +209,7 @@ Do not run extraction pipelines until scope is clear.
 - **Verify patches with `cat`** — `read_file` dedup makes it unreliable
 - **Re-read before fixing** — user may have made interim edits
 - **Batch terminology lookups** — when checking many terms against the terms DB, run them in one `execute_code` script that loops over a query list and calls `search.py` via `subprocess.run`. One terminal call per term floods the context with repetitive output.
+- **Mine review comments for patterns** — when a `review-comments.dj` is produced, scan it for recurring calques and term choices and add them to `references/translation-pitfalls.md` and `references/buddhist-terminology.md` so the skill improves with each review.

 ## Human Review Protocol (审议)

@@ -41,7 +41,92 @@ Terms encountered in Chinese-English translation of Dharma study materials. Thes
 - 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.
+## Terms from 人生百问 review
+
+Terms encountered in the *人生百问* review that deserve explicit guidance.
+These supplement the general table above.
+
+| Chinese | English | Pitfalls / notes |
+|---|---|---|
+| 皈依三宝 | take refuge in the Three Jewels | DoT定稿 preferred. Avoid "take refuge hastily" — use "take refuge lightly" |
+| 三级修学 | Three-Stage Practice | DoT定稿. Not "Three-Level Study Program" |
+| 同喜班 | Tongxi Class | MPI convention; verify if glossary requires translation |
+| 人生佛教 | Buddhism for Human Life | Do not conflate with 人间佛教 / Humanistic Buddhism |
+| 人间佛教 | Humanistic Buddhism | Distinct from 人生佛教 |
+| 善知识 | wise teacher / great teacher / authentic teacher | Avoid redundant "great wise teachers" |
+| 大善知识 | great teacher / wise teacher | Redundant to render as "great wise teacher" |
+| 依止 | reliance / rely on | "reliance relationship" is awkward; prefer "teacher-student relationship" or "rely on" |
+| 报身 | reward body / enjoyment body | Verify target convention; MPI often prefers "reward body" (Skt. *sambhogakāya*) |
+| 化身 | transformation body / emanation body | Verify target convention |
+| 等流果 | result of equal outflow / correlative effect | Avoid ad-hoc "continuative result" |
+| 末法 | Dharma-ending age / Age of Dharma Decline | Check terms DB; avoid new coinages |
+| 暇满 | precious human life / leisure and endowment | "Well-endowed Human Form" is formal |
+| 暇满人身 | precious human body / well-endowed human form | Context-dependent |
+| 定课 | daily practice / fixed chanting session / daily recitation | Context-dependent; check terms DB |
+| 八步骤三种禅修 | Eight Steps and Three Types of Meditation | DoT定稿. Not "Three Kinds of Meditation" |
+| 八步三禅 | Eight Steps and Three Meditations | Shorter form; verify convention |
+| 功德 | merit / virtue | Context-dependent; do not default to "merit and virtue" |
+| 福田 | field of merit / field of blessing | Standard |
+| 止观 | śamatha-vipaśyanā / calm abiding and special insight | In lists: "śamatha-vipaśyanā" |
+| 皈依 | refuge / take refuge | In catalogues: noun form "refuge" |
+| 发心 | bodhicitta / aspiration / arousing the mind | In catalogues: noun form "aspiration" |
+| 戒律 | precepts / moral discipline | In catalogues: noun form "precepts" |
+| 正见 | right view | In catalogues: noun form "right view" |
+| 五戒 | five precepts | Standard |
+| 惑业 | delusion and karma | Not "confusion and karma" |
+| 大自在 | great freedom and ease | "Great freedom" alone loses the "ease" nuance |
+| 开启 | awaken / bring forth / unfold | Not "opened up" |
+| 迷惑 | delusion | In Buddhist contexts, not "confusion" |
+| 凡夫心 | mind of an ordinary being | Avoid Chan "ordinary mind" ambiguity |
+| 加持 | blessing / empowerment | "empowers one another" loses nuance; "supports and blesses one another" |
+| 四力 (忏悔) | four powers (of confession) | Standard: remorse, support, restraint, refuge/reliance |
+| 无缘大慈 | unconditional great compassion | Standard |
+| 同体大悲 | great sympathy of seeing others as oneself | Standard |
+| 人成即佛成 | When a Human Is Perfected, Buddhahood Is Perfected | Standard rendering |
+| 登地菩萨 | bodhisattva who has attained the grounds | Standard |
+| 弟子相 | marks of a disciple | Standard |
+| 自他相换 | exchanging self and others | Standard |
+| 明心见性 | clear the mind and see the nature | "Clear mind and seeing the nature" is slightly off |
+| 言语道断，心行处灭 | Where words fall silent and mental activity ceases | "Words are cut off" is too literal |
+| 无住生心 | arouse the mind without attachment | Standard |
+| 诸法如实相 | true suchness of all phenomena | Standard |
+| 颠倒梦想 | inverted dreams | Standard |
+| 颠倒妄想 | deluded inversion | Standard |
+| 十二因缘 | Twelve Links of Dependent Origination | Standard |
+| 无我 | no-self / anatman | Standard |
+| 我法二执 | attachment to self and dharmas | Standard |
+| 三性 (遍计所执性 / 依他起性 / 圆成实性) | three natures: falsely conceived, dependent, perfectly realized | Standard |
+| 末那 | Manas | Standard (Consciousness-Only) |
+| 阿赖耶 | Alaya | Standard (Consciousness-Only) |
+| 唯识 | Consciousness-Only | Standard |
+| 唯识三十论 | Thirty Verses on Consciousness-Only | Standard |
+| 认识与存在 | Cognition and Existence | Verify if this is a published translation title |
+| 三果 | third fruit / anāgāmi | Standard |
+| 现报 / 生报 / 后报 | reward in this life / next life / future life | "present reward, next-life reward, later reward" is acceptable but less standard |
+| 中观 | Madhyamaka | Standard |
+| 天台 | Tiantai | Standard |
+| 一念三千 | three thousand realms in a single thought | Standard (Tiantai) |
+| 三传 | Theravada / Chinese Buddhism / Tibetan Buddhism | Standard |
+| 南传 | Theravada | Standard |
+| 汉传 | Chinese Buddhism | Standard |
+| 藏传 | Tibetan Buddhism | Standard |
+| 佛陀出世的本怀 | Buddha's original purpose in appearing in the world | Standard |
+| 契理契机 | accordant with principle and adapted to the times | Standard |
+| 正本清源 | return to the source and clarify what is truly central | Standard |
+| 随缘 | responding to conditions / in harmony with conditions | Context-dependent |
+| 随喜 | rejoice | Standard |
+| 善知识 | wise teacher / good teacher / authentic teacher | Avoid "great wise teachers" |
+| 定课 | daily practice / fixed chanting session | Context-dependent |
+
+{% The following terms already appear in the "Key Buddhist terms" table above; they are retained here only when the 人生百问 review adds distinct guidance. %}
+
+| 法义 | Dharma teachings / understanding | Consistency within a document matters |
+| 闻思修 | hearing, contemplating, cultivating | 修 is broad cultivation, not just meditation |
+| 传帮带 | transmit, help, guide | Three-part mentoring |
+| 分灯 | lamp-dividing | Decentralization of authority |
+| 自觉 | 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" |
+| 重要感、优越感、主宰欲 | sense of importance, superiority, desire to control | Three ego-driven motivations |
+
@@ -279,6 +279,163 @@ initial/middle/great scope."

 ### Translating before consulting terms DB

-Always search key terms BEFORE translating. The dharma-translation skill says to do
-this, but it's easy to skip. Use the CLI: `$MPI_PROJECT_ROOT/terms-search/search.py <query>`.
-Prioritize DoT定稿 > 内部特色词 > 佛教术语 > 经论名.
+
+## Patterns from 人生百问 review (self-review findings)
+
+The review of *人生百问* surfaced a set of recurring calques, register
+mismatches, and Buddhist-term choices that keep reappearing in MPI
+CN→EN work. Treat these as a supplemental checklist after the main
+translation-pitfalls list.
+
+### Stiff / formal calques to soften
+
+| Source pattern | Stiff / literal rendering | Smoother options |
+|---|---|---|
+| 热衷于 / 很热衷 | "keen on" | "eager to," "enthusiastically pursuing" |
+| 善用理性 | "use reason skillfully" | "use reason well," "use reason wisely" |
+| 随缘 | "responding to conditions" | "in harmony with conditions" (when it flows better) |
+| 人云亦云 | "serve as reference" | "provide guidance," "serve as a reference" |
+| 引起共鸣 | "arouse resonance" | "resonate," "strike a chord" |
+| 强势而偏执 | "forceful and opinionated" | "forceful and dogmatic," "domineering and inflexible" |
+| 执着外境 | "cling to all sorts of external pursuits" | "cling to all sorts of external conditions" |
+| 一时兴起 | "spur-of-the-moment impulse" | "spur-of-the-moment idea" |
+| 大龄青年 | "older unmarried young people" | "older singles," "unmarried adults" |
+| 更受欢迎 | "more welcome" | "more well-liked," "more welcomed by others" |
+| 想起来很急，做起来又不急 | "feel urgent but do not act urgently" | "urgent in thought but not in deed" |
+| 随大流 / 大众化的 | "popular" | "mass-oriented," "public," "for the general public" |
+| 养生之道 | "wisdom culture" | "wisdom tradition," "culture of wisdom" |
+| 以此作为标准 | "take X as the only standard" | "make X the only standard" (when the sentence is top-heavy) |
+
+### 究竟 / 终极 / 更高层次
+
+| Source | Awkward | Preferred |
+|---|---|---|
+| 更究竟 | "more ultimate" | "more complete," "more profound," "higher" |
+| 更究竟的成功 | "a more ultimate success" | "a more complete success," "a higher success" |
+
+In conversational Q&A, 究竟 often reads better as "complete" or "profound"
+than as the technical "ultimate." Reserve "ultimate" for explicit doctrinal
+discussions of 究竟谛 / ultimate truth.
+
+### Buddhist term register
+
+| Source | Issue | Preferred guidance |
+|---|---|---|
+| 大自在 | "great freedom" loses the "ease" nuance | "great freedom and ease" |
+| 开启智慧 | "opened up boundless wisdom" is odd | "awakened," "brought forth," "unfolded" |
+| 迷惑 (as affliction) | "confusion" is too generic | "delusion" (in Buddhist contexts) |
+| 惑业 | "confusion and karma" | "delusion and karma" (check terms DB) |
+| 善知识 | "great wise teachers" is redundant | "great teachers," "wise teachers," "authentic teachers" |
+| 皈依三宝 | "take refuge hastily" | "take refuge lightly," "take refuge without being ready" |
+| 尽未来际 | "for all future time" is literal | "for all future lives," "throughout all future time" |
+| 患得患失 | "worried about personal gains and losses" | "anxious about gain and loss" |
+|  religious community | vague | "Buddhist community," "Sangha" |
+| 报身 | "enjoyment body" vs "reward body" | Verify target convention; MPI often prefers "reward body" |
+| 化身 | "transformation body" is common | Verify against target convention |
+| 等流果 | "continuative result" | Standard: "result of equal outflow," "correlative effect" |
+| 四力 (忏悔) | "power of eradication / remedy" | Use standard four powers terminology: remorse, support, restraint, refuge/reliance |
+| 末法 | "Dharma-ending age" / "Age of Dharma Decline" | Check terms DB; avoid inventing new renderings |
+| 暇满 | "well-endowed human form" | Standard: "leisure and endowment," "precious human life" |
+| 定课 | "fixed chanting session" | "daily practice," "daily recitation" (context-dependent) |
+| 八步骤三种禅修 | "Eight Steps and Three Kinds of Meditation" | DoT定稿: "Eight Steps and Three Types of Meditation" |
+| 功德 | "merit and virtue" (overused) | "merit" or "virtue" depending on context |
+| 福田 | "field of blessing" | Standard: "field of merit/blessing" |
+| 止观 | "calm abiding and special insight" | Or "śamatha-vipaśyanā"; avoid inventing new compounds |
+| 皈依 / 发心 / 戒律 / 正见 | gerund lists | Noun forms in catalogues: "refuge, aspiration, precepts, right view" |
+| 凡夫心 | "ordinary mind" | "mind of an ordinary being" (avoid Chan "ordinary mind" ambiguity) |
+| 加持 | "empowers one another" | "supports and blesses one another" (retain religious nuance) |
+| 登地菩萨 | "attained the grounds" | Standard rendering |
+| 弟子相 | "marks of a disciple" | Standard rendering |
+| 无缘大慈、同体大悲 | — | "unconditional great compassion and the great sympathy of seeing others as oneself" |
+| 人成即佛成 | — | "When a Human Is Perfected, Buddhahood Is Perfected" |
+| 人生佛教 | — | "Buddhism for Human Life" (do not conflate with 人间佛教 / Humanistic Buddhism) |
+| 三级修学 | — | DoT定稿: "Three-Stage Practice" |
+| 同喜班 | — | "Tongxi Class" (MPI convention; verify if glossary requires translation) |
+
+### Idioms and set phrases
+
+| Source | Literal / awkward | Preferred |
+|---|---|---|
+| 妄念纷飞 / 妄想纷飞 | "delusive thoughts still fly about" / "random thoughts fly about" | "delusions run wild," "wandering thoughts arise" |
+| 望尘莫及 | "outdo animals by far" (wrong direction) | "animals cannot compare," "are left far behind" |
+| 脚踏两条船 / 骑墙 | "straddling two boats" | "riding two boats," "trying to walk two paths" |
+| 选择困难症 | "choice difficulty" | "decision paralysis," "choice paralysis" |
+| 树欲静而风不止 | "the tree wishing stillness while the wind keeps blowing" | "the tree may crave stillness, but the wind will not cease" |
+| 磨刀不误砍柴工 | — | "sharpen the ax before cutting wood" (standard) |
+| 泥菩萨过江 | "clay bodhisattva" | Allude to the idiom; may need explanatory note |
+| 鄙视链 | "contempt chains" | Loan-translation is acceptable; keep if context is clear |
+| 十年浩劫 | "decade of catastrophe" | International readers may need a gloss |
+| 红尘滚滚 | "rolling red dust" | Acceptable in Buddhist register; do not soften |
+| 因上努力，果上随缘 | — | "work hard on the causes and let the results unfold as they may" |
+| 朝不保夕 | "we may not last until evening" | "life is precarious" |
+| 本末倒置 | — | "put the cart before the horse" |
+| 润物细无声 | — | "quiet, pervasive influence, like rain soaking into the earth unnoticed" |
+| 有口无心 | — | "with their mouths but not their hearts" |
+| 人非圣贤，孰能无过 | "To err is human" | Acceptable, but note it loses the Buddhist register |
+| Standard Buddhist idiom | — | Always prefer established English Buddhist idiom when one exists (e.g. Diamond Sutra "lives" not "bodies") |
+
+### Sentence structure / rhythm
+
+| Pattern | Problem | Fix |
+|---|---|---|
+| 3+ clause sentences | Can't be read in one breath | Split at natural breaks, especially after "world" or "Dharma" |
+| Top-heavy sentences | Main clause arrives too late | Move the main clause forward |
+| "is it not too late to X" | Inverted clause is awkward | "it is not too late to X" |
+| "patterned, standardized" | "patterned" is odd in English | "structured, standardized" or "model-based, standardized" |
+| "way of management" | awkward collocation | "approach to management," "style of governance" |
+| "correction of X through correcting Y" | repetitive | "transform X by correcting Y" |
+| "special circumstances are encountered" | passive/abstract | "special circumstances may create an exception" |
+| "formed from the Buddha's wisdom and merit" | mechanical | "arises from," "embodied wisdom and merit" |
+| "with every sound entering the ears" | flat idiom | "with every syllable clearly heard" |
+| "influenced by the liberation of individuality" | wrong collocation | "emancipation of the individual," "individual liberation" |
+| "the optimization of life" | technical-sounding | "flourishing of life," "growth in life" |
+| "right-livelihood occupation" | redundant | "right livelihood" |
+| "when time is used more valuably" | awkward adverb | "when time is used more wisely" |
+| "doing great things" | OK | Keep plain; do not overtranslate 做大事 |
+| "speak merely to show off your own cleverness" | misses idiom | 逞口舌之快 → "speak for the thrill of it," "indulge in sharp talk" |
+| "the power of eradication... the power of remedy" | non-standard | Use standard four powers terminology |
+| "pincer attack from within and without" | too militaristic in pastoral context | "pressure from within and without," "assault from both sides" |
+| "stalemate" | OK but possibly cold | "stuck place," "impasse" in spiritual contexts |
+| "persevere in one sutra" | loses metaphor | "go deeply into one sutra" |
+| "muddle-headedly" | rare adverb | "in a muddled way," "without understanding" |
+| "thoroughly applied" | slightly off | "when proficiency develops" |
+| "Using relics to check seems a little too late" | OK but flat | "Using relics as a measure seems rather late in the day" |
+| "unknowable mysticism" | 玄学 ≠ mysticism | "unknowable mystery" |
+| "reliance relationship" | awkward | "teacher-student relationship" |
+| "every place becomes a place of practice" | repetitive | "everywhere becomes a field of practice" |
+| "keeping an ordinary mind when things go well and still keeping an ordinary mind when things go badly" | wordy | "keeping an ordinary mind in both good times and bad" |
+| "ordinary, lax, and indulgent mind" | acceptable but loose | "ordinary mind of laxity and indulgence" |
+
+### Register: spoken Q&A vs. written Dharma
+
+*人生百问* is conversational Q&A. Keep the English warm and direct:
+
+| Stiff / written | Conversational |
+|---|---|
+| "I do not think so necessarily." | "Not necessarily." / "I don't think so." |
+| "bustle about for liberation" | "rush about," "busy themselves" |
+| "starting a family is for liberation from singlehood" | "liberation from being single" |
+| "Seen only from the surface" | "On the surface," "From a surface view" |
+| "If one is liberated, how can these dreams be realized?" | "...how can these dreams still be realized?" |
+| "I deeply know that..." | "I know full well that..." |
+| "For yourself, you must..." | "First, for yourself..." / "Personally, you must..." |
+| "I believe that the external conditions we attract will also change." | "the conditions we draw to ourselves will also change" |
+
+### Parallelism and grammar fixes
+
+| Issue | Example | Fix |
+|---|---|---|
+| Gerund/infinitive mismatch | "drawing near to wise teachers and to rely on them" | "draw near to wise teachers and rely on them" |
+| Missing "still" | "how can these dreams be realized?" | "how can these dreams still be realized?" |
+| Mixed singular/plural | "the largest debt, not all of them" | "the largest debt, not every debt" |
+| Redundant compound | "sharp and keen faculties" | "sharp faculties" or "keen faculties" |
+| "disorder" as verb | "'nao' is to disorder" | "'nao' is to disturb" |
+
+### Meta-pattern: when the review produces `review-comments.dj`
+
+After a self-review or other-review pass, scan the resulting
+`review-comments.dj` for **recurring patterns** and add them to this file
+and to `buddhist-terminology.md`. The review of *人生百问* began as a
+single article checklist and became a reusable pattern library; future
+reviews should do the same.
+
@@ -1,6 +1,8 @@
 ---
 name: translation
 description: Translate Chinese↔English Buddhist/Dharma content — register guidance from Mindfulness Bell corpus, tone, voice, cultural bridging technique.
+inputs: source.dj (Chinese djot), or .docx via docx2dj.fish
+outputs: target.dj (English djot), bilingual.dj, edit-suggestions.dj
 ---

 # Translation
@@ -39,7 +41,7 @@ Quick-find in index: Thầy talks → `"Thích Nhất Hạnh"` + page ≤ 10; te
 ### Pre-flight accuracy check

 Before delivering a translation, run through the structured accuracy/readability
-taxonomy in `skills/translation-review/references/common-issues-taxonomy.md`.
+taxonomy in `../self-review/references/common-issues-taxonomy.md`.
 Catching these before review saves iteration cycles:
 - Omission, over-literal renderings, over-free renderings, subject confusion,
  overtranslation, terminology errors
@@ -93,7 +95,7 @@ Read the English aloud — if a sentence can't be spoken in one breath, fix it.

 These are common patterns (not an exhaustive list). For the full taxonomy with
 more categories and examples, read
-`../translation-review/references/common-issues-taxonomy.md`.
+`../self-review/references/common-issues-taxonomy.md`.

 Examples of systematic adjustments:

@@ -112,18 +114,58 @@ Examples of systematic adjustments:
   contractions, direct address, concrete images. If the English reads like a
   paper abstract, warm it up. Check against the MB corpus registers for the
   target genre.
+6. **Review-specific calques**. For *人生百问*-style Q&A, check the pattern
+   tables in `../self-review/references/translation-pitfalls.md` for recurring
+   stiff calques ("keen on," "more ultimate," "choice difficulty," etc.) and
+   the Buddhist-term register notes in `../self-review/references/buddhist-terminology.md`.

 Do NOT apply these mechanically — each is a judgment call. A passive may be
 correct when the agent is unknown; a nominalization may be the right technical
 term. The goal is natural English that matches the source's register, not a
 formulaic rewrite.

+## Quality Gates (Before Declaring Done)
+
+Run this self-check before you hand off a first-pass translation. The goal is to
+catch the most expensive errors while they are still cheap to fix. For the full
+post-translation review workflows, load `self-review` and `other-review`.
+
+### Accuracy
+
+- [ ] **Line parity**: source and target line counts match exactly.
+- [ ] **No missing content**: every Chinese paragraph, quote, poem, or rhetorical
+  climax has a corresponding English rendering.
+- [ ] **No overtranslation**: no parenthetical expansions or explanations not in
+  the source.
+- [ ] **Terminology**: key Buddhist terms checked against the MPI terms DB
+  (`terms-search` skill). Consistent within the file.
+- [ ] **Source faithfulness**: no concepts added, no details dropped.
+
+### Readability
+
+- [ ] **Active voice**: abstract/subjectless passives converted to "we" or a
+  concrete agent where possible.
+- [ ] **Noun → verb**: `the propagation of` → `spread`; `placed emphasis on` →
+  `emphasized`.
+- [ ] **Sentence length**: no sentence that cannot be spoken in one breath; split
+  at natural breaks.
+- [ ] **Plain vocabulary**: `constitute` → `is/make up`; `facilitate` → `help`;
+  `endeavor to` → `try to`.
+- [ ] **Register**: match the genre — Dharma talks and dialogues should sound
+  spoken, not like paper abstracts.
+- [ ] **Concrete over abstract**: `mode of existence` → `way of living`;
+  `ideological content` → `ideas`.
+
+### Final pass
+
+Read the entire English target aloud. If anything stalls, rephrase it.
+
 ## Meditation / Mindfulness Content

 When translating guided meditation scripts, exercise guides, or posture instructions
 (rather than Dharma talks), use a lighter workflow. See `references/meditation-translation.md`.

-## Pitfalls
+## Other Pitfalls

 ### article-specific scripts

@@ -138,4 +180,4 @@ Create article-specific scripts per `references/proofread-pdf-workflow.md`.
 - `references/bilingual-format.md` — bilingual.dj layout: source/target adjacent, blank separator between pairs
 - `references/diacritics-convention.md` — diacritics rules
 - `references/proofread-pdf-workflow.md` — pattern for creating article-specific PDF-vs-DOCX comparison scripts
- `../translation-review/references/common-issues-taxonomy.md` (cross-skill) — structured accuracy/readability checklist for pre-flight review
+- `../self-review/references/common-issues-taxonomy.md` (cross-skill) — structured accuracy/readability checklist for pre-flight review