Ppw Translation

Trigger

Activates when the user asks to:

• Translate Chinese academic text (draft, paragraph, or section) to English
• Produce English LaTeX output from Chinese input
• 将中文学术内容翻译为英文

Example invocations:

• "Translate this Chinese draft to English for CEUS"
• "翻译这段中文为英文"
• "Help me translate my methods section"
• "把 intro.md 翻译成学术英文，目标期刊是 CEUS"

Modes

Default mode: direct (single-pass, no multi-round pipeline).

Mode inference: "step by step" or "confirm before translating" switches to interactive. "Translate all sections" or "batch" switches to batch.

References

Required (always loaded)

Leaf Hints (loaded when needed)

Loading Rules

• Load the expression patterns overview at the start to orient module selection.
• Load leaf files only when the current input matches their scope.
• When a target journal is specified, also load references/journals/[journal].md.
• If a reference file is missing, warn the user and proceed with reduced capability (except journal templates; see Fallbacks).

Reference Selection Logic

1. Scan the input for Chinese section keywords: 引言, 背景, 研究方法, 方法, 数据, 结果, 讨论, 结论.
2. If a clear match is found, load the corresponding leaf module directly.
3. If the input spans multiple sections or is ambiguous, load the overview and use Quick Picks.
4. Always load geography-domain.md when the input mentions spatial concepts, cities, districts, or planning-related terms.
5. When a target journal is specified, load its template alongside the expression patterns.

Ask Strategy

Before starting, ask about:

1. Target journal (if not specified in trigger) -- determines style loading
2. Custom glossary file path (if the user has domain-specific term mappings)
3. Which section this text belongs to (only if not obvious from content or headers)

Rules:

• In direct mode, skip pre-questions when the user provides enough context in the trigger.
• If the user specifies a journal with no template at references/journals/[journal].md, refuse and explain: "No template found for [journal]. Please add a template at references/journals/[journal].md following the CEUS template format before proceeding."
• Never ask more than 3 questions before producing output.
• Use Structured Interaction when available; fall back to plain-text questions otherwise.

Workflow

Step 0: Workflow Memory Check

• Read .planning/workflow-memory.json. If file missing or empty, skip to Step 1.
• Check if the last 1-2 log entries form a recognized pattern with ppw:translation that has appeared >= threshold times in the log. See skill-conventions.md > Workflow Memory > Pattern Detection for the full algorithm.
• If a pattern is found, present recommendation via AskUserQuestion:
  • Question: "检测到常用流程：[pattern]（已出现 N 次）。是否直接以 direct 模式运行 ppw:translation？"
  • Options: "Yes, proceed" / "No, continue normally"
• If user accepts: set mode to direct, skip Ask Strategy questions.
• If user declines or AskUserQuestion unavailable: continue in normal mode.

Step 1: Collect Context

• Ask pre-questions per Ask Strategy (target journal, glossary, section type).
• Load required references: expression patterns overview.
• If target journal specified: Read references/journals/[journal].md. If file missing, stop and refuse -- instruct user to add the template first.
• If glossary file specified: Read glossary and build term mapping. If file not found, warn and proceed without glossary.
• Detect section type from input content and load the appropriate expression pattern leaf module.
• If content involves geography/urban/spatial topics: also load geography-domain.md.
• Load references/anti-ai-patterns.md for vocabulary screening.
• Record workflow: Append {"skill": "ppw:translation", "ts": "<ISO timestamp>"} to .planning/workflow-memory.json. Create file as [] if missing. Drop oldest entry if log length >= 50.

Step 2: Translate

• Follow the Core Prompt constraints above as the primary instruction set for this step.
• Single-pass translation of Chinese input to English.
• Apply journal style preferences (tone, vocabulary, claim calibration) from loaded journal template.
• Use loaded expression patterns to guide phrasing choices.
• Prioritize glossary terms when a match is found.
• Re-translate all text uniformly, including any inline English fragments, for stylistic consistency.
• Preserve all LaTeX commands verbatim: $...$, $$...$$, \begin{...}...\end{...}, \cite{...}, \ref{...}, \label{...}, and custom commands.
• Avoid high-risk anti-AI vocabulary patterns (e.g., "groundbreaking", "novel", "Moreover, it is worth noting").

Step 3: Generate Output Files

• Opt-out check: Before generating output, scan the user's original trigger prompt for any of these phrases (case-insensitive, exact phrase match): english only, no bilingual, only english, 不要中文. If any phrase is detected: skip the bilingual file entirely -- produce only [name]_en.tex. If none detected: produce both files as normal.
• Write English-only version to [name]_en.tex with a header comment:

  % Translated from: [source file]
  % Target journal: [journal or "General"]
  % Generated: [date]
  

• Write bilingual comparison to [name]_bilingual.tex:
  • Each paragraph: Chinese text as % comment lines, English as body text.
  • Number paragraphs with % --- Paragraph N --- markers.
• For pasted text input (no source file): use translation_en.tex and translation_bilingual.tex in the current working directory.
• Preserve the original input file unchanged.

Step 4: Self-Check

• Report terminology decisions (especially glossary applications and key term choices).
• Flag uncertain translations with explanation of alternatives considered.
• Note any structural changes (sentence splitting, reordering) and why.
• Warn about potential issues: very long sentences, missing references, ambiguous terms.
• Present self-check in session output (not appended to the .tex files).

Output Contract

Edge Cases

Fallbacks

Examples

User: "Translate sections/intro.md to English for CEUS submission. Glossary at glossary.txt."

Skill workflow:

1. Load references/expression-patterns.md, then references/expression-patterns/introduction-and-gap.md (detected from filename and content keywords).
2. Load references/journals/ceus.md for CEUS style rules.
3. Load glossary.txt and build term mapping.
4. Load references/anti-ai-patterns.md for vocabulary screening.
5. Read sections/intro.md and translate in a single pass, applying CEUS tone, glossary terms, and introduction expression patterns.
6. Write sections/intro_en.tex (English-only with header comment).
7. Write sections/intro_bilingual.tex (Chinese in % comments, English as body).
8. Present self-check summary in session:
   • Terminology: "城市热岛" -> "urban heat island" (glossary), "建成环境" -> "built environment" (glossary).
   • Uncertain: "宜居性" translated as "livability" -- verify American vs. British spelling for CEUS.
   • Structure: Paragraph 3 split into two sentences for readability.

Skill: translation-skill Conventions: references/skill-conventions.md