许多新手都会踩进同一个坑:直接把 README 原文扔进豆包,结果生成的新手指南总在关键操作环节断档。比如刚写到“安装依赖”就没了下文——具体要装什么?命令在哪输入?输错了怎么办?全都没交代。新手卡在第二步就放弃了。问题不在豆包偷懒,而是你输入的提示词太模糊,没把 AI 的输出路径锁定,让它以为写完“安装”两个字就算完成任务。
用五要素模板堵住步骤缺口
第一步,把原始 README 全文扔进豆包输入框。第二步,直接复制粘贴下面这段提示词:
“你是有六年开源项目运营经验的技术文档工程师,专精将开发者文档转译为16岁高中生能独立操作的新手指南。请基于我提供的 README 内容,生成一份严格遵循以下五要素的新手指南:
① 开篇第一句必须是‘你现在要做的,就是……’,且动词为‘打开/点击/下载/双击/输入’中的一个;
② 所有技术名词首次出现时,括号内用生活化类比解释(例如:‘Node.js(就像电脑的翻译官,帮它读懂 JavaScript 代码)’);
③ 每个操作步骤必须含明确视觉线索(如‘灰色按钮’‘右上角三个点’‘弹窗底部的确定’);
④ 屏蔽所有报错处理、调试技巧、进阶配置;
⑤ 全文不超过400字,段落间空一行,不使用任何 markdown 符号。”
这段提示词必须一字不差地照搬,少一条要素,豆包就会自动脑补补齐——它可能把“npm install”包装成“请运行安装命令”,却不告诉你该在哪个窗口里敲、敲完要等几秒、看到哪行字才算成功。
给AI加一道“步骤计数”硬约束
方法一:在五要素末尾追加一句:
【每项操作必须拆解为独立动词短语,且总数不少于5个,每个短语以“你”开头,例如“你双击 setup.exe”“你等待进度条走到100%”】
方法二:用分隔符强制结构化输出。在提示词最后加一句:“请严格按以下格式输出,不得增减段落,不得添加解释性文字:【动作1】→【动作2】→【动作3】→【动作4】→【动作5】”。豆包一旦只输出4项,说明它跳过了一个真实存在的前置动作——比如没写“你先确认 Python 已安装”,就直接跳到“你运行 pip install”,新手必然翻车。
注意:不要写“确保已安装”,必须改成“你按 Win+R → 输入 cmd → 回车 → 输入 python --version → 看到3.9以上数字即成功”。【“确保”是豆包最常偷懒的词,一出现就代表步骤被折叠】
用真实卡点反向校验步骤完整性
第一步,找出新手最可能卡住的第一个动作。打开 README 原文,用鼠标逐行扫读,只标记所有带“安装”“配置”“运行”“启动”字样的句子,其余段落暂时折叠。
第二步,定位那个最靠前、动词最明确的指令行。例如“npm install && npm start”,这就是整个新手指南的锚点,后面所有步骤都必须从它开始倒推前置条件。
第三步,把这行指令拆成肉眼可见的身体动作。把“npm install”改成“你点开终端(Mac 按 Command+空格搜‘终端’,Windows 搜‘cmd’),把光标放在黑框最末端,输入 npm install 后按回车——看到最后一行跳出‘added 123 packages’即成功”。这一步漏掉“光标位置”和“成功特征”,新手就会盯着空白界面等三分钟,然后关掉窗口放弃。
第四步,检查拆解后的动作是否全部可执行。如果某步需要“你打开项目根目录”,但没说明怎么找这个目录,就立刻补上:“你回到下载文件夹,找到名字含‘my-project’的蓝色文件夹,双击进入——里面能看到 package.json 文件的就是正确目录”。【没有图标颜色、文件名特征、层级关系的指引,等于没写】

