轉為文章
將已核准的 content/TOPIC.md 轉換為 content/ARTICLE.md:這是部落格文章與影片計畫兩者最終都會使用的可讀內容主體。
前置條件
閱讀 content/TOPIC.md、content/RESEARCH.md、每份被引用的實驗報告,以及驗證所選證據所需的原始資料。僅在 TOPIC.md 的 status: approved 時才繼續。
當寫作過程中發現遺漏的素材主張、矛盾的證據、不支援的結論,或需要變更已核准的受眾、論點、範圍、論證、證據或結論邊界時,返回 /develop-topic。立即將 TOPIC.md 的 status 改為 draft,在該處解決缺口,並在重新撰寫文章前重新取得主題核准。增加會改變信心水準、邊界或解釋的證據屬於實質變更;增加同等來源但未改變契約內容則不屬之。
語調
從已核准的主題解析文章語調。在草擬前,檢查可用的技能,找出與輸出語言及內容類型匹配的寫作風格技能,然後載入 voice.skills 或 voice.documents 中命名的所有適用的使用者、專案或品牌風格來源。
如果沒有可靠的來源可用於出版級文章,提出一個簡潔的問題,詢問所需的語調或範例。當使用者委託選擇,或文章明確是內部草稿時,使用清晰的說明性預設值,並記錄 voice.status: assumed。將無法取得的命名來源記錄在 voice.unavailable 下;這些不代表其規則已被應用。當有其他可用來源能解析語調時,無法取得的來源不會阻擋草稿程序。
草稿
撰寫一篇完整、獨立於平台的文章。文章必須能獨立閱讀,保留已核准的論點與邊界,區分事實與解釋,並為實質主張引用原始來源。當有助於閱讀時,可使用標題、連結、表格或註解;特定於網站的 SEO 欄位、發布元件及平台路徑則留待後續的發布改編處理。
寫入 content/ARTICLE.md,並包含以下前置資料:
---
source: content/TOPIC.md
source_digest: sha256:<TOPIC approved_digest>
status: draft
voice:
language: ...
skills: []
documents: []
unavailable: []
status: resolved | assumed
---
文章可以改善工作標題、散文、範例與章節順序。可以壓縮或解釋已核准的主張,但每個實質事實、觀點與結論都必須能追溯至已核准的主題及其證據。新內容必須先回到上游。
審批門檻
呈現完整的文章供審查。只有使用者明確核准才能將其前置資料變更為:
status: approved
approved_at: YYYY-MM-DD
approved_digest: sha256:<digest>
計算 approved_digest 的方式是:移除整個檔案中僅包含 approved_digest: 的那一行後,對其餘部分進行 SHA-256 雜湊。在草擬或核准前,重新計算主題摘要,並要求其必須與 TOPIC.md 的 approved_digest 以及此文章的 source_digest 相符。不符會導致相關核准或依賴草稿過時。已驗證的非實質編輯可以重新整理並傳播摘要,而無需重新核准。
在此之前,不要建立 BEATS.md。要求繼續製作並不等同於核准文章本身。
對 TOPIC.md 的實質修訂會使文章回到 draft 狀態。對已核准文章的實質修訂也會使其回到 draft 狀態;保留已核准意義的副本編輯、標題變更與範例則不會。
在呈現 content/ARTICLE.md 或任何後續修訂版之前,請遵循 ../boring-video/references/markdown-review.md。將規範性 Markdown 路徑作為目前版本,並在該處套用審閱意見。
當文章已核准、可獨立閱讀、每個實質陳述都能追溯至已核准的內容契約與充分證據、影片規劃者可以在不憑空編造事實、觀點、論證或範圍的情況下重新組織文章,且 Markdown 審閱完成條件已滿足時,文章即為完成。