在Cursor里写开源项目的文案，最怕的其实不是“写不出来”，而是“写出来却没人用”。原因很简单：AI没有你项目的上下文。你直接告诉它“写个README”，它大概率会生成一套万能模板——PRD式的废话、通用的安装步骤、莫名其妙的示例代码。真正能让文档落地、让用户一眼看懂怎么用的，是你主动注入的那些背景信息。

那么，具体该怎么做？核心思路就四个步骤，挨个拆开看。

明确项目基础身份

第一步：在提示词开头用一句话把项目说清楚。这句话得像名片一样，把三个要素一次性的交代完整：语言/框架 + 类型 + 核心功能。缺任何一个，AI都会跑偏。

比如：“这是一个用Rust编写的轻量级CLI工具，用于从Markdown文件批量提取待办事项并同步到Notion。”——语言是Rust，类型是CLI，核心功能是提取待办+同步Notion。如果你漏掉语言，AI可能默认用Python写示例代码；漏掉类型，它会生成一套“Web应用安装指南”；漏掉核心功能，它只会泛泛而谈“提升效率”，却根本说不清到底提升了什么效率。

第二步：补充1～2个真实的约束条件。这些不是锦上添花，而是防止AI虚构出你根本不支持的东西。比如：“不依赖Node.js运行时”“仅支持macOS和Linux”“API调用需用户自行配置NOTION_TOKEN环境变量”。有了这些，AI就不会自作主张生成npm install命令或Windows一键安装包。

植入真实用户场景

光说“面向开发者”太宽泛了，得让AI知道你的用户在什么情况下会用到这个工具。这里有两个很实用的方法。

方法一：用“当……时”句式来锚定具体的使用时刻。比如：“当开发者在CI流水线中需要自动校验PR里的文档变更是否匹配代码注释时，本工具通过--dry-run模式输出差异报告。”——这句话比“面向开发者”具体十倍。AI一听就知道要强调CI集成、--dry-run参数、差异报告格式，而不是瞎扯一堆无关功能。

方法二：列出2个典型失败案例，反向定义价值。比如：“避免手动复制粘贴API响应示例导致版本过期；避免在多个README中重复维护同一段权限配置说明。”——AI看到这些痛点，就会自动生成带版本校验机制的示例管理方案，而不是只写一句“保持文档更新”就完事。

绑定已有资产强化一致性

这一步很关键：把项目里已有的关键文件路径和命名直接写进提示词，强制AI对齐现有代码和文档，而不是自由发挥。比如：“所有命令行参数说明须与src/cli.rs中的clap::Parser结构体字段名完全一致；错误码列表需引用docs/error-codes.md中定义的CODE_001/CODE_002编号。”——否则AI很可能自创一个--verbose-level参数，而你实际代码里只认-v或--debug。

如果你的项目有标志性视觉元素，比如特定的图标、配色、CLI启动Banner文字，也可以在提示词末尾追加一句。比如：“文案中提及工具名称时，统一使用ASCII Banner样式，首行固定为‘██████╗ ██╗ ██╗███████╗’。”——这样生成出来的文案，从视觉到命名都跟项目本身浑然一体，用户一看就知道“这文档是亲生的”。