CursorREADME文档提示词怎么把痛点写进标题

你刚被PR reviewer打回第三次，就因为Sora生成的README里漏写了Docker镜像tag规则，导致测试环境总是拉错版本。

这事儿不能只写一句“优化文档质量”就完事，必须把它塞进标题里，而且是那种一看就知道“糟了、又来了”的标题。

从GitHub评论和CI日志里挖原始痛点

打开最近3个被拒的Pull Request页面，一条条翻reviewers的评论，用高亮笔标出所有包含“缺”“漏”“没写”“不一致”“报错但没提示”的句子。比如这样：

同步打开CI失败日志，截图报错前最后5行，提取具体动作和失败现象——比如“docker build后镜像ID每次都不一样”“yarn install在CI里超时但本地秒过”。

把所有标出的句子复制到新文本文件里，删掉“请”“建议”“可以考虑”这类软绵绵的弱动词，只留下主谓宾的硬结构。例如把“希望README能说明如何覆盖默认端口”压缩成“README没写PORT环境变量覆盖方式”。

用“谁+环节+漏/错/崩什么+后果”四要素压缩标题

方法一：直接截取最锋利的7～10个字，前面补角色

把“scripts里没写precommit钩子触发命令”改成“前端工程师提交代码前漏跑lint→PR自动被CI拦截”。

方法二：绑定Sora生成场景

把“deploy.sh执行后容器起不来却无报错”扩展为“Sora生成的部署脚本静默失败，stderr全空→运维查日志耗时47分钟”。注意，这里的47分钟必须来自你上周真实记录的工单时间，不能编。

方法三：用对比制造张力

前半句写预期行为，后半句写实际崩坏：

“本地npm start能跑通→Sora生成的README里缺失.env.example模板→新人clone即报错ENOTFOUND”

在Sora提示词首句嵌入痛点标题并验证响应

第一步：新建Sora提示词输入框，开头第一句直接粘贴你刚写好的痛点标题。例如：

“Sora生成的API文档漏写HTTP状态码说明，后端联调时反复问‘401是不是要重登录’”

第二步：紧跟冒号+具体指令。比如：

“Sora生成的API文档漏写HTTP状态码说明，后端联调时反复问‘401是不是要重登录’: 用表格形式列出每个endpoint对应的2xx/4xx/5xx状态码、含义、是否需重试、是否需跳转登录页”

第三步：生成后立刻检查输出是否包含“401 → 需跳转/login且清空token”。如果没出现，说明标题里的“反复问‘401是不是要重登录’”还不够具体，得换成“后端同事第5次在钉钉问‘401要不要前端清token’”。

这才是把痛点写进标题的正确打法。