documenting-with-sources

出典を用いたドキュメント作成

外部の出典を参照する Markdown ドキュメントを作成する際の一般的な規約です。調査レポート、論文の解説など、ほかの情報源から得た事実を提示するすべての成果物に適用してください。

すべての事実に出典を付ける

成果物に含まれるすべての事実には、引用を付ける必要があります。引用のない主張は検証できず、出典に基づく知見として価値がありません。出典に結び付けられない主張には、「引用元未確認」などと明記してください。引用のない主張を黙って紛れ込ませてはいけません。

参照形式

• 本文中の参照は [ラベル（YYYY/MM）、位置] の形式にします。ラベル欄に何を記載するか（出版物名、著者の短縮形、対象論文については位置のみ、など）は、呼び出し元のスキルで決定します。
• [1] や [2] のように数字だけの参照は使わないでください。数字だけでは、読者が本文と出典一覧の間を行き来する必要があり、読みやすさが損なわれます。
• 引用ブロック自体の書式（コードブロックの囲み方、原文と翻訳の併記、出典参照の配置、アンチパターン）については、writing-quotation スキルに従ってください。執筆前に writing-quotation を読んでください。

引用と本文

• 引用と本文（執筆者自身による要約や解釈）は、見た目と構成の両面で明確に分けてください。引用しない場合でも、出典の主張と執筆者の解釈が混同されないように書いてください。
• 執筆者の作業言語とは異なる言語で書かれた出典を引用する場合は、同じコードブロック内に原文と翻訳を併記してください（writing-quotation を参照）。

根拠のない関連付けや解釈をしない

出典自体に含まれていない解釈、推測、関連付けを書いてはいけません。

• 出典に記載がないのに、「これは X に関連する」「Y に応用できる可能性がある」「これは Z を示唆している」などのつながりを作り出してはいけません。
• 周囲の会話や呼び出し元のプロジェクトから文脈を持ち込んで、ドキュメント本文に加えてはいけません。出典の説明は、その出典自体の内容にとどめてください。
• 適切な例： 「主な批判点：ラベルを反転させても正解率が常に低下するわけではなく、テキスト勾配は数学的に古典的な勾配降下法とは異なる」（出典が実際に述べている内容を示しています）。
• 不適切な例： 「AI による文章改善との関連：フィードバックに基づく改善は数学的に勾配降下法とは異なる……」（出典には記載がなく、会話の文脈から作り出された関連付けです）。

出典一覧の形式

ドキュメント末尾の出典一覧は、次の形式にします。

[ラベル、YYYY/MM] 著者。「タイトル。」出版物。URL

- [n] 形式のリストは使わないでください。