Skip to content

brycewang-stanford/Auto-Empirical-Research-Skills / skills/35-bahayonghang-academic-writing-skills/skills/typst-paper

typst-paper

Verified

Typst academic paper assistant for existing `.typ` paper projects in English or Chinese. Use this skill whenever the user wants to compile, audit, or improve a Typst paper, including format checks, bibliography validation for BibTeX or Hayagriva, grammar/sentence/logic review, expression polishing, translation, title optimization, pseudocode review, algorithm block cleanup, de-AI editing, experiment-section review, table structure validation, three-line table generation, abstract structure diagnosis, or journal adaptation. Trigger even when the user only mentions one Typst file, one bibliography issue, one pseudocode block, one section rewrite, "three-line table", "check abstract", or "reformat for another journal". Also trigger when the user mentions ".typ files", "typst compile error", "typst export", "typst bibliography", `algorithm-figure`, `lovelace`, or `algorithmic` even without saying the word "Typst" explicitly.

FileKindSize
SKILL.mdskill md7.5 KB
agents/openai.yamlconfig330 B
evals/evals.jsonconfig7.3 KB
examples/bibliography-and-title.mdmarkdown509 B
examples/compile-and-format.mdmarkdown495 B
examples/expression-and-translation.mdmarkdown554 B
references/ABSTRACT_STRUCTURE.mdmarkdown4.9 KB
references/BEST_PRACTICES.mdmarkdown391 B
references/CITATION_STYLES.mdmarkdown4.2 KB
references/CITATION_VERIFICATION.mdmarkdown4.9 KB
references/COMMON_ERRORS.mdmarkdown5.3 KB
references/DEAI_GUIDE.mdmarkdown14.9 KB
references/JOURNAL_ABBREVIATIONS.mdmarkdown3.5 KB
references/JOURNAL_ADAPTATION_WORKFLOW.mdmarkdown3.6 KB
references/NUMBER_UNIT_GUIDE.mdmarkdown2.3 KB
references/REVIEWER_PERSPECTIVE.mdmarkdown4.9 KB
references/STYLE_GUIDE.mdmarkdown7.9 KB
references/TABLE_GUIDE.mdmarkdown2.6 KB
references/TEMPLATES.mdmarkdown2.5 KB
references/TERMINOLOGY.mdmarkdown9.9 KB
references/TRANSLATION_GUIDE.mdmarkdown11.4 KB
references/TYPST_SYNTAX.mdmarkdown9.8 KB
references/VENUES.mdmarkdown13.0 KB
references/WRITING_PHILOSOPHY.mdmarkdown6.7 KB
references/modules/ABSTRACT.mdmarkdown1.2 KB
references/modules/ADAPT.mdmarkdown1.3 KB
references/modules/BIBLIOGRAPHY.mdmarkdown1.3 KB
references/modules/CAPTION.mdmarkdown2.1 KB
references/modules/COMPILE.mdmarkdown1.2 KB
references/modules/DEAI.mdmarkdown2.8 KB
references/modules/EXPERIMENT.mdmarkdown3.8 KB
references/modules/EXPRESSION.mdmarkdown1.6 KB
references/modules/FORMAT.mdmarkdown1.1 KB
references/modules/GRAMMAR.mdmarkdown1.1 KB
references/modules/LOGIC.mdmarkdown5.4 KB
references/modules/PSEUDOCODE.mdmarkdown1.4 KB
references/modules/SENTENCES.mdmarkdown726 B
references/modules/TABLES.mdmarkdown1.3 KB
references/modules/TITLE.mdmarkdown7.3 KB
references/modules/TRANSLATION.mdmarkdown1.5 KB
references/modules/WORKFLOW.mdmarkdown706 B
scripts/analyze_abstract.pyscript17.3 KB
scripts/analyze_experiment.pyscript11.1 KB
scripts/analyze_grammar.pyscript3.6 KB
scripts/analyze_logic.pyscript18.8 KB
scripts/analyze_sentences.pyscript3.6 KB
scripts/check_format.pyscript11.3 KB
scripts/check_pseudocode.pyscript8.6 KB
scripts/check_references.pyscript14.1 KB
scripts/check_tables.pyscript9.8 KB
scripts/compile.pyscript8.1 KB
scripts/deai_batch.pyscript10.2 KB
scripts/deai_check.pyscript19.2 KB
scripts/generate_table.pyscript6.7 KB
scripts/improve_expression.pyscript3.2 KB
scripts/online_bib_verify.pyscript11.9 KB
scripts/optimize_title.pyscript16.9 KB
scripts/parsers.pyscript8.0 KB
scripts/translate_academic.pyscript4.2 KB
scripts/verify_bib.pyscript15.1 KB

scripts/translate_academic.py

View on GitHub
#!/usr/bin/env python3
"""
Chinese -> English academic translation helper (MVP).

This script is terminology-driven and provides:
1) terminology confirmation table
2) draft translation
3) ambiguity notes requiring manual confirmation
"""

import argparse
import sys
from pathlib import Path

TERMINOLOGY = {
    "deep-learning": {
        "注意力机制": "attention mechanism",
        "损失函数": "loss function",
        "神经网络": "neural network",
        "时间序列预测": "time series forecasting",
        "模型": "model",
    },
    "time-series": {
        "时间序列": "time series",
        "预测": "forecasting",
        "滑动窗口": "sliding window",
        "趋势": "trend",
        "季节性": "seasonality",
    },
    "industrial-control": {
        "故障检测": "fault detection",
        "工业控制": "industrial control",
        "控制系统": "control system",
        "实时": "real-time",
        "鲁棒性": "robustness",
    },
}

AMBIGUOUS_TERMS = {
    "控制": ["control", "controller", "regulation"],
    "性能": ["performance", "efficiency"],
    "优化": ["optimization", "improvement"],
}

COMMON_PATTERNS = {
    "本文提出": "We propose",
    "实验结果表明": "Experimental results demonstrate that",
    "与...相比": "Compared with ...",
    "在...中": "in ...",
}


def _load_source(input_arg: str) -> str:
    path = Path(input_arg)
    if path.exists() and path.is_file():
        return path.read_text(encoding="utf-8", errors="ignore")
    return input_arg


def _build_term_table(text: str, domain: str) -> list[tuple[str, str, str]]:
    table: list[tuple[str, str, str]] = []
    domain_terms = TERMINOLOGY.get(domain, {})
    for zh, en in domain_terms.items():
        if zh in text:
            table.append((zh, en, domain))
    return table


def _draft_translate(text: str, domain: str) -> tuple[str, list[str]]:
    translated = text
    notes: list[str] = []

    for zh, en in TERMINOLOGY.get(domain, {}).items():
        if zh in translated:
            translated = translated.replace(zh, en)

    for zh, en in COMMON_PATTERNS.items():
        if zh in translated:
            translated = translated.replace(zh, en)

    for term, options in AMBIGUOUS_TERMS.items():
        if term in translated:
            notes.append(f"Ambiguous term '{term}' -> choose one: {', '.join(options)}")

    # Minimal sentence formatting
    translated = translated.replace("。", ". ").replace(",", ", ")
    translated = " ".join(translated.split())
    return translated, notes


def translate(input_arg: str, domain: str) -> str:
    text = _load_source(input_arg)
    table = _build_term_table(text, domain)
    draft, notes = _draft_translate(text, domain)

    lines: list[str] = []
    lines.append("### Terminology Confirmation")
    lines.append("| 中文 | English | Domain |")
    lines.append("|------|---------|--------|")
    if table:
        for zh, en, dom in table:
            lines.append(f"| {zh} | {en} | {dom} |")
    else:
        lines.append("| (none detected) | - | - |")

    lines.append("\n### Translation Draft")
    lines.append(f"% ORIGINAL: {text}")
    lines.append(f"% TRANSLATION: {draft}")

    lines.append("\n### Notes")
    if notes:
        for note in notes:
            lines.append(f"- ⚠️ [PENDING CONFIRMATION] {note}")
    else:
        lines.append("- No high-risk ambiguous terms detected by rule set.")

    return "\n".join(lines)


def main() -> int:
    cli = argparse.ArgumentParser(description="Terminology-driven academic translation helper")
    cli.add_argument("input", help="Chinese text or a file path containing Chinese text")
    cli.add_argument(
        "--domain",
        choices=["deep-learning", "time-series", "industrial-control"],
        default="deep-learning",
        help="Domain terminology set",
    )
    cli.add_argument("--output", help="Output file path")
    args = cli.parse_args()

    result = translate(args.input, args.domain)
    if args.output:
        Path(args.output).write_text(result, encoding="utf-8")
        print(f"[SUCCESS] Translation report written to: {args.output}")
    else:
        print(result)
    return 0


if __name__ == "__main__":
    sys.exit(main())
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall