引用紀律

Spec Spec: ISO/IEC/IEEE 26514 ISO/IEC/IEEE 26514 Spec Spec: ISO 24495-1 ISO 24495-1 Evidence ¶ Editorial Evidence: Editorial

概覽

Insider_ 的其他頁面提到「證據等級」時，指向的就是這一頁。它說明這些文件為什麼改寫標準而非引用標準、一項主張如何連結到你可以重新驗證的 reference ID，以及八個證據等級各自究竟承諾什麼、不承諾什麼。

本頁是寫給資深工程師看的：在信任一項主張之前，他們會想先知道這項主張是依據哪些規則做出的——而這樣的要求完全合理。

為什麼這很重要

Insider_ 的每個其他頁面都會提出主張，並標上一個證據等級。只有當這個標記背後的系統是明確的，它才有價值。如果「以標準為依據」可以代表從「我仔細讀過規格」到「我大致記得它說了什麼」之間的任何意思，那麼這個徽章就只是裝飾。

此外還有一個更嚴格的限制。NextPDF 所依循的許多文件——ISO、ETSI 與類似的規格——都受授權保護。無論篇幅多短，都不允許重製它們的文字。因此這套紀律必須同時解決兩個問題：讓一項主張能對照其來源接受檢驗，同時又不重製該來源。這兩個問題的答案都是同一套機制，而本頁就是它的規格說明。

簡短版

• Insider_ **會改寫標準，而且絕不引用受授權保護的標準。**一項主張會列出標準、條款以及一個 reference ID；它不會重製標準的原文。
• 改寫不是權宜之計；它是一項理解力測驗。以 NextPDF 自己的語氣重述一項要求，會迫使撰寫者真正理解它，並讓術語與詞彙表保持一致 Spec Spec: ISO/IEC/IEEE 26514, §8 ISO/IEC/IEEE 26514 §8 。
• 每項以標準為依據的主張，都會在該頁的 citations 前置資料中，帶有一個64 字元的 reference_id，讓下一位審查者能重新取回確切的來源段落並確認改寫。
• 徽章宣告一個證據等級——八種之一——用來說明證明的種類，讓過度宣稱能一眼看出。
• 當來源無法取回時，這項主張不會被偽造。它會被保留、相對於一份重新釘選（re-pin）的帳本標記為未解決，而該頁則維持未發布——這是一套有文件記載的協定，而不是臨場發揮。

NextPDF 如何處理這件事

改寫，而非引用

NextPDF 樣式規則中最嚴格的一條凌駕於每一份上游指南之上：不得出現來自受授權標準機構的逐字文字，無論摘錄有多短。取而代之，頁面會列出標準與條款、以自己的語氣改寫該要求，並記錄來源的 reference ID。

這通常會被視為一項授權限制，而它確實如此。但從編輯角度來看，這個框架更有用。逐字引用只能證明你會複製；忠實改寫則證明你對該條款的理解，足以在不改變其含義的前提下重述它。而且它讓句子能留在 NextPDF 一致的詞彙中，而不是在頁面中途切換語域，這正是文件品質模型所要求的 Spec Spec: ISO/IEC/IEEE 26514, §8 ISO/IEC/IEEE 26514 §8 。淺白語言的評斷標準在於讀者能否找到、理解並運用這些內容，而不是行文是否與來源一一對應 Spec Spec: ISO 24495-1, §Introduction ISO 24495-1 §Introduction ； 改寫能達成這一點，引用做不到。

一項主張連結的是 reference ID，而不是記憶

讓改寫能接受檢驗的機制，就是 reference ID。每項以標準為依據的主張，都會在該頁的 citations 前置資料中，帶有一個完整 64 字元的 reference_id，用以辨識改寫所依據的確切來源段落。審查者不必信任撰寫者的記憶；他們會重新取回該段落並進行比對。reference ID 是無法引用的來源與可驗證主張之間的交會點。它承載的是證明位於何處，而不是證明的原文。

證據等級陳述這是何種證明

引用回答的是「來自何處」；證據等級回答的是「是哪一種證明」。每個 Insider_ 頁面都會宣告一個證據等級，顯示在徽章列中，取自八種固定選項之一。信任順序將程式碼與測試排在執行階段之上、執行階段排在中繼資料之上、中繼資料排在敘述文字之上；一個編輯類頁面不會佯裝自己是以程式碼為依據的。

證據等級	它承諾什麼	它並不承諾什麼
Evidence { } Code-backed Evidence: Code-backed	此主張會對照引擎原始碼或可執行範例加以檢驗	某項標準強制要求它
Evidence § Standard-backed Evidence: Standard-backed	此主張錨定於一條經引用、改寫且帶有 reference ID 的條款	程式碼目前毫無例外地實作了它
Evidence ✓ Test-backed Evidence: Test-backed	測試套件中有一項測試將此行為固定下來	某個效能數字
Evidence ≡ Benchmark-backed Evidence: Benchmark-backed	一項依明確方法進行的量測支持該數字	在你的硬體上得到相同的數字
Evidence ◈ Artifact-backed Evidence: Artifact-backed	一個產出的產物（一份建置輸出、一份報告）展示了它	某項標準的強制要求
Evidence ◇ Design principle Evidence: Design principle	一項刻意且經過論證的設計決策	一項實證量測
Evidence ¶ Editorial Evidence: Editorial	一段有理有據、用來組織其他證據的說明	它自身一項全新的行為保證
Evidence ⊕ Mixed evidence Evidence: Mixed evidence	該頁混合了多種依據，並逐項說明是哪些	單一且乾淨的依據

本頁為 Evidence ¶ Editorial Evidence: Editorial ：它不主張任何屬於自己的引擎行為。它說明的是其他頁面的徽章所依賴的這套系統。這對它而言是誠實的等級；如此言明，正是將這套紀律施用於自身。

當來源無法取回時

取回並不總是可行。這套紀律的完整性，正展現在屆時會如何處理。正常的佇列、速率限制或預算暫停並非服務中斷。撰寫者會等待。一次真正的服務中斷會觸發一套有文件記載的後備機制：此主張會被保留、附上儲存庫內的證據以及程式碼本身所宣告的標準參照、相對於一份常設的重新釘選帳本被明確標記為未解決，而該頁則維持未發布，直到 reference ID 真正被釘選為止。

被禁止的動作會逐一列出，且可以檢查：偽造一個 reference ID、為了看起來真實而填補或加上前綴的數值、憑記憶寫出一條條款並偽裝成已取回的引用，或為了規避引用而悄悄刪除該主張。一份正確標記服務中斷的草稿，是帶有帳本記錄的債務，而非缺陷。一項離線且具決定性的檢查，正是用來強制執行這項區別。

Human-factors note: Human-factors note

將證據等級放在每一頁最上方的徽章列、置於任何一個正文字詞之前，是一項人因工程決定，而不是風格決定。 它讓讀者能憑辨識判斷證明的種類，而不必讀到末尾才推斷——這也正是章節結構固定不變的原因，並且相關文件連結的撰寫方式，會讓其目的地單從連結文字即可清楚得知。 只有當證據系統的等級是你看到的第一件事， 而不是你最後才重建出來的東西時，這套系統才值得信任。

證據怎麼說

本頁為 Evidence ¶ Editorial Evidence: Editorial ，因此它自身的依據，是本儲存庫中的文件治理規範，以及為這套紀律提供正當理由的那些標準。此處的主張有兩種驗證方式：閱讀儲存庫內的規則，以及重新取回所引用的條款。

主張	依據	錨點
改寫迫使人理解	標準	淺白語言依讀者的使用情況來評斷，而不是依是否與來源一一對應 Spec Spec: ISO 24495-1, §Introduction ISO 24495-1 §Introduction
術語保持一致	標準	每個術語都在整份文件中一致使用 Spec Spec: ISO/IEC/IEEE 26514, §8 ISO/IEC/IEEE 26514 §8
審查是流程的一部分	標準	在開發過程中進行驗證與確效測試 Spec Spec: ISO/IEC/IEEE 26513, §Foreword ISO/IEC/IEEE 26513 §Foreword
證據等級可優先被辨識出來	標準	辨識優先於回想 Spec Spec: ISO 9241-110, §5.6.2 ISO 9241-110 §5.6.2
無逐字受授權文字；已釘選參照	儲存庫內	docs/style/nextpdf-overrides.md §5；composer docs:jaccard-fingerprint
服務中斷後備是一套真實的協定	儲存庫內	具規範性的 RAG 後備治理，加上離線的 docs:rag-fallback-check 關卡

實際範例

這套紀律是具體的：它就是一個頁面 citations 前置資料的結構。每一筆條目都是一項主張的收據。

excerpt: an Insider_ page's citations front-matter

citations:
  - spec: "ISO 32000-2"
    clause: "§6"
    # full 64-char reference ID — the join to the source span, re-verifiable
    reference_id: "<64-hex digest>"
    # NextPDF-worded topic — the paraphrase, never the standard's text
    topic: "A writer's created or amended PDF elements must conform and stay consistent"

依設計，這裡沒有 quote 欄位。topic 是 NextPDF 自己的重述。reference_id 則是審查者得以回到確切來源、查核那段重述的方式。這份收據承載的是指向證明的指標，而非證明的原文。

常見的誤解

陷阱在於把「改寫、不要引用」讀成一種模糊其詞——一種不做出承諾、卻聽起來權威的方式。事實恰恰相反。引用什麼都不承諾；它借用的是別人的文字。一段經引用的改寫，則讓撰寫者對一段重述做出承諾，而審查者可以對照來源加以證偽。這套紀律讓主張更需要負責，而不是更少。

第二個陷阱，是把「編輯類」當成「以標準為依據」的較弱等級。它根本不是較弱等級；它是一種不同的種類。像本頁這樣的編輯類頁面，會組織並說明其他證據。它被正確地標示了。而這個標示正是重點所在：這套系統之所以能運作，是因為一個頁面會在你決定要賦予它多少份量之前，先告訴你它所提供的是何種證明。

限制與邊界

本頁規範的是引用紀律；它不是樣式表、不是後備治理，也不是關卡程式碼。具權威性的產物都在儲存庫內（docs/style/nextpdf-overrides.md §5、具規範性的 RAG 後備治理、composer.jsondocs:* 指令稿），若有分歧，它們優先於此處的任何摘要。它不主張任何引擎行為。

這套紀律約束的是主張，而非讀者的結論。一段忠實且有引用依據的改寫，告訴你某條款要求什麼。NextPDF 的解讀是否正是你的義務所需，仍然由你決定，這也正是為什麼涉及行為的頁面也會帶有以程式碼或測試為依據的證據，而非僅以標準為依據。誠實地說，強制執行是部分性的：離線後備檢查已上線，而逐字引用與即時引用的驗證器雖已接好，其完整的執行器仍在完成中——這被陳述為進行中，而非已完成。

相關文件

• 文件即產品——這套引用系統所屬的更廣泛品質紀律。
• 標準全景——這些引用所指向的標準，以及一條條款如何成為有文件記載的行為。
• NextPDF 測試金字塔——當一個頁面宣稱的是以測試為依據的等級，而不是本頁這個等級時，這代表什麼意思。

詞彙表

• 引用紀律——一套規則，規範一項 Insider_ 主張如何連結到其來源：改寫、引用條款、釘選一個 reference ID，絕不引用受授權保護的標準。
• 改寫——以 NextPDF 自己且與詞彙表一致的語氣重述一項要求；這是取代引用的理解力測驗。
• reference_id——一個完整 64 字元的完整性指標，指向某段改寫所依據的確切來源段落，並予以記錄，讓審查者得以重新取回並驗證它。
• 證據等級——一個頁面的主張背後所宣告的證明種類，為八種之一（以程式碼、標準、測試、基準、產物為依據，以及設計原則、編輯類、混合），顯示在徽章列中。
• 未解決的引用——一項 reference ID 因真正的取回服務中斷而無法釘選的主張；它會被保留、相對於一份重新釘選帳本標記，並暫不發布，而非被偽造。