一、先建立一個(gè)共識(shí)：提示詞是工程資產(chǎn)，不是聊天技巧

對(duì)提示詞最大的誤解，是把它當(dāng)成"說(shuō)話的藝術(shù)"——覺(jué)得輸出不好是自己不會(huì)問(wèn)，再試幾次就行。在個(gè)人使用場(chǎng)景里這種想法問(wèn)題不大，但在團(tuán)隊(duì)場(chǎng)景里它是質(zhì)量波動(dòng)的根源：提示詞散落在每個(gè)人的腦子里和聊天記錄里，好的問(wèn)法沒(méi)法復(fù)用，差的問(wèn)法反復(fù)出現(xiàn)，換一個(gè)人接手，輸出質(zhì)量就退回原點(diǎn)。

正確的定位是把提示詞當(dāng)成和代碼、配置同級(jí)的工程資產(chǎn)：它有版本、有評(píng)審、有適用場(chǎng)景、有負(fù)責(zé)人。一個(gè)好的代碼**提示詞模板，價(jià)值不亞于一個(gè) lint 規(guī)則集；一個(gè)穩(wěn)定的發(fā)布說(shuō)明模板，省下的時(shí)間每周都能看見(jiàn)。觀念轉(zhuǎn)過(guò)來(lái)之后，后面的模板化、格式控制、質(zhì)量評(píng)審才有立足點(diǎn)。

• 輸出質(zhì)量不穩(wěn)定，先查提示詞是否統(tǒng)一，再懷疑模型能力。
• 個(gè)人調(diào)出來(lái)的好提示詞，必須沉淀成團(tuán)隊(duì)模板才有長(zhǎng)期價(jià)值。
• 提示詞變更要像代碼變更一樣可追溯：誰(shuí)改的、為什么、效果如何。

二、從統(tǒng)一入口開(kāi)始：在靈能API上驗(yàn)證模板的真實(shí)效果

提示詞模板的第一個(gè)坑，是"在我機(jī)器上好用"。同一個(gè)提示詞在不同模型、不同上下文長(zhǎng)度、不同輸入規(guī)模下表現(xiàn)差異很大，而團(tuán)隊(duì)里每個(gè)人本地測(cè)的樣本量太小，結(jié)論往往不可靠。進(jìn)入 靈能API 后，可以利用統(tǒng)一入口的優(yōu)勢(shì)做一件事：把候選模板放在同一批模型、同一批樣本上對(duì)比驗(yàn)證。官網(wǎng)入口可以直接記錄為 https://www.lnsns.com/，建議把"模板驗(yàn)證環(huán)境"寫進(jìn)團(tuán)隊(duì)文檔，注明驗(yàn)證時(shí)用的模型和樣本集。

統(tǒng)一入口的另一個(gè)好處是結(jié)果可比。所有驗(yàn)證請(qǐng)求走同一個(gè) *ase **L、同一種調(diào)用方式，排除了環(huán)境差異的干擾。某個(gè)模板在 A 模型上表現(xiàn)好、在 * 模型上翻車，這種結(jié)論只有在統(tǒng)一入口下才可信——如果每個(gè)人用自己的接入方式測(cè)，變量太多，比出來(lái)的結(jié)論沒(méi)法指導(dǎo)團(tuán)隊(duì)決策。

模板驗(yàn)證記錄建議：
- 模板名稱和版本號(hào)
- 驗(yàn)證用的模型 ID 和調(diào)用參數(shù)
- 樣本集編號(hào)（固定樣本，便于橫向?qū)Ρ龋?- 驗(yàn)證結(jié)論：通過(guò) / 需調(diào)整 / 不適用
- 驗(yàn)證人和日期

• 模板入庫(kù)前至少在目標(biāo)模型上跑過(guò)固定樣本集，不允許"憑感覺(jué)入庫(kù)"。
• 換模型時(shí)必須重新驗(yàn)證在用模板，模型升級(jí)不等于模板自動(dòng)兼容。
• 驗(yàn)證記錄和模板放在一起管理，結(jié)論要能查到出處。

三、模板分層：系統(tǒng)提示、任務(wù)模板、一次性**各歸其位

團(tuán)隊(duì)里的提示詞其實(shí)分三種層次，混在一起管就會(huì)亂。最底層是系統(tǒng)提示：定義 Codex 的角色、邊界和通用規(guī)則，比如"不要修改未授權(quán)的文件""不要輸出密鑰相關(guān)內(nèi)容"，它對(duì)所有任務(wù)生效，改動(dòng)最謹(jǐn)慎。中間層是任務(wù)模板：針對(duì)具體任務(wù)類型的結(jié)構(gòu)化提示詞，比如代碼**模板、日志分析模板、發(fā)布說(shuō)明模板，這是提示詞工程的主戰(zhàn)場(chǎng)。最上層是一次性**：日常臨時(shí)問(wèn)答，不需要管理，也不應(yīng)該反過(guò)來(lái)污染模板庫(kù)。

分層的價(jià)值在于控制變更的爆炸半徑。系統(tǒng)提示改一句話，影響所有任務(wù)，所以要走評(píng)審；任務(wù)模板改一段，只影響一類任務(wù)，負(fù)責(zé)人確認(rèn)即可；一次性**隨便問(wèn)，不入庫(kù)。很多團(tuán)隊(duì)的問(wèn)題恰恰是層次錯(cuò)位：把本該進(jìn)系統(tǒng)提示的安全邊界寫在某個(gè)任務(wù)模板里，結(jié)果其他任務(wù)完全沒(méi)約束；又把一次性**里的隨口要求塞進(jìn)模板，導(dǎo)致模板越來(lái)越臃腫。

提示詞三層結(jié)構(gòu)：

系統(tǒng)提示（全局面，評(píng)審后變更）：
  角色定義、安全邊界、通用輸出要求

任務(wù)模板（任務(wù)面，負(fù)責(zé)人確認(rèn)）：
  代碼** / 日志分析 / 發(fā)布說(shuō)明 / 提交摘要

一次性**（個(gè)人面，不沉淀）：
  臨時(shí)問(wèn)答、探索性嘗試

• 安全和邊界規(guī)則只放系統(tǒng)提示，不要在任務(wù)模板里各自為戰(zhàn)。
• 任務(wù)模板數(shù)量寧少勿多，一個(gè)任務(wù)類型對(duì)應(yīng)一個(gè)主模板。
• 一次性**里驗(yàn)證有效的好問(wèn)法，可以提煉后并入任務(wù)模板。

四、任務(wù)模板寫法：角色、上下文、任務(wù)、約束、輸出五段式

一個(gè)好用的任務(wù)模板不需要花哨的技巧，需要的是結(jié)構(gòu)完整。推薦五段式結(jié)構(gòu)：角色段說(shuō)明"你是誰(shuí)"，讓模型的回答視角穩(wěn)定；上下文段給出任務(wù)**，比如項(xiàng)目類型、技術(shù)棧、相關(guān)約定；任務(wù)段用一句話說(shuō)清楚要做什么，動(dòng)詞開(kāi)頭；約束段列出邊界，比如"只**變更文件""不要重寫整個(gè)函數(shù)"；輸出段定義返回格式，這部分下一節(jié)展開(kāi)。

寫模板時(shí)有三個(gè)常見(jiàn)錯(cuò)誤要避免。第一是上下文塞太多：把整個(gè) README 都貼進(jìn)去，模型反而抓不住重點(diǎn)，上下文只放和判斷直接相關(guān)的信息。第二是約束寫成愿望："盡量簡(jiǎn)潔""最好不要出錯(cuò)"這種話沒(méi)有約束力，約束要可檢查，比如"每條問(wèn)題必須給出文件和行號(hào)"。第三是模板里留口頭禪：從某次聊天記錄里復(fù)制來(lái)的"謝謝""辛苦了"要清掉，模板應(yīng)該是干凈的指令。

代碼**模板示例：

【角色】你是資深后端代碼**者，熟悉本項(xiàng)目的 Go 技術(shù)棧。
【上下文】項(xiàng)目為微服務(wù)架構(gòu)，變更來(lái)自 merge request，需符合團(tuán)隊(duì) Go 規(guī)范。
【任務(wù)】**以下變更，找出正確性、并發(fā)安全和錯(cuò)誤處理三類問(wèn)題。
【約束】只** diff 中的變更行；每個(gè)問(wèn)題必須給出文件、行號(hào)和修改建議；
        不確定的問(wèn)題標(biāo)注"需人工確認(rèn)"，不要猜測(cè)。
【輸出】按"嚴(yán)重 / 建議 / 需確認(rèn)"**分類輸出，無(wú)問(wèn)題則明確說(shuō)"未發(fā)現(xiàn)問(wèn)題"。

• 五段式每段都要有，缺了約束段和輸出段的模板等于半成品。
• 約束必須可檢查，寫不出檢查方法的約束就是空話。
• 模板寫完后讓另一個(gè)同事用一次，他用不明白就說(shuō)明寫得不夠清楚。

五、輸出格式控制：讓結(jié)果可以被流程直接消費(fèi)

提示詞工程里投入產(chǎn)出比最高的一件事，就是把輸出格式鎖死。自由文本的輸出看起來(lái)漂亮，但沒(méi)法被流程消費(fèi)：自動(dòng)化腳本解析不了，評(píng)審人難以比對(duì)，兩次運(yùn)行的結(jié)果沒(méi)法做差異檢查。格式控制的目標(biāo)是讓每次輸出都可預(yù)測(cè)——同樣的輸入結(jié)構(gòu)，必然得到同樣的輸出結(jié)構(gòu)。

控制格式有三個(gè)手段，按強(qiáng)度遞增。第一是文字描述："按**分類輸出，每級(jí)列出問(wèn)題清單"，適合人看的場(chǎng)景。第二是給出樣例：在模板里附一個(gè)標(biāo)準(zhǔn)輸出示例，模型會(huì)嚴(yán)格模仿結(jié)構(gòu)，適合半結(jié)構(gòu)化場(chǎng)景。第三是 Sche** 約束：要求輸出合法 **ON 并給出字段定義，適合自動(dòng)化場(chǎng)景——自動(dòng)化任務(wù)必須走到這一級(jí)，否則解析失敗會(huì)成為常態(tài)。另外要約定"空結(jié)果"的表達(dá)方式，比如"未發(fā)現(xiàn)問(wèn)題"而不是沉默，否則下游分不清是沒(méi)問(wèn)題還是調(diào)用失敗。

自動(dòng)化任務(wù)的輸出約定示例：

{
  "sum**ry": "一句話結(jié)論",
  "risk_level": "low | medium | high",
  "findings": [
    {"file": "路徑", "line": 行號(hào), "level": "級(jí)別", "detail": "說(shuō)明"}
  ],
  "needs_hu**n": true | false
}

空結(jié)果約定：findings 為空數(shù)組，sum**ry 寫"未發(fā)現(xiàn)問(wèn)題"。

• 給人看的用結(jié)構(gòu)化文本，給腳本用的必須上 **ON Sche**。
• 模板里附一個(gè)標(biāo)準(zhǔn)輸出樣例，是成本最低的格式控制手段。
• 空結(jié)果要有明確表達(dá)，不能讓下游猜測(cè)"沉默"的含義。

六、質(zhì)量評(píng)審：用固定樣本集給模板打分

模板好不好，***作者自己感覺(jué)。建議給每類任務(wù)維護(hù)一個(gè)固定樣本集——和模型策略篇里的驗(yàn)證樣本是同一套思路，但這里評(píng)的是提示詞而不是模型。樣本集覆蓋正常、異常、邊界三類輸入，每次模板變更后用同一批樣本跑一遍，從正確性、完整性、格式穩(wěn)定性三個(gè)維度打分。

評(píng)審要關(guān)注兩個(gè)最容易被忽略的指標(biāo)。一是退化檢測(cè)：新模板在這個(gè)樣本上變好了，在另一個(gè)樣本上是不是變差了？只看改進(jìn)案例會(huì)讓人對(duì)"針對(duì)性過(guò)擬合"的模板產(chǎn)生錯(cuò)覺(jué)。二是多人盲評(píng)：重要模板讓兩個(gè)以上的人獨(dú)立打分，分歧大的樣本拿出來(lái)討論——分歧本身就是模板表述不清的信號(hào)。評(píng)審結(jié)論記錄在模板版本歷史里，形成"哪個(gè)版本好、好在哪里"的證據(jù)鏈。

模板評(píng)審打分表：

樣本 | 正確性 | 完整性 | 格式穩(wěn)定 | 對(duì)比上版 | 評(píng)審人
S01  | 4/5    | 5/5    | 穩(wěn)定     | 持平     | A
S02  | 5/5    | 4/5    | 穩(wěn)定     | 提升     | A
S03  | 3/5    | 3/5    | 偶發(fā)錯(cuò)位 | 退化 ?   | *

• 每次模板變更都跑全量樣本，不允許只跑"改進(jìn)了的那個(gè)案例"。
• 出現(xiàn)退化樣本時(shí)，默認(rèn)不合并新版本，除非有明確的取舍理由。
• 盲評(píng)分歧大的樣本優(yōu)先處理，它指向的是模板表述問(wèn)題。

七、模板庫(kù)管理：命名、版本和存放位置

模板多起來(lái)之后，管理問(wèn)題會(huì)超過(guò)寫作問(wèn)題。模板放哪里、怎么命名、版本怎么記，直接決定團(tuán)隊(duì)成員能不能在十秒內(nèi)找到正確的模板。推薦的做法是：模板庫(kù)進(jìn)代碼倉(cāng)庫(kù)，和項(xiàng)目一起版本管理；按任務(wù)類型分目錄；每個(gè)模板文件頭部寫清元信息——版本、適用模型、負(fù)責(zé)人、最近驗(yàn)證日期。

版本管理不用搞復(fù)雜，語(yǔ)義化版本就夠了：結(jié)構(gòu)調(diào)整升大版本，措辭優(yōu)化升小版本，錯(cuò)別字修正升修訂號(hào)。關(guān)鍵動(dòng)作是把模板變更和效果驗(yàn)證綁定——版本號(hào)后面必須跟著評(píng)審記錄，沒(méi)有驗(yàn)證記錄的版本不允許標(biāo)記為"穩(wěn)定"。自動(dòng)化任務(wù)引用的模板要鎖定版本號(hào)，不允許引用"最新版"，否則一次模板更新可能悄悄改變線上行為。

prompts/
├── review/
│   └── code-review.v2.1.md      # 適用: codex-review, 負(fù)責(zé)人: 后端組
├── do**/
│   └── release-note.v1.3.md     # 適用: codex-do**, 負(fù)責(zé)人: 文檔組
└── auto**tion/
    └── commit-sum**ry.v3.0.md   # 適用: codex-**ily, CI 鎖定此版本

• 模板進(jìn)倉(cāng)庫(kù)走評(píng)審流程，和代碼變更同等對(duì)待。
• 每個(gè)模板頭部必須有元信息：版本、適用模型、負(fù)責(zé)人、驗(yàn)證日期。
• 自動(dòng)化任務(wù)鎖定模板版本，升級(jí)版本必須伴隨重新驗(yàn)證。

八、團(tuán)隊(duì)推廣：讓模板真正被用起來(lái)

模板庫(kù)建好之后，最大的風(fēng)險(xiǎn)是沒(méi)人用——大家還是習(xí)慣隨手問(wèn)。推廣的關(guān)鍵不是發(fā)通知，而是降低使用門檻和提高不用模板的成本。降低門檻的做法：把常用模板做成 IDE 片段、命令行別名或 CI 內(nèi)置步驟，讓"用模板"比"自己寫"更省事。提高成本的做法：代碼**、發(fā)布說(shuō)明這類正式場(chǎng)景，在流程上要求注明使用的模板版本，輸出格式不符合模板要求的要說(shuō)明原因。

還要給反饋留一個(gè)入口。使用中發(fā)現(xiàn)模板不好用的人，應(yīng)該能很方便地提改進(jìn)建議——在倉(cāng)庫(kù)里提 issue 或在模板塊里留批注。靈能API 提供的是穩(wěn)定統(tǒng)一的調(diào)用入口，而模板庫(kù)是團(tuán)隊(duì)在入口之上積累的**資產(chǎn)：入口越穩(wěn)定，模板庫(kù)的生命周期就越長(zhǎng)，積累的價(jià)值也越大。定期把使用頻率低、長(zhǎng)期沒(méi)更新的模板清理掉，保持模板庫(kù)精簡(jiǎn)可信。

推廣落地清單：

1. 高頻模板做成 IDE 片段 / 命令別名，一鍵**
2. 正式場(chǎng)景（**、發(fā)布）流程上要求注明模板版本
3. 模板倉(cāng)庫(kù)開(kāi)放 issue 入口，收集改進(jìn)建議
4. 每季度清理低頻和過(guò)期模板
5. 新人入職文檔里包含模板庫(kù)使用指南

• 用模板必須比自己寫更省事，否則推廣一定會(huì)失敗。
• 模板改進(jìn)建議要有響應(yīng)，提了沒(méi)人理的入口等于沒(méi)有。
• 低頻模板定期清理，模板庫(kù)的可信度比數(shù)量重要。

九、效果度量：提示詞工程到底帶來(lái)了什么

提示詞工程做到一定程度，需要回答一個(gè)問(wèn)題：這些投入到底值不值？度量可以從三個(gè)角度看。質(zhì)量角度：模板化之后，輸出的一次通過(guò)率（不需要人工返工就能用的比例）有沒(méi)有提升；效率角度：完成同類任務(wù)的平均輪次有沒(méi)有下降——從"問(wèn)三輪才滿意"變成"一輪到位"，省的是人和模型的雙重時(shí)間；成本角度：輸出格式穩(wěn)定后，自動(dòng)化任務(wù)的重試率和無(wú)效調(diào)用有沒(méi)有減少。

度量不必做成大工程，每月在復(fù)盤會(huì)上看三個(gè)數(shù)就夠了：一次通過(guò)率的趨勢(shì)、重點(diǎn)任務(wù)的平均交互輪次、自動(dòng)化任務(wù)因格式問(wèn)題導(dǎo)致的失敗次數(shù)。這三個(gè)數(shù)持續(xù)改善，說(shuō)明模板庫(kù)在產(chǎn)生價(jià)值；如果連續(xù)兩個(gè)月沒(méi)有變化，就要回頭檢查是模板沒(méi)人用，還是模板本身沒(méi)解決真問(wèn)題。

月度度量三指標(biāo)：

1. 一次通過(guò)率：輸出無(wú)需返工即可采用的比例（抽樣評(píng)估）
2. 平均輪次：重點(diǎn)任務(wù)從**到可用輸出的平均交互次數(shù)
3. 格式失敗率：自動(dòng)化任務(wù)因輸出格式不符導(dǎo)致的失敗占比

• 度量聚焦三個(gè)趨勢(shì)指標(biāo)，不要搞成沒(méi)人維護(hù)的報(bào)表工程。
• 指標(biāo)停滯先查模板使用率，再查模板質(zhì)量，順序不要反。
• 把度量結(jié)果反饋給模板作者，形成"寫作—驗(yàn)證—改進(jìn)"的閉環(huán)。

? 十、結(jié)語(yǔ)：提示詞工程讓 API中轉(zhuǎn)站 的輸出從看運(yùn)氣變成可預(yù)期

Codex 接入 API中轉(zhuǎn)站 之后，模型能力對(duì)團(tuán)隊(duì)所有人都是一樣的，真正拉開(kāi)差距的是提示詞工程的深度。同樣的模型，沒(méi)有模板管理的團(tuán)隊(duì)得到的是忽高忽低的輸出，有模板沉淀、格式控制和質(zhì)量評(píng)審的團(tuán)隊(duì)得到的是穩(wěn)定、可復(fù)用、能進(jìn)流程的結(jié)果。這個(gè)差距會(huì)隨時(shí)間放大——模板庫(kù)每積累一個(gè)月，團(tuán)隊(duì)的輸出質(zhì)量底盤就抬高一點(diǎn)。

落地可以從一個(gè)最小動(dòng)作開(kāi)始：挑出團(tuán)隊(duì)里使用頻率最高的一類任務(wù)，把它現(xiàn)在最好的問(wèn)法寫成五段式模板，用固定樣本驗(yàn)證后入庫(kù)，再配上一鍵**的調(diào)用方式。跑通這一個(gè)循環(huán)，后面的模板就是復(fù)制這個(gè)流程。當(dāng)提示詞從個(gè)人技巧變成團(tuán)隊(duì)資產(chǎn)，Codex 才真正從"聰明的工具"變成"可靠的生產(chǎn)力"。