Project Architect

它適合什麼工作，以及為什麼是它

當代價高昂的錯誤是「方向錯了」而不是「某一行寫錯了」時，就適合用它：例如一個新服務、一個必須融入既有程式庫的小工具，或是一個你只有粗略想法、還沒有寫下任何決定的重寫案。它的方法是「先寫文件」——先訪談你，再把計畫寫下來，最後產生一段用來一次建置完成的提示詞。

用它的理由不是它比較聰明，而是它的順序。它自己的指示把文件排成固定順序，並且禁止跳步：先有規格，才有實作計畫，也才有工作清單。單憑一段很長的提示詞得不到這個保證，因為沒有任何機制阻止你先要工作清單。

什麼情況不該用它

它是規劃介面，不是建置工具。如果你已經知道方向，而且工作只是幾處修改，那場訪談就完全是額外負擔：它會在動筆前先問專案類型、對象、範圍與技術堆疊，而你會被迫回答早就決定好的問題。

如果真正的不確定性不在結構上，它也不適合。假如風險來自一個還沒驗證過的函式庫、一個第三方 API 或效能問題，那一套規劃文件會寫得很好看，卻什麼都沒解決；這種風險必須先做一個小實驗排除掉，計畫之後再寫。

它的外掛感知是為某一個生態系寫的。指示要求代理去尋找其他已安裝的外掛，並把它們的標準納入計畫；在那個生態系裡很有用，但在沒有外掛註冊表的環境裡則完全不起作用。

它需要什麼，以及會產出什麼

前置條件是一場對話，而不是一份輸入檔。動筆之前，它要知道一句話說明的專案目的、使用對象、專案類型、這是第一版還是完整產品，以及技術方向——或者你直接要求它幫你選，那會切換到一套選項流程，把利弊並列給你，而不是替你決定。

產出會寫成檔案，放在工作目錄裡該專案自己的文件資料夾底下，而不是留在對話裡：一份說明專案是什麼的規格書、一份涵蓋結構、相依套件與模組介面的實作文件、一份把每個項目控制在單次代理工作階段可完成的工作清單，以及一份選用的品牌文件。最後一項產出是一段完整獨立的提示詞，設計目標是不必打開前面幾份文件，也能帶著完成建置所需的全部資訊。

動手前有兩項限制值得知道。檔案配置與順序規則是作者的指示，因此不遵循這些指示的環境，會用不同順序、較不一致地產生同樣的文件。另外，最後那段提示詞的命名與「完整獨立」只是一種慣例，不是契約：沒有任何機制檢查它寫出的提示詞是否真的自足，所以那正是你自己該讀過的部分。

工具支援、權限與相依性

鎖定版本的 front matter 宣稱，任何能讀寫檔案並向使用者提問的程式開發代理都可用，並指名兩個代理為最佳化目標，另列數個為相容。這是作者的說法；本清單不測試代理，所以請把它當成你自己驗證的起點，而不是結論。

權限範圍比表面上看起來更寬，原因在於寫檔。指示要求代理把每一份文件存進工作目錄，因此在既有程式庫裡執行它，會替該程式庫新增一個裝滿規劃文件的資料夾。若環境還允許代理自行選擇檔案位置，這些檔案可能出現在你沒預期的地方。第一次執行前，先決定產出應該落在哪裡，以及那個目錄是否要提交進版本控制。

互動部分與特定工具有關。有幾個階段是設計成請使用者從簡短清單中選擇，而指示明確指名了那個提問工具。當該工具不存在時，流程會退化為自由文字問答；這仍然可用，但會變成這個技能原本想避免的那種較慢、較含糊的訪談。就規劃本身而言，它不需要網路、不需要執行腳本，也不需要安裝任何套件。

和「直接寫一段提示詞」相比

如果你的工作只是一個檔案、一個下午，自己仔細寫一段提示詞會更快，而且其中每一個決定你都理解。你失去的是那份清單：訪談流程的價值在於把你沒想到要問的問題挖出來，而單一段提示詞只會寫進你原本就已經想到的問題。

反過來說，如果你已經寫好計畫——一份真正的規格書與一份有順序的工作清單——這個技能除了重新排版之外幫助有限，甚至可能重排你刻意做出的決定。誠實的判斷標準是：你現在能不能把計畫交給別人，讓對方完全不問你就做出來。如果可以，你不需要它。

如何自己驗收成果

文件本身就是交付物，所以在讓任何東西依它建置之前，先把它們當文件來檢查。

• 只讀工作清單，逐項問：這一項能不能不靠對話就做完。「把後端弄好」不行；寫明要動哪些檔案、怎麼樣算完成才行。
• 在規格書裡找你記得自己做過的一項決定，確認文件寫出了它以及理由。只記結論、不記理由的計畫，日後無法重新評估。
• 單獨打開最後那段提示詞，試著只靠它建置，不要開其他檔案。每次你得回頭翻文件，就是提示詞宣稱不存在的一個缺口。
• 檢查計畫沒有任何一處與自己記錄的範圍互相矛盾。工作清單忽略了「先不做」清單，是這類文件彼此不一致最常見的方式。

來源、版本，以及實際讀過的範圍

上面這些判斷是針對該專案的某一個固定版本寫成，也就是本頁上方顯示的那個提交。若日後紀錄移到另一個提交，這份導讀會停止顯示，而不是繼續對著沒有人重新讀過的程式碼呈現。

本導讀實際讀過的範圍：該提交下的專案進入點檔案，其中包含 front matter、階段清單、操作規則與產出流程。這就是全部依據。進入點檔案中提到的其他參照文件並未開啟，沒有安裝或執行任何檔案，沒有解析任何相依性，也沒有執行任何代理。因此，關於那四份文件實務上會長成什麼樣子的敘述，是對指示本身的推論，而不是對實際產出的觀察。