writing-quotation

引用の書き方

Markdown ドキュメント内で外部ソースを引用する際の書式ルールです。出典を明記した成果物を作成するほかのスキル（survey、ja-explainer など）も、このスキルを参照します。

1. 原文を引用する理由

要約だけでは、書き手によるソースの読み取りが正しいかどうかを読者が判断できません。原文を併記することで、読者は書き手の解釈をソース自体と照らし合わせて確認できます。引用と文章（書き手自身による要約や解釈）は、見た目と構造の両方で明確に区別する必要があります。

2. 引用は必ずコードブロックに入れる

内容の種類にかかわらず、外部ソースの引用はフェンス付きコードブロックに入れてください。文章、プロンプトテンプレート、コード、XML タグ付きテキストなど、すべてが対象です。引用構文（>）は使用しないでください。

3. 引用ブロックの構造

引用ブロックは次の形式にします。

• 開始コードフェンス
• 原文
• 空行を 1 行
• 作業言語への翻訳（ソースが別の言語の場合のみ）
• 終了コードフェンス
• 終了フェンスの直後の行にソース参照 [label (YYYY/MM), location]

ルール：

• 原文と翻訳は、同じコードブロック内にまとめます。
• その間に空行を 1 行入れます。
• 原文と翻訳の間に水平線（---）を入れないでください。
• 翻訳をコードブロックの外に出さないでください。原文の横に括弧で添えることも避けてください。
• ソース参照は終了フェンスの次の行に、独立した行として記載します。コードブロック内には入れないでください。

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]

修正：原文と翻訳を同じコードブロック内に配置し、間に空行を 1 行入れます。

アンチパターン 3 — 原文の横に括弧で翻訳を記載する：

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

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

修正：原文と翻訳を同じコードブロック内に、それぞれ独立した段落として配置し、間に空行を 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]

修正：原文と翻訳は空行を 1 行入れて区切ります。水平線は使用しません。

7. 適用範囲

このスキルでは、引用の形式のみを定義します。引用する「タイミング」（主張と根拠の順序、使用するラベルなど）は、呼び出し元のスキルで決定します。

• survey：主張と根拠の順序 — まず文章で主張を述べ、次に引用で裏付けます。label スロットには出版物名または出典名を記載します。
• ja-explainer（論文の詳細な解説）：レビュー対象の論文への参照では著者名を省略し、位置情報のみを使用します（[p.X, Section Y.Z]）。その他の著作物への参照には [author-short (YYYY/MM)] を使用します。