Back to Details

ccf-paper-to-exemplar

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Paper-to-Exemplar

论文转范例

Purpose

用途

Convert one or more conference paper PDFs into distilled writing exemplar cards that the 
ccf-paper-writer
skill can use as style references. This skill does not write papers. It produces exemplar cards that teach the writer skill how to write.
将一篇或多篇会议论文PDF转换为精简的写作范例卡片，供
ccf-paper-writer
技能作为风格参考使用。本技能不负责撰写论文，而是生成范例卡片来指导写作技能的运用。

When To Use

使用场景

  • User says: "use this paper as writing reference", "convert this PDF to exemplar", "add this to my writing templates"
  • User wants to build a personal library of favorite papers for writing-style imitation
  • User specifies a target venue and wants venue-matched exemplars loaded
  • After downloading a best paper, the user wants it distilled for fast reuse
  • 用户提出："将这篇论文作为写作参考"、"把这个PDF转换成范例"、"将其添加到我的写作模板中"
  • 用户希望构建个人喜爱论文的库，用于模仿写作风格
  • 用户指定目标会议场地，需要加载匹配该场地的范例
  • 用户下载最佳论文后，希望将其精简以便快速复用

Workflow

工作流程

  1. Receive PDF paths and optional target venue from the user.
  2. Run 
    scripts/convert.py
    to extract text and produce initial cards with 
    [ANALYZE]
    placeholders.
  3. Read the extracted full text (
    .full.md
    file) to understand the paper content.
  4. Analyze the paper writing patterns:
  • Story arc: task -> gap -> root challenge -> insight -> method -> evidence -> limitation
  • Abstract moves: what information is packed into each sentence?
  • Introduction paragraph roles: what does each paragraph accomplish?
  • Method presentation: module-by-module, concept-first, or pipeline-first?
  • Evidence organization: table strategy, ablation logic, qualitative placement
  • Citation patterns: density, weaving style, author-name usage, grouping
  1. Load 
    ../ccf-paper-writer/references/prose-quality-guardrails.md
    and filter the extracted pattern: preserve transferable logic, but do not turn defensive framing, 
    Q1
    /
    C1
    labels, formula dumping, number-only abstracts, third-person manuscript narration, punctuation-heavy structure, or unsupported hype into reusable advice.
  2. Fill in the 
    [ANALYZE]
    placeholders with concrete, actionable writing-pattern descriptions.
  3. Save the completed card to 
    ccf-paper-writer/references/exemplars/cards/
    .
  4. Register the card in 
    ccf-paper-writer/references/exemplars/index.md
    under the correct venue section.
  5. If the user wants this as their default writing template, update 
    ccf-paper-writer/references/custom-format/default-user-format.md
    .
  6. Inform the user the exemplar is ready and what writing patterns it provides.
  1. 接收用户提供的PDF路径和可选的目标会议场地信息。
  2. 运行
    scripts/convert.py
    提取文本并生成带有
    [ANALYZE]
    占位符的初始卡片。
  3. 读取提取的全文（
    .full.md
    文件）以理解论文内容。
  4. 分析论文的写作模式：
  • 叙事结构：任务 -> 空白 -> 核心挑战 -> 见解 -> 方法 -> 论据 -> 局限性
  • 摘要手法：每个句子包含哪些信息？
  • 引言段落作用：每个段落实现什么目标？
  • 方法呈现：按模块介绍、先讲概念还是先讲流程？
  • 论据组织：表格策略、消融实验逻辑、定性内容的放置方式
  • 引用模式：密度、融入风格、作者姓名使用方式、分组方式
  1. 加载
    ../ccf-paper-writer/references/prose-quality-guardrails.md
    并过滤提取的模式：保留可迁移的逻辑，但不要将防御性表述、
    Q1
    /
    C1
    标签、公式堆砌、纯数字摘要、第三人称手稿叙述、标点密集结构或无依据的夸大转化为可复用建议。
  2. 用具体、可操作的写作模式描述填充
    [ANALYZE]
    占位符。
  3. 将完成的卡片保存到
    ccf-paper-writer/references/exemplars/cards/
    目录下。
  4. 在
    ccf-paper-writer/references/exemplars/index.md
    中对应会议场地的章节下注册该卡片。
  5. 如果用户希望将其设为默认写作模板，更新
    ccf-paper-writer/references/custom-format/default-user-format.md
    。
  6. 告知用户范例已准备就绪，并说明其提供的写作模式。

Venue-Aware Routing

场地感知路由

When the user specifies a target venue (e.g., "投CVPR", "for NeurIPS submission"):
  1. Classify the target venue into its venue family using 
    ../ccf-paper-writer/references/venue-guides/index.md
    .
  2. If the user provides a PDF, distill it with the venue tag so it is categorized correctly.
  3. If the user does NOT provide a PDF but names a venue, check whether exemplar cards already exist for that venue:
  • Look in 
    ../ccf-paper-writer/references/exemplars/index.md
    for venue-matched bundles.
  • If matching exemplars exist, load them and offer them to the writer skill.
  • If no matching exemplars exist, suggest: "No {venue} exemplars found. Provide a {venue} best paper PDF and I will distill it."
  1. When the writer skill is invoked for this venue, the exemplar index should route to the correct cards automatically.
当用户指定目标会议场地（例如："投CVPR"、"用于NeurIPS投稿"）时：
  1. 使用
    ../ccf-paper-writer/references/venue-guides/index.md
    将目标会议场地分类到对应的场地家族。
  2. 如果用户提供了PDF，为其添加场地标签后进行精简，确保分类正确。
  3. 如果用户未提供PDF但指定了场地，检查该场地是否已有范例卡片：
  • 在
    ../ccf-paper-writer/references/exemplars/index.md
    中查找匹配场地的范例包。
  • 如果存在匹配范例，加载并提供给写作技能。
  • 如果没有匹配范例，提示："未找到{venue}范例。请提供一篇{venue}最佳论文PDF，我将为您进行精简。"
  1. 当针对该场地调用写作技能时，范例索引应自动路由到正确的卡片。

Integration With ccf-paper-writer

与ccf-paper-writer的集成

The writer skill loads exemplars through 
references/exemplars/index.md
. This skill populates that index. The handoff is:
text
paper-to-exemplar (distill PDFs -> create cards -> update index)
 -> ccf-paper-writer (load cards from index -> write with venue-matched style)
When the writer skill starts, it checks:
  1. Did the user specify a venue? If yes, load venue-matched cards.
  2. If no venue specified, load the user default cards from 
    custom-format/default-user-format.md
    .
  3. If no default cards exist, load the most general-purpose cards (e.g., llava-4d, vggt).
写作技能通过
references/exemplars/index.md
加载范例。 本技能负责填充该索引。协作流程如下：
text
paper-to-exemplar (精简PDF -> 创建卡片 -> 更新索引)
 -> ccf-paper-writer (从索引加载卡片 -> 按匹配场地的风格写作)
写作技能启动时会检查：
  1. 用户是否指定了场地？如果是，加载匹配场地的卡片。
  2. 如果未指定场地，从
    custom-format/default-user-format.md
    加载用户默认卡片。
  3. 如果没有默认卡片，加载最通用的卡片（例如：llava-4d、vggt）。

Output Contract

输出约定

After processing PDFs:
  1. List the generated card files and their locations.
  2. Summarize the writing patterns extracted from each paper.
  3. State which venue family each card belongs to.
  4. If cards were registered as defaults, confirm the registration.
  5. Provide next-action options: "Run ccf-paper-writer with these exemplars" or "Add more papers."
  6. State any excluded anti-patterns when the source paper used them heavily.
处理PDF后：
  1. 列出生成的卡片文件及其位置。
  2. 总结从每篇论文中提取的写作模式。
  3. 说明每张卡片所属的场地家族。
  4. 如果卡片已注册为默认模板，确认注册成功。
  5. 提供后续操作选项："使用这些范例运行ccf-paper-writer"或"添加更多论文"。
  6. 如果源论文大量使用了不良模式，说明被排除的不良模式。

Reference Files

参考文件

  • scripts/convert.py
    : PDF-to-markdown extraction and card skeleton generation.
  • ../ccf-paper-writer/references/exemplars/index.md
    : exemplar registry (this skill writes to it).
  • ../ccf-paper-writer/references/exemplars/cards/
    : card storage directory.
  • ../ccf-paper-writer/references/custom-format/default-user-format.md
    : default exemplar configuration.
  • ../ccf-paper-writer/references/venue-guides/index.md
    : venue family classification.
  • ../ccf-paper-writer/references/prose-quality-guardrails.md
    : anti-pattern filter for distilled writing cards.
  • scripts/convert.py
    : PDF转Markdown提取工具及卡片框架生成脚本。
  • ../ccf-paper-writer/references/exemplars/index.md
    : 范例注册表（本技能会写入内容）。
  • ../ccf-paper-writer/references/exemplars/cards/
    : 卡片存储目录。
  • ../ccf-paper-writer/references/custom-format/default-user-format.md
    : 默认范例配置文件。
  • ../ccf-paper-writer/references/venue-guides/index.md
    : 场地家族分类文件。
  • ../ccf-paper-writer/references/prose-quality-guardrails.md
    : 用于过滤精简写作卡片中不良模式的规则文件。

Card Format

卡片格式

Every exemplar card follows this structure (see existing cards for examples):
markdown
undefined
每个范例卡片遵循以下结构（可参考现有卡片示例）：
markdown
undefined

Paper Title

论文标题

Venue/year: CVPR2025. Source: distilled from PDF by ccf-paper-to-exemplar. Use when: writing {paper type} in the {venue} venue family.
会议场地/年份: CVPR2025. 来源: 由ccf-paper-to-exemplar从PDF精简而来。 适用场景: 在{场地家族}的{会议场地}中撰写{论文类型}时使用。

Story Pattern

叙事模式

Describe the story arc the paper follows.
描述论文遵循的叙事结构。

Abstract Moves

摘要手法

How does the abstract compress the contribution?
摘要如何浓缩研究贡献？

Introduction Moves

引言手法

Paragraph-by-paragraph role analysis.
逐段分析段落作用。

Method Moves

方法手法

How is the method presented and justified?
方法如何呈现并论证？

Evidence Moves

论据手法

Evidence types, table/figure strategy, claim mapping.
论据类型、表格/图表策略、论点映射方式。

Citation Patterns

引用模式

How are citations woven? Density? Style?
引用如何融入文本？密度？风格？

Reusable Techniques

可复用技巧

Transferable writing techniques.
可迁移的写作技巧。

Excluded Anti-Patterns

排除的不良模式

Writing moves from the source that should not be reused, such as label-heavy prose, formula dumping, number-only abstract style, defensive framing, or punctuation-driven structure.
源论文中不应复用的写作手法，例如标签密集的文本、公式堆砌、纯数字摘要风格、防御性表述或标点主导的结构。

Do-Not-Copy Boundary

不可复制边界

Do not copy specific task, claims, examples, or technical content.
undefined
请勿复制特定任务、论点、示例或技术内容。
undefined

Dependencies

依赖项

  • Python3 with 
    pymupdf
    (install: 
    pip install pymupdf
    )
  • The 
    convert.py
    script handles PDF text extraction
  • 安装了
    pymupdf
    的Python3（安装命令: 
    pip install pymupdf
    ）
  • convert.py
    脚本负责PDF文本提取