你是一位有5年devops经验的开源项目维护者，正在为技术博客撰写面向中级以上工程师的详情页文案。常写ci/cd流水线调试文档，偏好用真实报错日志引出问题；基于kubectl get pods -o wide输出中pending状态，说明该功能如何解决卡住问题；必须含①failedmount事件、②kubectl describe pod中warning events关键词、③container_restarts_total下降至0；按顺序：1.点明最痛故障现象；2.→列出3步定位路径（含命令+关键词）；3.验证段只写“执行x→观察y→确认z”；禁用冗余连接词；导出markdown保留代码缩进，pdf隐藏行号。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让Notion AI生成的技术博客详情页文案更专业、更易读、更符合工程师阅读习惯，而不是堆砌术语或写成产品说明书。
明确角色与读者身份
在AI指令开头用一句话锁定视角：「你是一位有5年DevOps经验的开源项目维护者，正在为技术博客撰写面向中级以上工程师的详情页文案。」
不写「请写一篇专业文案」——AI无法判断什么是“专业”；不写「面向开发者」——太宽泛，AI容易默认写成入门教程。必须给出【具体职级+典型工作场景+内容倾向】，比如「常写CI/CD流水线调试文档，偏好用真实报错日志引出问题」。
注入真实技术细节锚点
方法一：插入一段真实代码片段或CLI输出作为上下文
把本地测试时截取的kubectl get pods -o wide实际输出粘贴进提示词，紧跟一句「基于此状态，说明该功能如何解决Pending状态卡住的问题」。
方法二：指定必须包含的3个硬性要素
要求AI输出中必须出现：① 一个具体Kubernetes事件（如FailedMount）、② 对应的kubectl describe pod命令结果关键词、③ 修复后metrics指标变化趋势（如container_restarts_total下降至0）。
没有这些锚点，AI大概率编造模糊描述，比如「提升系统稳定性」——工程师看到会直接划走。
控制段落节奏与信息密度
第一步：用「段落指令」强制分层
在提示词末尾加：「按以下顺序组织内容：1. 用一行文字点明本功能解决的**最痛一个线上故障现象**；2. 紧接着用「→」符号列出3步定位路径（含命令+预期返回关键词）；3. 最后一段只讲验证方式，禁用形容词，只写「执行X命令 → 观察Y字段 → 确认Z值」。」
第二步：删掉所有「此外」「值得一提的是」类冗余连接词
AI生成初稿后，手动删除这类短语——它们会让技术文档像销售话术。工程师扫读时只抓动词和名词，连接词全是噪音。
第三步：把「支持多种格式」改成「导出为Markdown时自动保留代码块缩进，PDF时隐藏行号」
抽象功能描述是AI的舒适区，也是你的雷区。必须逼它落地到具体交付物行为，否则生成的文案永远在说「强大」「灵活」。
