必须先让ai分析readme结构、技术门槛和读者盲区再重写，采用分阶段提示词控制输出节奏，严格保留版本号、路径等关键约束，否则新手指南将堆砌术语或弱化必要条件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Cursor中将项目README.md改写为面向新手的指南时，必须让AI先识别原文结构、技术门槛和读者盲区，再生成分步引导式内容，否则会直接堆砌术语或跳过前置依赖。
让AI先分析README再动笔
打开README.md → 在编辑器右侧点击Cursor侧边栏的「Ask」按钮 → 输入提示词：【请先逐段分析这篇README：1. 哪些是安装步骤？2. 哪些是运行前提（如Node版本、环境变量）？3. 哪些概念对零基础用户完全陌生？4. 哪些命令缺少上下文（比如没说明该在哪个目录执行）？分析完再开始重写】
这一步不能跳过。如果直接让AI“改成新手指南”，它大概率会把“npm install”原样保留，却不说清楚要先装Node.js、也不提醒Windows用户得用Git Bash而不是CMD。
用分阶段提示词控制输出节奏
方法一：两轮提示法
第一轮只做诊断，等AI输出分析结论后，第二轮再输入：“根据以上分析，把README重写成新手指南，要求：每步操作前加‘你需要’，每个命令后加‘这一步在做什么’，所有缩写首次出现时括号注明全称。”
Agents 正在你的整个代码库中处理越来越复杂、运行时间更长的任务。本次版本引入了新的 agent 框架改进，以实现更好的上下文管理，并在编辑器和 CLI 中带来了许多提升使用体验的修复。
方法二：单提示强制分段
输入：【分三部分输出：① 诊断报告（列出3个新手最可能卡住的点）；② 新手指南正文（用‘第一步’‘第二步’编号，每步含命令+作用+常见报错原因）；③ 额外提醒（单独列出需要提前准备的工具和账号）】
注意：必须明确要求“分三部分输出”，否则AI会把诊断和指南混在一起，导致新手看到一半突然插入一段分析性文字，失去操作连贯性。
防止AI擅自简化关键约束
在提示词末尾追加一句：【保留所有版本号、路径、环境变量名，不替换成‘最新版’或‘你的项目名’；如果原文写了‘必须用Python 3.9+’，改写后仍要强调‘必须’，不能弱化成‘建议’】
这一步漏掉会导致新手用Python 3.12跑失败，回头还得查文档——改写失去了降低认知负担的意义。
