阿克森雲登入 / 註冊English/中文/cn繁體/tw

提示詞配方:讓 AI 寫出可驗證的基礎設施文檔

用 AI 寫技術文檔的完整配方:五個配方(事實錨定、口徑約束、結構模板、自查回路、反幻覺條款)+ 一個全流程實例。核心思想:AI 負責文字,事實與口徑由你供給和把關。

· AxionServe 編輯部 · 創作社區

AI 寫基礎設施文檔的最大風險不是文筆,是一本正經地編數字——「延遲低至 5ms」「99.99% 可用性」這類無據斷言,AI 生成得毫無心理負擔。解法是把「可驗證性」寫進提示詞配方:事實由你錨定、口徑由你約束、結構由模板固定、產出過自查回路。本篇給出五個配方與一個全流程實例,是創作社區方法論系列的第一篇;證據文化的完整版在測速與診斷中心。

提示詞配方五要素示意

配方一:事實錨定——把「可以用的數字」白名單化

系統提示裏顯式給出事實清單與禁令,比任何「不要編造」的口號都有效:

# 配方模板(直接抄進系統提示):
【事實白名單】本文只允許使用以下數字與事實:
- 價錢:$5.34/月(1核1G VPS)、$70.80/月(E3-1230 獨服)、$190.80/月(IPv4 /25 段檔)
- 測量口徑:延遲=6 次 256B 探針棄 1 取中位數;樣本 ≥100 才談丟包率
- 物理常量:光纖中光速約 20 萬公裏/秒
【禁令】白名單之外的任何數字一律寫「待實測」或「以官方頁面爲準」;
禁止出現「業界領先」「極致」「最強」等不可驗證表述。

爲什麼有效:模型的編造行爲多數是「補全慣性」——給了白名單,補全的素材就從參數記憶換成了你的清單;「待實測」三個字給了模型一個體面的出口,它就不硬編了。

配方二:口徑約束——術語與單位一次說死

  • 術語表內嵌:把易混術語的正確寫法列進提示(「CN2 GIA 不譯不改寫;AS4837 寫作 AS4837 不寫『4837 線路』;Mbps 是 bit 口徑、MB/s 是 Byte 口徑,差 8 倍」);
  • 貨幣與單位:顯式聲明(「全文貨幣 USD;延遲單位 ms;帶寬統一 Mbps」)——AI 中英混寫時單位漂移是高發事故;
  • 時間口徑:「今天是 YYYY-MM-DD;『當前』『最新』都以此爲錨」——不給時間錨,模型會拿訓練截止日當現在。

配方三:結構模板——骨架固定,血肉交給模型

# 配方模板(結構越死,質量越穩):
【文章骨架】嚴格按以下結構輸出:
1. 首段:一句話結論 + 本文解決什麼問題(≤80 字)
2. 三到六個 H2,每個 H2 下必須有可執行內容(步驟/表格/判據),禁止純敘述
3. 命令塊:每條命令可直接復制執行,帶注釋說明預期輸出
4. 末段:下一步行動 + 相關鏈接
【字數】正文 1200–2000 中文字
【禁止】空洞的過渡段、總結性套話、每節末尾的「總之」

配方四:自查回路——讓模型審自己,你審模型

生成後追加一輪自查提示(同會話即可):

【自查指令】逐條檢查你剛寫的文章並輸出檢查表:
□ 每個數字是否在事實白名單內?列出全部數字與出處
□ 是否存在「領先/極致/最」類不可驗證表述?列出並改寫
□ 每條命令是否可復制執行?標出依賴未說明的命令
□ 結構是否符合骨架?字數是否在區間內?
輸出格式:檢查項 → 結果 → 修正動作

自查回路抓住的問題約有一半是模型自己就能改的(重復表述、結構漂移、單位不一致);剩下的另一半——事實核對——永遠是你的活:白名單是你給的,產出是否越界要你逐條對。

配方五:反幻覺條款——給「不知道」發許可證

在系統提示末尾加一段:「當信息不足以回答時,明確寫『此處需要實測數據/官方確認』並繼續下一節,禁止用看似合理的估計填充」。這條的作用被嚴重低估:多數幻覺發生在模型「覺得必須寫點什麼」的位置——給它「留白也合規」的許可,留白率上升、編造率下降。

全流程實例:寫一篇「SSH 加固」文檔

  • ①備料(人):白名單事實(服務器發行版、sshd 配置路徑、fail2ban 版本)+ 參考真源(SSH 加固清單的 12 動作);
  • ②首輪生成:配方一 + 二 + 三拼成系統提示,用戶提示只寫主題與受衆;
  • ③自查輪:配方四跑一遍,模型輸出檢查表並自我修正;
  • ④人工終審(不可省略):數字逐條對白名單、命令逐條真機跑、結構對骨架——三關都過才算完稿;
  • ⑤發布紀律:AI 參與的產出一律先草稿後發布(本站治理紅線 R5 的社區版)——創作社區的投稿審核流程就是這道閘門。

驗收命令:產出文檔的機器自查

終審前的第零道關可以自動化——五個 grep 把最低級的違規先篩掉:

# 把 AI 產出存爲 draft.md,逐條跑:
# ① 數字白名單核對:列出全部數字,逐個對白名單(白名單外的即違規)
grep -oE "[0-9]+([.][0-9]+)?(%|ms|MB|GB|年|月|天)?" draft.md | sort | uniq -c | sort -rn
# ② 不可驗證表述掃描(命中即改寫)
grep -nE "業界領先|極致|最強|遙遙領先|無與倫比|頂級" draft.md || echo "表述幹淨"
# ③ 貨幣口徑檢查(本站紀律:USD)——用 Unicode 碼位匹配,避免檢查命令自身含違例字符
grep -nP "\x{00A5}|\x{FFE5}|\x{5143}/\x{6708}|\x{4EBA}\x{6C11}\x{5E01}" draft.md || echo "貨幣純淨(USD 口徑)"
# ④ 命令塊完整性:pre/code 配對與空塊檢查
grep -c "
" draft.md; grep -c "
" draft.md # 兩個數應相等 # ⑤ 鏈接盤點:列出全部內鏈,逐個核對目標存在(發布前防死鏈) grep -oE 'href="/[^"]+"' draft.md | sort -u

五條全過再進人工終審——機器篩掉格式違規,人只管事實與判斷,終審時間能省一半。

配方的邊界:什麼活別交給這套流程

配方產出的是「合格的技術文檔毛坯」——適合操作指南、概念科普、清單類內容;不適合:需要現場判斷的故障復盤(細節只有當事人有)、含敏感信息的架構文檔(別把拓撲餵給外部模型)、以及任何你無法逐條核實事實的領域(無法終審 = 無法負責)。判斷口徑一句話:你能在白名單裏寫下什麼,AI 才能寫出什麼——寫不出白名單的主題,先去做功課再談生成。

下一步:五個配方拼起來就是完整的系統提示,抄走改成你的白名單即可開工。成品歡迎發到創作社區(ai-writing / prompt-recipes 分類,標注 AI 參與與人工審校狀態);證據鏈文化的源頭在診斷中心與測量方法論;開發者視角的接口對接在API 總覽。