<p>使用三档开关法控制文档篇幅：精简档限120字、标准档400–600字分三部分、详实档≥900字含背景/异常/调用关系；强制“## 功能说明”为唯一标题，参数表表头固定，流程用→单行描述，禁用解释句、免责声明及格式污染。</p>
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要用Cursor把一段旧代码快速生成说明文档，但AI输出的文档要么啰嗦得像论文，要么干瘪得只剩函数名，根本没法直接给新人看或塞进Confluence。
控制文档篇幅：三档开关法
在提示词开头明确指定篇幅档位，Cursor会据此压缩或展开内容密度。不写档位，AI默认按“中等”自由发挥，结果不可控。
方法一：精简档（适合嵌入代码注释或PR描述）
加一句：“输出限制在120字以内，只保留核心功能、关键输入/输出、1个典型调用示例。”
方法二：标准档（适合团队Wiki页）
加一句：“输出长度控制在400–600字，分三部分：① 用途一句话定义；② 输入参数表（含类型、是否必填、示例值）；③ 执行流程图解（用纯文字箭头→描述，不超过5步）。”
方法三：详实档（适合交接文档或新人培训）
加一句：“输出不少于900字，必须包含：背景动机（为什么存在这个函数）、边界条件处理逻辑、3种异常场景及对应返回、与上下游模块的调用关系图（用缩进+破折号表示层级）。”
锁定文档格式：用“结构锚点”代替模糊要求
别写“请用Markdown格式”，这等于没说——AI可能用#、##混搭，也可能漏掉表格边框。要给出可识别、可校验的结构信号。
第一步：强制一级标题锚点
在提示词末尾加：“所有输出必须以‘## 功能说明’为唯一一级标题，禁止出现‘#’或‘###’。”
Agents 正在你的整个代码库中处理越来越复杂、运行时间更长的任务。本次版本引入了新的 agent 框架改进，以实现更好的上下文管理，并在编辑器和 CLI 中带来了许多提升使用体验的修复。
第二步：参数表必须带字段标头
写明：“参数列表必须使用Markdown表格，表头严格为：| 参数名 | 类型 | 必填 | 默认值 | 说明 |，缺一不可，空值填‘—’。”
第三步：流程描述禁用编号
强调：“执行步骤用‘→’串联成单行，例如‘接收request → 校验token → 查询DB → 构造response → 返回JSON’，禁止使用1. 2. 3. 或① ② ③。”
【关键陷阱】如果提示词里写了“用表格展示参数”，但没规定表头字段，Cursor大概率会自创列名（比如“字段”“数据类型”“备注”），导致你后续无法用脚本批量提取——必须把表头字符串原样写死。
防止格式污染：清除AI惯性冗余
方法一：堵住解释癖
加硬性约束：“禁止出现‘该函数的作用是…’‘需要注意的是…’‘综上所述…’等引导性/总结性句式，所有内容必须为客观陈述。”
方法二：砍掉模板套话
写：“删除所有类似‘本文档由AI生成’‘仅供参考’‘如有疑问请联系’等免责声明，一个字都不留。”
方法三：格式洁癖指令
加一句：“输出中不得出现任何反引号(`)、三个以上连续换行、中文全角空格、非ASCII符号（如→除外），发现即重写。”
