【格式：一级标题占全文12%，二级标题占8%，其余为正文；每个二级标题下正文80–180字】【标题：仅用动宾短语，如“初始化组件”“监听事件”，禁用泛化词】【禁用插入语】【代码块不计入正文字符数，前须有≤15字引导句】【标题必须来自指定动词列表：render、mount、unmount、validate、reset、destroy】
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让Gemini生成的组件使用文档里，标题层级清晰、正文不冗余，避免出现“一级标题占半页，下面跟着三行字”或“全是段落堆砌、找不到重点”的失衡问题。
明确标题层级与正文配比的硬性指令
在提示词开头直接写明结构比例要求，例如：“【格式：一级标题占全文12%，二级标题占8%，其余为正文；每个二级标题下正文不少于80字、不多于180字】”。Gemini对这类前置数值型约束响应稳定，不加此句则默认自由发挥，常导致标题过重、正文被压缩成碎片。
必须同步限定标题语义强度——写“【标题：仅用动宾短语，如‘初始化组件’‘监听事件’，禁用‘概述’‘简介’‘基本用法’等泛化词】”。否则Gemini容易塞进空洞总起句，占用标题位置却无信息量。
【关键前提：先确认你给Gemini的组件功能描述本身是否含明确动作点】。如果只说“这是一个表单校验工具”，它就无法拆出“配置规则”“触发验证”“处理错误”等二级标题；必须提供类似“支持正则匹配、异步接口校验、错误消息自定义渲染”这样的动词+对象结构，标题骨架才有依据。
用角色+场景双锚定控制信息密度
方法一：绑定技术文档工程师角色
“你是一名前端组件库技术文档工程师，专为中高级开发者编写接入文档。用户打开文档第一眼要能判断‘我该不该用这个组件’‘我改哪几行代码就能跑起来’。请按以下结构输出：① 一句话价值定位（≤25字）；② 必填参数表格（字段名/类型/必填/说明四列）；③ 三段式正文：安装→基础用法→常见问题，每段严格控制在110–140字。”
使用AIsa生成图像与视频。仅需一个API密钥即可调用Gemini 3 Pro Image（图像）和Qwen Wan 2.6（视频）。
方法二：绑定具体发布平台约束
“输出内容将直接嵌入VitePress侧边栏文档系统，左侧导航仅显示一级和二级标题，正文需支撑快速扫描。因此：所有标题禁止换行；二级标题后必须紧跟代码块或参数表；纯文字段落连续不超过3行。”
防崩坏：三处易错点手动锁死
第一步：堵住“解释性插入语”
在提示词末尾加：“【禁用插入语：如‘值得注意的是’‘需要特别说明的是’‘一般来说’，这些会虚占正文空间却无实质信息】”。Gemini习惯用这类缓冲短语填充字数，导致有效信息密度骤降。
第二步：锁死代码块与文本的视觉权重
写：“【代码块不计入正文字符数；每个代码块前必须有≤15字引导句，如‘最简初始化：’‘错误捕获示例：’】”。否则Gemini可能把30行代码塞进一段话里，标题下方直接飘一个超长代码块，正文消失。
第三步：切断标题自动生成链
明确禁止：“【禁止根据正文内容反向生成标题；所有标题必须来自我提供的功能动词列表：render、mount、unmount、validate、reset、destroy】”。否则它会从正文里抓词造标题，比如从“可以传入onSuccess回调”生成“onSuccess回调说明”这种偏离主干的标题。
