097 Index 8e2f63c7

Typst 学术论文 (typst-paper)

现代化的 Typst 学术论文写作助手。

概述

typst-paper 技能为使用 Typst 进行学术论文写作提供全面支持。Typst 是一个现代化的排版系统，编译速度达到毫秒级。支持中英文论文及主流出版场所。

主要功能

• 闪电般的编译速度（毫秒级 vs LaTeX 的秒级）
• 简洁直观的语法（比 LaTeX 更易学习）
• 实时预览支持监视模式
• 格式检查支持特定场所规则
• 语法分析用于英文论文
• 学术表达优化支持中英文
• 中英学术翻译（深度学习、时间序列、工业控制）
• 去AI化编辑降低 AI 生成文本痕迹
• 模板支持（IEEE、ACM、Springer、NeurIPS 等）

环境要求

安装：

# 使用 Cargo（Rust 包管理器）
cargo install typst-cli

# 使用 Homebrew（macOS）
brew install typst

# 使用包管理器（Linux）
sudo pacman -S typst  # Arch Linux

验证安装：

typst --version

在 Claude Code 中使用技能

本技能设计用于 Claude Code 等 AI 助手。只需在对话中提及相关触发词，助手就会激活相应模块。

参数约定

请求中请尽量包含：

• 主 .typ 路径（执行脚本时必需）
• 目标范围（章节/段落或全文）
• 模块选择（编译/格式/语法/模板等）

如信息缺失或含糊，助手会先确认，不会猜测路径或范围。

执行约束

• 仅在您明确要求时执行脚本/编译命令。
• 覆盖输出或清理类操作前先确认。

触发词

使用示例

编译论文：

请编译我的 Typst 论文 main.typ

检查语法：

能帮我检查引言部分的语法吗？

翻译成英文：

将以下中文翻译为学术英文（深度学习领域）：
本文提出了一种基于Transformer的方法...

输出协议

所有建议采用注释式 diff 格式，并包含固定字段：

• 严重级别：Critical / Major / Minor
• 优先级：P0 / P1 / P2

最小模板：

// <模块>（第<N>行）[Severity: <Critical|Major|Minor>] [Priority: <P0|P1|P2>]: <问题概述>
// 原文：...
// 修改后：...
// 理由：...
// ⚠️ 【待补证】：<需要证据/数据时标记>

失败处理

• 缺少 Typst：安装 typst-cli 并加入 PATH
• 缺少文件/脚本：确认工作目录与 scripts/ 路径
• 编译失败：优先给出首个错误摘要并请求日志片段

模块快速示例

检查 main.typ 的格式合规性

拆解引言中的长句

提升摘要的学术表达

验证 references.bib 并检查 main.typ 的引用

去AI化方法部分并保持事实不变

提供 Typst 的 IEEE 模板配置

编译模块

基本命令

使用示例

# 基础编译（推荐）
typst compile main.typ

# 监视模式（实时预览）
typst watch main.typ

# 指定输出目录
typst compile main.typ --output build/paper.pdf

# 导出为 PNG（用于预览）
typst compile --format png main.typ

# 查看可用字体
typst fonts

# 使用自定义字体路径
typst compile --font-path ./fonts main.typ

编译速度优势

• Typst 编译速度通常在毫秒级（vs LaTeX 的秒级）
• 增量编译：只重新编译修改的部分
• 适合实时预览和快速迭代

中文支持

// 中文字体配置示例
#set text(
  font: ("Source Han Serif", "Noto Serif CJK SC"),
  lang: "zh",
  region: "cn"
)

格式检查模块

检查项目

Typst 格式配置

// 页面设置
#set page(
  paper: "a4",  // 或 "us-letter"
  margin: (x: 2.5cm, y: 2.5cm)
)

// 文本设置
#set text(
  font: "Times New Roman",
  size: 11pt,
  lang: "en"
)

// 段落设置
#set par(
  justify: true,
  leading: 0.65em,
  first-line-indent: 1.5em
)

// 标题设置
#set heading(numbering: "1.1")

语法分析模块

基于 LLM 的语法检查，重点关注：

• 主谓一致
• 冠词使用（a/an/the）
• 时态一致性（方法用过去时，结果用现在时）
• 中式英语检测

常见语法错误

长难句分析模块

触发条件

• 英文：句子 >50 词 或 >3 个从句
• 中文：句子 >60 字 或 >3 个分句

输出格式

// 长难句检测（第45行，共67词）[Severity: Minor] [Priority: P2]
// 主干：[主语 + 谓语 + 宾语]
// 修饰成分：
//   - [关系从句] which...
//   - [目的状语] to...
// 建议改写：[简化版本]

学术表达模块

英文学术表达

中文学术表达

逻辑衔接与方法论深度模块

确保段落间逻辑流畅，强化方法论的严谨性。

AXES 模型（段落级逻辑衔接）

过渡信号词

方法论深度检查清单

• 每个主张都有证据支撑（数据、引用或逻辑推理）
• 方法选择有充分理由（为何选此方法而非其他？）
• 明确承认研究局限性
• 清晰陈述前提假设
• 可复现性细节充分（参数、数据集、评估指标）

常见问题

在 Claude Code 中使用

检查引言部分的逻辑衔接

分析方法部分的方法论深度

在段落之间添加过渡信号词

翻译模块（中译英）

支持领域

翻译流程

1. 领域识别 - 确定专业领域术语
2. 术语确认 - 确认翻译
3. 翻译并注释 - 带注释的翻译
4. 中式英语检查 - 检测并修正常见错误
5. 学术润色 - 最终审查

常用学术句式

参考文献模块

Typst 参考文献管理

方法 1：使用 BibTeX 文件

#bibliography("references.bib", style: "ieee")

方法 2：使用 Hayagriva 格式

#bibliography("references.yml", style: "apa")

支持的引用样式

• ieee - IEEE 数字引用
• apa - APA 作者-年份
• chicago-author-date - 芝加哥作者-年份
• mla - MLA 人文学科
• gb-7714-2015 - 中国国标

引用示例

// 文中引用
According to @smith2020, the method...
Recent studies @smith2020 @jones2021 show...

// 参考文献列表
#bibliography("references.bib", style: "ieee")

# 在线验证（CrossRef + Semantic Scholar）
python scripts/verify_bib.py references.bib --online
python scripts/verify_bib.py references.bib --online --email you@example.com

去AI化编辑模块

在保持 Typst 语法和技术准确性的前提下，降低 AI 写作痕迹。

输入要求

1. 源码类型（必填）：Typst
2. 章节（必填）：Abstract / Introduction / Related Work / Methods / Experiments / Results / Discussion / Conclusion
3. 源码片段（必填）：直接粘贴（保留原缩进）

工作流程

1. 语法结构识别 检测 Typst 语法，完整保留：

• 函数调用：#set, #show, #let
• 引用：@cite, @ref, @label
• 数学：$...$, $ ... $（块级）
• 标记：*bold*, _italic_, `code`
• 自定义函数（默认不改）

2. AI 痕迹检测：

3. 文本改写（仅改可见文本）：

• 拆分长句（英文 >50 词，中文 >50 字）
• 调整词序以符合自然表达
• 用具体主张替换空泛表述
• 删除冗余短语
• 补充必要主语（不引入新事实）

4. 输出生成：

// ============================================================
// 去AI化编辑（第23行 - Introduction）
// ============================================================
// 原文：This method achieves significant performance improvement.
// 修改后：The proposed method improves performance in the experiments.
//
// 改动说明：
// 1. 删除空话："significant" → 删除
// 2. 保留原有主张，避免新增具体指标
//
// ⚠️ 【待补证：需要实验数据支撑，补充具体指标】
// ============================================================

= Introduction
The proposed method improves performance in the experiments...

硬性约束

• 绝不修改：@cite, @ref, @label, 数学环境
• 绝不新增：事实、数据、结论、指标、实验设置、引用编号
• 仅修改：普通段落文字、标题文本

分章节准则

模板配置模块

模板示例与用法请参考 references/TEMPLATES.md。

标题优化模块

根据 IEEE/ACM/Springer/NeurIPS 最佳实践，生成和优化学术论文标题。

核心原则

基于 IEEE Author Center 及顶级会议/期刊指南：

英文论文：

1. 简洁性：删除 "A Study of", "Research on", "Novel", "New"
2. 可搜索性：核心术语（方法+问题）在前 65 字符内
3. 长度：最佳 10-15 词
4. 具体性：具体方法/问题名称
5. 规范性：避免生僻缩写

中文论文：

1. 简洁性：删除"关于...的研究"、"新型"、"改进的"
2. 可搜索性：核心术语在前 20 字内
3. 长度：最佳 15-25 字
4. 具体性：具体术语
5. 规范性：符合规范

质量评分

每个标题获得 0-100 分，基于五个标准：

• 简洁性 (25%)
• 可搜索性 (30%)
• 长度 (15%)
• 具体性 (20%)
• 规范性 (10%)

在 Claude Code 中使用

检查现有标题：

检查我的论文标题质量

生成标题候选：

根据摘要生成标题候选方案

优化现有标题：

优化我的论文标题，符合 IEEE 最佳实践

标题模式

英文：

• Method for Problem: "Transformer for Time Series Forecasting"
• Method: Problem in Domain: "Graph Neural Networks: Fault Detection in Industrial Systems"
• Problem via Method: "Time Series Forecasting via Attention Mechanisms"

中文：

• 问题的方法: "时间序列预测的Transformer方法"
• 方法及应用: "注意力机制及其在工业控制中的应用"
• 面向领域的方法: "面向智能制造的深度学习方法"

好与差的示例

英文：

Good: "Transformer for Time Series Forecasting in Industrial Control"
Bad:  "A Novel Study on Improved Time Series Forecasting Using Transformers"

中文：

好：工业控制系统时间序列预测的Transformer方法
差：关于基于Transformer的工业控制系统时间序列预测的研究

Typst 标题配置

英文论文：

#align(center)[
  #text(size: 18pt, weight: "bold")[
    Transformer-Based Time Series Forecasting for Industrial Control
  ]
]

中文论文：

#align(center)[
  #text(size: 18pt, weight: "bold", font: "Source Han Serif")[
    工业控制系统时间序列预测的Transformer方法
  ]

  #v(0.5em)

  #text(size: 14pt, font: "Times New Roman")[
    Transformer-Based Time Series Forecasting for Industrial Control Systems
  ]
]

期刊/会议特定规则

IEEE

• 两栏格式，列间距 0.33 英寸
• Times New Roman 10pt
• 主动语态，方法用过去时
• 图表编号：Fig. 1, Table I

ACM

• 两栏格式，A4 或 US Letter
• 现在时表述一般真理
• 引用格式：数字或作者-年份

Springer

• 图标题在下，表标题在上
• 参考文献按字母顺序排列

NeurIPS/ICML

• 8 页限制（不含参考文献）
• 匿名提交（双盲评审）
• 特定格式要求

Typst 优势总结

vs LaTeX

适用场景

• ✅ 快速原型和草稿
• ✅ 需要频繁修改的文档
• ✅ 团队协作（语法简单）
• ✅ 中小型论文（<100 页）
• ⚠️ 复杂数学公式（LaTeX 更成熟）
• ⚠️ 特定期刊模板（可能需要 LaTeX）

快速开始

安装 Typst：

# 使用 Cargo（Rust 包管理器）
cargo install typst-cli

# 使用 Homebrew（macOS）
brew install typst

# 使用包管理器（Linux）
sudo pacman -S typst  # Arch Linux

创建第一个论文：

# 从模板初始化
typst init @preview/charged-ieee

# 编译
typst compile main.typ

# 监视模式（推荐）
typst watch main.typ

常用命令：

# 查看帮助
typst --help

# 查看可用字体
typst fonts

# 指定输出格式
typst compile --format png main.typ

# 使用自定义字体
typst compile --font-path ./fonts main.typ

推荐工作流

草稿快速迭代

1. 编译或监视模式
2. 基础格式检查
3. 语法分析（摘要 + 引言）

投稿前检查

1. 期刊/会议格式检查
2. 学术表达优化
3. 去AI化编辑
4. 参考文献验证
5. 模板配置核对（如期刊要求）

参考文件

• references/TYPST_SYNTAX.md：Typst 语法指南
• references/STYLE_GUIDE.md：学术写作规范
• references/COMMON_ERRORS.md：常见错误
• references/VENUES.md：期刊会议要求
• references/DEAI_GUIDE.md：去AI化写作指南
• references/TEMPLATES.md：Typst 模板示例
• scripts/check_references.py：引用完整性检查器（独立运行）
• scripts/online_bib_verify.py：在线文献验证器