AxionserveSign in / RegisterEnglish/中文/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 总览。