Trigpoint
Collections 書架 › 方法解說

prompt-architect

先定方法,再寫提示詞

版本:v0.3.x · 文章版本 1.4

手寫的提示詞,常在兩處出問題。第一處是寫了角色和任務,卻沒寫任務該怎樣做:要經過哪些判斷、怎樣才算做好、答案分成哪些欄位。這些空位由模型自己補上,每次補法都不一樣。

第二處是沿用為舊模型寫的寫法。廠商的提示詞指南隨模型改版,頁面本身也會搬動。我們在其中一輪測試裡就遇到兩處:一份 Gemini 指南頁自標已棄用(deprecated),Codex 的文件頁則轉址到新網域。憑記憶寫下的「某家要用某種格式」,很可能已經過時。

本文介紹一套把這兩件事分開處理的程序:先把任務方法定好,再按目標平台的現行官方指南寫成提示詞;以及執行它的 agent skill。

程序

程序分兩層。第 1 至第 4 步與平台無關,各步的組成沿用各家官方指南;把它們排成這個順序、並與平台慣例分開,出處是 Trigpoint(2026)。這是一套工作方法,不是研究結果,未與其他提示詞寫法比較過。第 5 步每次執行時重新查。

1. 判定任務類型。常見的有:摘要或擷取、生成或寫作、審查或評估、分類或分派、對話或支援、轉換或翻譯。類型決定後面三步怎樣寫。用途混合幾類時,定一個主類型,並記下次類型。

2. 拆解任務。寫明任務由哪些子任務組成、途中要作哪些決定、每個決定依據什麼,按任務類型而定。審查型:要評估哪些維度;每個維度以什麼為證據、什麼算反證;最後要下哪個判斷,例如每項條款的風險等級。摘要型:要找出什麼(核心論點、各部分的關係),要挑出什麼、按什麼準則挑(最有價值、最能直接用上的幾點)。子任務有先後時,例如判斷要建立在證據之上,寫明次序。這一步只寫任務本身;模型怎樣思考,不在這裡規定。要不要在提示詞裡另外要求逐步推理或末段自我檢查,要看目標模型會不會自行推理,屬平台問題,留待第 5 步按官方頁決定。

3. 訂下可以核對的成功標準。寫別人可以逐項檢查的標準,不寫形容詞。以摘要為例:每一點都寫出支持它的論證與適用範圍;數字與公式照錄;核心主張沒有遺漏。「高品質」「清楚」「吸引人」這類詞,除非說明什麼現象能證明它,否則不用。

4. 固定輸出欄位。定下答案有哪些欄位、次序如何、每欄放什麼。以摘要為例:原則,接兩至三項支持細節,再寫怎樣應用,最後列出要點。

5. 讀目標平台的現行官方指南。從廠商的通用提示詞指南與最新模型(或模型總覽)頁讀起,有該型號的專頁再往下讀。要找的是:建議的提示詞結構、推理或 effort 設定(包括提示詞該不該要求逐步推理或自我檢查)、該模型建議刪去或避免的指示、輸出格式慣例,以及模型是否標為 preview、beta 或 legacy。每一點記下網址與讀取日期。頁面沒有寫的,就不寫進提示詞,也不用記憶中的技巧填補。

只給產品名時,要多做一步。聊天產品不等於 API,產品背後用哪個模型,可能取決於方案、用戶端與設定。這時先寫明假設哪個模型,並引一頁支持這個假設;讀過的頁面都定不了,就寫「模型未知」,只採用不依賴型號的建議。

6. 合寫成一份可直接貼上的提示詞。方法決定內容,平台決定寫法。只用目標平台一家的慣例;寫出實際的任務拆解、標準與欄位,不只列「角色/任務/限制/輸出」幾個標題;限制盡量寫成有量度的目標,例如「最多 200 字」;提示詞單獨貼上即可運作,不帶來源編號,也不提及本方法;除非用途本身是閒聊或社交,不以 emoji 或裝飾符號作段落記號。

交出的結果分三部分:一行摘要,寫明用途、平台與模型、任務類型;提示詞本身,只貼這部分;使用說明,列出假設的模型與理由、採用的廠商慣例、須在提示詞以外調整的設定,每項附來源網址與讀取日期,並寫明頁面沒有涵蓋的地方。

為什麼不附各家寫法表

廠商的提示詞寫法隨每次模型發布而變。預先整理好的寫法表,下一次發布就可能過時;廠商自己的頁面才是權威,而且本來就公開。所以 skill 不附這樣一張表。

skill 只帶一份來源清單,記錄各廠商在哪裡發布提示詞指南,由執行的 agent 每次去讀原頁。清單本身也會老化。遇到打不開的連結,skill 要求先分辨頁面已消失,還是只有讀取工具被拒;頁面消失,就找廠商現行的對應頁,並在使用說明寫明。

讀不到網頁時,skill 會先說明,請你貼上相關指南的原文;你也可以讓它只按第 1 至第 4 步,用通用結構(角色、背景、任務、限制、輸出格式)寫,並在使用說明註明未查官方指南。沒有官方提示詞指南的平台,例如建在別家模型之上的工具:知道底層模型,就讀該模型廠商的指南;不知道,就用通用結構。根據你上傳的文件作答的工具,提示詞會要求答案引用那些文件,並在文件沒有涵蓋時直說。

筆記本與 skill 的分別

本站另有一本公開的 NotebookLM 筆記本「全動態提示詞引擎」,列在筆記本頁。它同樣是寫明用途與目標平台,就產出一份可直接貼用的提示詞。兩者出自同一套方法,但不是同一件東西:

  • 筆記本在 NotebookLM 裡使用,不用安裝。它依據筆記本內匯入的廠商官方文件作答,這些來源在筆記本改版時更新。筆記本有自己的版本號,與 skill 的版本無關。
  • skill 裝進你自己的 agent 使用。它不帶預先整理的廠商規則,每次執行都去讀廠商的現行官方頁,並在使用說明逐點附上網址與讀取日期。

只想先試這套方法,用筆記本較方便;要在自己的 agent 工作流裡反覆使用,並要求每項平台建議都有當日可查的出處,用 skill。

這套方法早前在 Substack 以「全動態提示詞基建法」為題,分兩篇介紹過:2026 年 3 月的首篇,以及 6 月的 2.0 版。兩篇所附的設定指令與筆記本,現已由本站的筆記本與 skill 取代,不再另行提供。

目前的成效

skill 的首個公開候選版(0.1.0)用六個練習請求測試:四類任務、三家廠商,另加一個沒給平台、一個沒有官方指南的工具。檢查的是:提示詞含實際的推理步驟、可核對的標準與輸出欄位;可以單獨貼用;每項平台設定都能追溯到當次讀過、附網址與日期的官方頁;官方頁說要刪的指示沒有出現;沒給平台時,只回一個問題。

  • 第一輪在 Codex 桌面版上跑,六個中四個通過。兩個失敗:一個為假設的模型引了一頁根本沒寫那個模型的頁面;一個在沒給平台時問了問題,卻多加解釋。修改 skill 後重跑其中三個,全部通過。
  • 第二輪在另一台主機(Claude Code)上,沒有安裝,直接指定 skill 的路徑:三個請求通過。另造一條失效連結,agent 指出失效、改讀廠商現行頁,並在使用說明寫明。
  • 來源清單更新後,回到 Codex 主機再跑三個請求,全部通過。另一個讀取被拒的情況(指定先用一般 HTTP 請求),agent 改用其他工具讀到同一頁,並寫明是被拒,不是頁面消失。清單 28 條連結當日全部可開。
  • 0.2.0 同樣在 Codex 桌面版上測:原有六個請求,加上三個寫明模型的新請求,全部通過,包括新增的一項檢查:每次只打開目標廠商的來源檔。請求只寫產品、沒寫模型時,skill 回答「模型未知」,只用不依模型而定的建議;要得到針對某個模型的建議,請寫明模型。
  • 0.3.0 把第 2 步由「寫出推理步驟」改為「拆解任務」,第一項檢查隨之改為「提示詞含實際的任務拆解」。改版後在 Claude Code 上重跑同樣九個請求,沒有安裝,直接指定 skill 的路徑:八個通過。失敗的一個是 Codex 上的摘要請求:一條使用說明掛在 Codex 的官方提示詞頁名下,該頁並沒有這句;這句來自測試主機自己存的筆記,skill 與廠商頁都沒有。產出的提示詞都沒有替模型寫推理腳本;要不要求逐步推理或末段自我檢查,都按目標模型的官方頁決定。0.2.0 答「模型未知」的兩個只寫產品的請求,這次都寫明了假設的模型並附出處,第 5 步容許這樣做;只寫產品時得到哪一種回答,可能隨輪次與主機而不同。

這些檢查看的是提示詞有沒有照方法寫成、平台建議能不能追溯到官方頁,沒有看提示詞實際用起來的效果。產生的提示詞尚未在目標平台上以真實資料試跑;Codex 以外的宿主未測安裝;沒有網路、同一請求重複執行,都未測。每次測試都是一個請求跑一次,由協調測試的 agent 評分,不是盲測。測 0.1.0 時,每個請求耗時 13 至 344 秒;有讀數的兩輪中,每個請求約用 8.4 萬至 40.7 萬個 tokens(Codex 主機的數字含重複計入的快取輸入)。

適用時機

適用於要反覆使用的提示詞:系統提示、custom instructions、會在同一平台長期跑的任務。提示詞的質素取決於用途寫得多清楚;用途越具體,第 1 至第 4 步越有東西可定。用途還說不清時,先寫下三件事再交給 skill:結果要幫你做什麼判斷或行動;什麼必須保留、什麼不准出現;結果不可變成什麼。一次性的簡單提問直接問就好,為它讀幾家廠商的官方頁並不划算。skill 也不會測試它寫出的提示詞:正式依賴之前,先在目標平台用真實輸入試幾次。

取得 skill

skill 放在 GitHub:github.com/trigpoint-pub/agent-skills 的 skills/prompt-architect。目前版本 0.3.0,2026-11-07 以 experimental prerelease 發布(Release 頁)。使用前提:一個能載入 SKILL.md 格式 skill 的 agent,以及可以上網讀廠商頁面。安裝只在 0.2.0 時於 macOS 上的 Codex 桌面版驗證過,skill 資料夾結構其後未變;0.3.0 在 Claude Code 上以直接指定 skill 路徑的方式測過,未測安裝。

裝好之後,可以這樣開始:

用 prompt-architect:寫一份審查供應商合約、標出風險條款的提示詞,在 Claude 上用。

回覆應分三部分:摘要、提示詞、使用說明。先看使用說明:每一項平台建議都應附有官方頁網址與讀取日期,沒有出處的平台建議不應出現。完整的第一次使用教學(中英對照,以一份合成的會議紀錄為例)見 FIRST-USE.md。

測試紀錄在 VALIDATION.md,方法來源與清單維護方式在 docs/prompt-architect/SOURCES.md,兩者都不隨 skill 安裝。官方來源清單按廠商分檔,入口是 references/official-sources.md:檔中寫明該開哪一檔,檔首記有最近一次核對日期。問題回報請用 GitHub Issues,不承諾回覆時限。