Back to Details

writing-quotation

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Writing Quotation

引用内容撰写规范

Formatting rules for quoting external sources inside a Markdown document. Other skills that produce sourced deliverables (
survey
, 
paper-details
, and similar) reference this one.
Markdown文档中引用外部来源的格式规则。其他生成带来源交付物的技能（
survey
、
paper-details
等）均参考本规则。

1. Why quote the original

1. 为何保留原文引用

A summary alone does not let the reader judge whether the writer's reading of the source is correct. Placing the original alongside lets the reader cross-check the writer's interpretation against the source itself. Quotations and prose (the writer's own summary or interpretation) must stay visually and structurally distinct.
仅提供摘要无法让读者判断作者对来源内容的理解是否正确。将原文与译文并列展示，读者可直接对照原文验证作者的解读是否准确。引用内容与作者原创内容（摘要或解读）必须在视觉和结构上区分开。

2. Quotations always go inside code blocks

2. 引用内容必须置于code blocks中

Quote external sources inside a fenced code block, regardless of content type — prose, prompt templates, code, XML-tagged text, anything. Do not use the blockquote syntax (
>
).
引用外部来源时，无论内容类型（散文、Prompt模板、代码、带XML标签的文本等），都必须放在fenced code blocks中。禁止使用blockquote syntax（
>
）。

3. Structure of a quotation block

3. 引用块的结构

A quotation block has the following shape.
  • Opening code fence
  • Original text
  • One blank line
  • Translation into the writer's working language (only when the source is in a different language)
  • Closing code fence
  • The source reference 
    [label (YYYY/MM), location]
    on the line immediately after the closing fence
Rules:
  • Original and translation sit together inside the same code block.
  • One blank line separates them.
  • Do not insert a horizontal rule (
    ---
    ) between original and translation.
  • Do not move the translation outside the code block. Do not put it in parentheses next to the original.
  • The source reference belongs on the line after the closing fence as an independent line. Never inside the code block.
引用块需遵循以下结构：
  • 起始fenced code block围栏
  • 原文内容
  • 一行空白
  • 译文（仅当来源语言与作者工作语言不同时需要）
  • 结束fenced code block围栏
  • 来源引用
    [label (YYYY/MM), location]
    置于结束fenced code block围栏的下一行
规则说明：
  • 原文与译文需放在同一个fenced code block内
  • 两者之间用一行空白分隔
  • 原文与译文之间不得插入水平分隔线（
    ---
    ）
  • 不得将译文移出fenced code block，也不得放在原文后的括号内
  • 来源引用需作为独立行放在结束fenced code block围栏的下一行，绝对不能放在fenced code block内

4. Examples

4. 示例

4.1 Same-language quotation

4.1 同语言引用

When the source and the writer share a working language, no translation is needed:
Composability is the property by which a system's behaviour is determined by the behaviour of its parts and the rules under which they are combined.
[example-handbook (2026/04), Section 2.1]
当来源语言与作者工作语言相同时，无需提供译文：
Composability is the property by which a system's behaviour is determined by the behaviour of its parts and the rules under which they are combined.
[example-handbook (2026/04), Section 2.1]

4.2 Cross-language quotation

4.2 跨语言引用

When the source is in a language other than the writer's working language, place the translation as a separate paragraph inside the same code block:
Le sens d'une expression complexe est déterminé par le sens de ses constituants et par les règles qui les combinent.

The meaning of a complex expression is determined by the meaning of its constituents and the rules that combine them.
[example-handbook (2026/04), Section 2.1]
当来源语言与作者工作语言不同时，需将译文作为独立段落放在同一个fenced code block内：
Le sens d'une expression complexe est déterminé par le sens de ses constituants et par les règles qui les combinent.

The meaning of a complex expression is determined by the meaning of its constituents and the rules that combine them.
[example-handbook (2026/04), Section 2.1]

4.3 Prompt-template quotation

4.3 Prompt模板引用

Prompt templates use the same rule. Wrap inside a code block; place the source reference after the fence.
Human: You are an assistant who summarises research papers. The paper is enclosed in <paper> tags. Produce a summary enclosed in <summary> tags. <paper>P</paper> Assistant:
[example-prompt-library (2026/04), template 03]
Prompt模板同样遵循此规则：放在fenced code block内，来源引用置于代码围栏之后。
Human: You are an assistant who summarises research papers. The paper is enclosed in <paper> tags. Produce a summary enclosed in <summary> tags. <paper>P</paper> Assistant:
[example-prompt-library (2026/04), template 03]

4.4 Short-form role markers in translations

4.4 译文中的简短角色标记

When translating a prompt template (Human/Assistant style), the translation side may abbreviate role markers to reduce cognitive load and to make it easier to tell original from translation at a glance.
  • Human:
    → 
    H:
  • Assistant:
    → 
    A:
Keep the original side unabbreviated (
Human:
/ 
Assistant:
in full). The trailing 
Assistant:
at the very end of a chat template (the position that signals where the response begins) carries structural meaning and may be left as 
Assistant:
on the translation side as well.
翻译Prompt模板（Human/Assistant风格）时，译文侧可缩写角色标记以降低认知负荷，便于快速区分原文与译文：
  • Human:
    → 
    H:
  • Assistant:
    → 
    A:
原文侧需保留完整角色标记（
Human:
/ 
Assistant:
）。聊天模板末尾的
Assistant:
（标识响应起始位置）具有结构意义，译文侧也可保留完整的
Assistant:
。

5. Source-reference format

5. 来源引用格式

Format: 
[label (YYYY/MM), location]
.
  • label
    : an identifier for the source. The calling skill decides the convention (author short-form, publication name, etc.).
  • (YYYY/MM)
    : year and month. Do not include the day. If only the year is known, use 
    (YYYY)
    .
  • location
    : where in the source the cited passage lives (
    p.4
    , 
    Section 3.1
    , 
    Figure 2
    , 
    (15)
    , 
    opening
    , 
    final paragraph
    , etc.). Omit when it cannot be pinned down.
If there is no location, write 
[label (YYYY/MM)]
.
格式：
[label (YYYY/MM), location]
  • label
    : 来源的标识符，由调用该规则的技能决定命名规范（如作者缩写、出版物名称等）
  • (YYYY/MM)
    : 年份和月份，无需包含日期。若仅知道年份，使用
    (YYYY)
  • location
    : 引用内容在来源中的位置（如
    p.4
    、
    Section 3.1
    、
    Figure 2
    、
    (15)
    、
    开头
    、
    最后一段
    等），无法确定位置时可省略
若没有位置信息，格式为
[label (YYYY/MM)]

5.1 No bare numeric references

5.1 禁止纯数字引用

Do not use bare numeric references like 
[1]
or 
[2]
. The reader has to bounce between text and bibliography to learn what each number means. Use a label-based form that identifies the subject directly inside the text.
禁止使用
[1]
或
[2]
这类纯数字引用，读者需要在正文与参考文献之间来回切换才能了解每个数字对应的来源。应使用基于标签的格式，在正文中直接标识来源主题。

6. Anti-patterns

6. 反模式示例

Anti-pattern 1 — using blockquote syntax (
>
):
A line starting with 
>
is not acceptable for an external quotation. Always wrap inside a code block (see Section 2).
Anti-pattern 2 — translation outside the code block:
Composability is the property by which ...
The translation appears here as prose, outside the code block. [example-handbook (2026/04), Section 2.1]
Fix: place original and translation inside the same code block, separated by one blank line.
Anti-pattern 3 — translation in parentheses next to the original:
Composability is the property by which ... (Inline translation in parentheses ...)
[example-handbook (2026/04), Section 2.1]
Fix: original and translation are independent paragraphs inside the same code block, separated by one blank line.
Anti-pattern 4 — source reference inside the code block:
Composability is the property by which ...

Translation here ...
[example-handbook (2026/04), Section 2.1]
Fix: the source reference goes on the line after the closing fence as an independent line.
Anti-pattern 5 — bare numeric source reference:
Composability is the property by which ...

Translation here ...
[1]
Fix: use a label that identifies the source directly (author short-form or publication name).
Anti-pattern 6 — horizontal rule between original and translation:
Composability is the property by which ...
---
Translation here ...
[example-handbook (2026/04), Section 2.1]
Fix: separate original and translation with one blank line. No horizontal rule.
反模式1 — 使用blockquote syntax（
>
）：
以
>
开头的行不适用于外部引用，必须放在fenced code block中（参见第2节）。
反模式2 — 译文放在fenced code block外：
Composability is the property by which ...
译文作为散文内容出现在此处。[example-handbook (2026/04), Section 2.1]
修正方案：将原文与译文放在同一个fenced code block内，用一行空白分隔。
反模式3 — 译文放在原文后的括号内：
Composability is the property by which ... (Inline translation in parentheses ...)
[example-handbook (2026/04), Section 2.1]
修正方案：原文与译文为fenced code block内的独立段落，用一行空白分隔。
反模式4 — 来源引用放在fenced code block内：
Composability is the property by which ...

Translation here ...
[example-handbook (2026/04), Section 2.1]
修正方案：来源引用作为独立行放在结束fenced code block围栏的下一行。
反模式5 — 纯数字来源引用：
Composability is the property by which ...

Translation here ...
[1]
修正方案：使用可直接标识来源的标签（如作者缩写或出版物名称）。
反模式6 — 原文与译文之间使用水平分隔线：
Composability is the property by which ...
---
Translation here ...
[example-handbook (2026/04), Section 2.1]
修正方案：用一行空白分隔原文与译文，禁止使用水平分隔线。

7. Scope

7. 适用范围

This skill defines the format of quotations only. When to quote (Assertion-Evidence ordering, what label to use, etc.) is decided by the calling skill.
  • survey
    : Assertion-Evidence ordering — state the claim in prose first, then back it up with a quotation. The 
    label
    slot holds the publication or source name.
  • paper-details
    : References to the paper under review omit the author and use position only (
    [p.X, Section Y.Z]
    ). References to other works use 
    [author-short (YYYY/MM)]
    .
本规则仅定义引用内容的格式。何时引用（主张-证据顺序、使用何种标签等）由调用该规则的技能决定：
  • survey
    ：遵循主张-证据顺序——先在原创内容中陈述观点，再用引用内容佐证。
    label
    字段为出版物或来源名称。
  • paper-details
    ：引用所评审的论文时，省略作者信息仅使用位置（
    [p.X, Section Y.Z]
    ）；引用其他作品时使用
    [author-short (YYYY/MM)]
    格式。