读者得到什么
“基于 AI 的强大项目”没有对象、用途和差异。先写给谁,再写解决什么。
README 不能让项目凭空走红。它能做的是:让已经点进来的人迅速看懂、相信,并知道下一步怎么做。
项目名
一句话:谁能用它解决什么问题
真实产品截图 / CLI 输出 / 结果样例
一个最短安装或在线体验入口
三条以内的真实差异“基于 AI 的强大项目”没有对象、用途和差异。先写给谁,再写解决什么。
可视项目放真实截图;CLI 项目放真实输出。不要用设计稿代替运行证据。
安装、Demo、文档选一个主入口。十几个徽章不能替代开始使用的路径。
写可验证差异:覆盖范围、运行方式、数据来源、边界。少用“最强、领先、革命性”。
这是结构观察,不是成功公式。样本来自已经增长的仓库,存在明显幸存者偏差。
Skill 会先看现状,再给优先级;不承诺涨星。