writing-quotation

引文写法

在 Markdown 文档中引用外部来源的格式规则。其他会生成带来源交付内容的技能（如 survey、ja-explainer 等）都会参考本规则。

1. 为什么要引用原文

仅提供摘要无法让读者判断作者对来源的解读是否正确。将原文一并呈现，读者就能对照来源本身，核查作者的解读。引文与正文（作者自己的摘要或解读）在视觉和结构上必须保持区分。

2. 引文必须放在代码块中

无论内容类型如何，都要在围栏代码块中引用外部来源——无论是正文、提示词模板、代码、XML 标记文本，还是其他内容。不要使用引用块语法（>）。

3. 引文块的结构

引文块格式如下。

• 开始围栏
• 原文
• 一个空行
• 译文（仅当来源语言与作者的工作语言不同时）
• 结束围栏
• 紧接在结束围栏下一行的来源引用 [label (YYYY/MM), location]

规则：

• 原文和译文放在同一个代码块中。
• 原文与译文之间用一个空行隔开。
• 不要在原文和译文之间插入水平线（---）。
• 不要将译文移到代码块外，也不要把译文放在原文旁边的括号中。
• 来源引用必须独立成行，放在代码块结束围栏之后。绝不能放在代码块内。

4. 示例

4.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 跨语言引文

当来源所用语言不同于作者的工作语言时，将译文作为独立段落放在同一个代码块中：

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 提示词模板引文

提示词模板遵循同一规则。将其放在代码块中，并在围栏之后标注来源引用。

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 译文中的简短角色标记

翻译提示词模板（Human/Assistant 风格）时，译文一侧可以缩写角色标记，以减轻认知负担，并便于读者一眼区分原文和译文。

• Human: → H:
• Assistant: → A:

原文一侧的角色标记必须保持完整（Human: / Assistant:）。聊天模板最末尾的 Assistant:（标示回复开始位置的标记）具有结构意义，译文一侧也可以保留为 Assistant:。

5. 来源引用格式

格式：[label (YYYY/MM), location]。

• label：来源标识符。调用此规则的技能决定其约定（作者简称、出版物名称等）。
• (YYYY/MM)：年份和月份。不包含日期。如果只知道年份，则使用 (YYYY)。
• location：引文在来源中的位置（p.4、Section 3.1、Figure 2、(15)、opening、final paragraph 等）。无法确定时省略。

如果没有位置信息，写作 [label (YYYY/MM)]。

5.1 不要使用无说明的数字引用

不要使用 [1] 或 [2] 这类无说明的数字引用。读者必须在正文与参考文献之间来回查找，才能知道每个数字指的是什么。应使用基于标签的格式，直接在文本中标明所指对象。

6. 反模式

反模式 1 — 使用引用块语法（>）：

以 > 开头的行不适合作为外部引文。始终将内容放在代码块中（参见第 2 节）。

反模式 2 — 在代码块外翻译：

Composability is the property by which ...

翻译作为正文出现在代码块外。[example-handbook (2026/04), Section 2.1]

修正：将原文和译文放在同一个代码块中，中间空一行。

反模式 3 — 将译文放在原文旁边的括号中：

Composability is the property by which ... (Inline translation in parentheses ...)

[example-handbook (2026/04), Section 2.1]

修正：将原文和译文作为独立段落放在同一个代码块中，中间空一行。

反模式 4 — 在代码块内注明来源：

Composability is the property by which ...

Translation here ...
[example-handbook (2026/04), Section 2.1]

修正：来源注明应放在结束围栏之后的下一行，单独成行。

反模式 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. 范围

此技能仅定义引文格式。何时引用（Assertion-Evidence 顺序、使用什么标签等）由调用此技能的技能决定。

• survey：Assertion-Evidence 顺序——先用正文陈述主张，再用引文佐证。label 槽位填写出版物或来源名称。
• ja-explainer（论文详解）：引用正在评审的论文时省略作者，仅使用位置标注（[p.X, Section Y.Z]）。引用其他作品时使用 [author-short (YYYY/MM)]。