開發主題
將候選主題轉化為已核准的內容合約。僅當論點、證據和邊界不再需要下游自行發明時,工作才算準備好可以開始寫作。
範圍
從一個候選主題或一個小型、自然封閉的集合開始。當存在數個相近方向時,可根據受眾價值、新穎性、可驗證性、可展示性、作者契合度以及過度宣稱風險進行輕量比較;要求用戶在深入研究前做出選擇。開放式的趨勢掃描和維護點子庫不在此技能範圍內。
證據工作區
在影片專案中建立一個 content/ 目錄:
content/
|-- RESEARCH.md
|-- TOPIC.md
`-- experiments/
使用 RESEARCH.md 記錄有來源的事實、詮釋、分歧點、未知項、被否決的方向,以及主要資料的連結。保持資料收集與編輯選擇分離。
當一項主張會影響該主題是否可行、對受眾是否重要、與替代方案是否不同、能否被展示、或是否在所陳述的範圍內有效時,將其視為實質內容。為該主張提供足以支持的來源或實驗,並對較弱的證據標示為 provisional(暫定),而非默默誇大其效力。
當某項主張需要可運行的證據時,執行能解決該問題的最小實驗,並撰寫 content/experiments/<name>.md,內容包含問題、方法、樣本、環境、命令、結果、限制以及結果所支持的結論。將程式碼和原始資料保留在其所屬的專案中;記錄其路徑和 Git 修訂版,而非將其複製到影片專案內。
內容合約
撰寫 content/TOPIC.md:
---
status: draft
audience: ...
core_question: ...
thesis: ...
scope: ...
voice:
language: ...
skills: []
documents: []
unavailable: []
status: resolved | assumed
---
# 工作標題
## 對讀者的承諾
## 論證
### A01 - 主張
- role: 此主張存在於論證中的原因
- claim: 確切的命題
- evidence: 指向 RESEARCH.md 標題或實驗報告的連結
- confidence: established | provisional
- boundary: 證據未建立的範疇
## 超出範圍
## 開放問題
## 替代標題
聲音來源的解析順序如下:明確的用戶指示、專案或品牌指南、可用的且符合語言與內容類型的寫作風格技能、可見的用戶偏好、寫作範例,最後是清晰說明的預設值。記錄實際使用的來源,並將要求提供但不可用的來源記錄在 voice.unavailable 下;不要假設無法獲得的記憶或隱藏設定檔。
核准關卡
展示工作標題、論點、範圍、論證、關鍵證據、邊界以及重要的開放問題以供審查。標題可以持續變動,但受眾、論點、範圍、論證、證據和結論邊界是鎖定的決策。
僅有明確的用戶核准才能將 frontmatter 變更為:
status: approved
approved_at: YYYY-MM-DD
approved_digest: sha256:<digest>
摘要(digest)是移除 approved_digest: 行後整個檔案的 SHA-256 雜湊值。在信任核准狀態之前必須重新計算摘要。若比對不符,則核准被視為失效,文件狀態恢復為 draft。在經過驗證的非實質性標題或副本編輯後,摘要可以在無需重新核准的情況下更新;將新的摘要傳播到每個依賴的成品。
在此之前,所有寫作應保留在 RESEARCH.md、實驗報告以及 TOPIC.md 草稿中。不要建立 ARTICLE.md 或 BEATS.md;快速行動的要求或選擇論點的權限,並不能取代對結果合約的核准。
後續對鎖定決策的實質性變更,會將 TOPIC.md 恢復為 draft 狀態,並使下游的文章核准失效。副本編輯、範例以及保留原意的標題變更不會撤銷核准。
在展示 content/TOPIC.md 或任何後續修訂版本之前,請遵循 ../boring-video/references/markdown-review.md。將標準的 Markdown 路徑保留為當前版本,並在此處套用審查回饋。
當 TOPIC.md 已核准、每個實質主張都有充分的證據支援、剩餘的開放問題不具阻礙性且可見、文章作者無需自行發明事實、實驗、作者立場、論點或範圍即可起草,且 Markdown 審查完成條件已滿足時,主題開發即告完成。