《Day 03:拆解寫作工作流,規劃、撰寫、視覺、審查的四種角色》 結尾留下一個還沒有名字的東西。規劃代理人交給寫作代理人的東西,究竟要用什麼共同的格式或依據,才能讓下游角色明確知道該做什麼、不該做什麼,這個共享的地基當時還沒有名字、還沒有樣貌。今天要做的第一件事,就是替這個地基正式命名,並且把它的樣貌講清楚。
這個地基的名字叫做 Section Spec。它是規劃代理人與寫作代理人之間的正式交接介面,規劃代理人產出它,寫作代理人依循它展開內容,兩者之間不再需要靠猜測對方真正想表達的意思。
在往下展開之前,先把今天的任務範圍界線畫清楚。今天只定義這份交接格式本身長什麼樣子、為什麼需要它,不涉及規劃代理人的系統提示詞該怎麼寫,那是後面階段三才要處理的範疇。今天也不涉及多天之間如何維持用詞或架構決策的一致,那個問題會留給明天處理。今天只回答一件事,單篇文章內部,規劃代理人怎麼把一天份的規劃決策,交接給寫作代理人。
昨天讀完角色分工之後,一個很自然的直覺可能會冒出來:規劃代理人只要講清楚重點不就好了,何必再搞一套格式。這個直覺值得認真回應,因為它背後藏著一個容易被忽略的陷阱。
想像一個畫面。規劃代理人心裡想著這段要強調某個技術細節的原理,但實際交代的時候,只用一句話帶過,說這段大概要講一下這個機制,帶到一些重點就好。這段描述聽起來已經溝通過了,但裡面沒有清楚切分出哪些是必須覆蓋的重點、哪些只是背景鋪陳、哪些是不該踩入的範圍。寫作代理人拿到這句話之後,只能自己從這段文字裡去猜測規劃代理人真正想強調的是什麼,這段的論證邊界又落在哪裡。最後可能選擇把篇幅重心放在自己覺得更好發揮的另一個方向,等文章交回規劃代理人手上,重點完全對不上,兩邊都覺得自己沒有錯。
這個「自己猜測重點」的動作,本質上正是《Day 02:產出優先思維,先定義規格再動筆》 定案的輸入優先思維,先看手上拿到的東西,再自己決定要輸出什麼,而不是先有清楚的產出目標再展開。交接依據一旦退回模糊的自然語言,即使規劃代理人與寫作代理人各自都恪守 Day 03 定義的職責邊界,寫作代理人依然會被迫在撰寫過程中重新扮演一次規劃者的角色,自己補上規劃代理人沒有講清楚的那部分決策。
這也會讓《Day 01:為什麼傳統的「一鍵生成」寫不出好的長篇技術文章?》定案的病灶重新冒出來。沒有清楚定義的段落邊界,寫作代理人很難判斷自己寫出來的內容是否偏離了規劃代理人原本設定的深度與方向,內容漂移就在規劃與撰寫的交界處悄悄發生。出了問題之後,也很難精準定位是哪一段出錯,只能整篇重新檢視,零容錯結構的困境同樣在這個交界處重新出現。角色分工本身並不會自動保證交接品質,交接依據如果停留在自然語言的模糊地帶,分工再清楚,兩邊依然可能各說各話。
這個道理其實很接近軟體開發裡熟悉的一件事。兩個獨立模組之間如果沒有明確的介面合約定義輸入輸出,即使雙方各自都寫出品質很好的程式碼,串接的那一刻依然會出錯。《Day 02:產出優先思維,先定義規格再動筆》已經談過先定義 API 合約再實作內部邏輯的意象,Section Spec 正是這個工程直覺在寫作場景裡的具體實踐,規劃代理人與寫作代理人之間,同樣需要一份雙方都認得的合約,把交接依據從模糊描述,轉化為可以被檢驗、可以被依循的結構化規格。
Section Spec 至少需要包含四個欄位,核心目標、前置概念、段落規格、結尾伏筆。每個欄位存在都有明確的目的,也各自對應著缺少它時會冒出來的具體問題。
核心目標,是這篇文章要讓讀者學到或理解的唯一目標,用一句話講清楚。它存在的目的,是替寫作代理人建立一個可以隨時校準自己有沒有寫偏的錨點。缺少這個欄位時,寫作代理人容易在展開細節的過程中,把篇幅重心放在自己覺得有趣或容易發揮的地方,而不是規劃代理人真正想強調的重點,這正是內容漂移在單篇內部的縮小版。
前置概念,明確列出這篇文章可以假設讀者已經具備哪些概念,以及這些概念是在哪裡被定義的。它存在的目的,是替寫作代理人劃出一條清楚的界線,哪些東西不需要重新解釋,哪些東西是本篇第一次出現、必須完整定義。缺少這個欄位時,寫作代理人要嘛過度解釋讀者早就懂的東西,造成篇幅浪費與閱讀疲乏,要嘛誤以為讀者已經懂某個其實還沒被定義過的概念,導致論證出現斷層。
段落規格,針對每一個預計出現的段落,定義這段要論證什麼、要引用哪個前提、必須帶到哪些具體重點,而不是寫出這段的內容本身。它存在的目的,是把整篇文章的論證骨架先固定下來,讓寫作代理人知道每一段的任務邊界在哪裡。缺少這個欄位時,寫作代理人只能拿著模糊的整體方向自己去分配段落,容易出現段落之間論證重複、或者該講的重點在段落交界處遺漏掉下去的狀況。
結尾伏筆,明確定義這篇文章結尾要埋下什麼懸念,以及這個懸念如何自然導向下一篇的標題或主題。它存在的目的,是確保多篇文章之間的銜接不是寫作代理人臨時起意加上去的裝飾句,而是規劃階段就已經設計好的敘事節點。缺少這個欄位時,文章結尾容易變成單篇獨立的總結,讀完就結束,系列與系列之間失去了讀者持續往下讀的敘事動力。
這四個欄位對應的問題,覆蓋範圍剛好互不重疊。核心目標校準的是整篇的重心,前置概念校準的是知識邊界,段落規格校準的是內部骨架,結尾伏筆校準的是篇與篇之間的銜接。四者合起來,才構成一份完整的交接介面,缺少任何一項,交接過程都會出現對應的破口。
有了這四個欄位之後,容易冒出另一個混淆,規格書寫得夠詳細,是不是就等於文章寫完了。答案是否定的,這條界線值得特別強調。
段落規格裡寫的是「這段要論證什麼、要引用哪個前提」,而不是「這段的內容本身」。兩者看起來都是文字,但功能完全不同,前者是給寫作代理人看的施工圖,後者才是真正要交給讀者看的成品。如果規劃代理人在段落規格裡寫得太過具體,等於是替寫作代理人把正文先寫好一部分,這會讓寫作代理人的查證與展開空間被壓縮,也會讓 Day 03 定案的「規劃代理人不撰寫任何一句會出現在成品中的正文」這條職責邊界名存實亡。
Section Spec 的價值,正是停留在施工圖的層次就夠了。它負責把論證骨架與交接邊界定義清楚,實際把血肉填上去,查證每一個技術細節,這是寫作代理人的工作,不該被規劃代理人越界代勞。
今天正式定案了 Section Spec,這是規劃代理人與寫作代理人之間的正式交接介面。透過核心目標、前置概念、段落規格、結尾伏筆這幾個欄位,把交接依據從模糊的自然語言描述,轉化為可以被檢驗、可以被依循的結構化規格,讓寫作代理人不必再靠猜測工作。
但這只解決了單篇文章內部的交接問題。系列長達 35 天,某一天定義的名詞或架構決策,後面好幾天都要沿用。如果每一天都只靠一份獨立的 Section Spec 工作,遇到需要跨天保持一致的地方,第 20 天的規劃代理人要怎麼確保自己沒有遺忘或誤用第 8 天已經定案的用詞與決策,這個問題今天還沒有答案,將在《Day 05:系列的單一事實來源,打造全域錨點檔案》正式揭曉。