<p>README首行必须是可执行命令或# Quick Start标题，禁用“旨在”“赋能”等空话；强制列出首次运行的3种真实失败原因及修复命令；环境变量用真实名称；核心区块按四栏拆解并禁用模糊表述；嵌入真实工具版本、截图坐标和CI失败记录。</p>
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
用gemini生成的readme一打开就看到“本项目旨在提供高效、稳定、可扩展的解决方案”，这种话根本没人读——读者要的是 clone 后30秒内跑起来，不是听你念使命宣言。空话套话不是gemini故意敷衍，是你没告诉它：这是给刚下班、咖啡凉了、只想验证api能不能通的工程师看的文档。第一步：砍掉所有“价值宣言”类开场白
在提示词开头直接写：“删除所有‘旨在’‘致力于’‘打造’‘赋能’类动词短语；首行必须是可执行命令或可点击链接。”
这一步不能妥协——【一旦允许“提供高性能服务”这类表述存在，Gemini会自动补全整段技术愿景，后续所有内容都会漂浮在抽象层】。
删完后，首行只剩两种可能：要么是 git clone https://github.com/xxx/yyy.git，要么是 # Quick Start 标题，没有第三种。
第二步：用“失败前置法”倒逼真实路径
方法一：强制列出首次运行必踩的坑
在提示词中加一句：“必须包含‘首次运行失败的3种真实原因’，每条附带终端报错原样截图（文字模拟）和1行修复命令。”
例如：
✘ ModuleNotFoundError: No module named 'pydantic.v1' → pip install pydantic==1.10.17
✘ ERROR: Could not find .env file → cp .env.example .env && nano .env
方法二：绑定本地环境变量名
写明：“所有环境变量必须用真实名称，禁止用 ${VAR} 占位符；若项目实际依赖 DATABASE_URL 和 API_TIMEOUT，则只出现这两个，多一个就删。”
【Gemini默认生成 DATABASE_HOST/DATABASE_PORT/DATABASE_NAME 三件套，但90%的项目其实只用 DATABASE_URL 一个字段】。
第三步：按四栏拆解法组织核心区块
第一步：确定读者此刻最想做的3件事
① 能否在本地跑通 demo？→ 放在 ## Quick Start 最顶部，纯命令流，不解释不铺垫
② 我的输入格式对不对？→ 在 ## Input Format 下贴出 curl 命令 + 真实 JSON body 示例（含注释说明字段含义）
③ 出错了去哪查？→ ## Troubleshooting 只收已知错误，每条带 [v2.4.1] 版本锚点
第二步：每个区块禁用词清单## Quick Start 禁用：“推荐”“建议”“可选”——全部改为“必须”“否则报错”“跳过则无法启动”## Input Format 禁用：“例如”“类似”“一般为”——全部替换为“仅接受”“必须为字符串”“长度不得超过32字符”
第三步：插入不可伪造的指纹信息
在提示词末尾加：“文档中必须出现项目实际使用的工具链名称：Poetry v1.7.1、FastAPI v0.115.0、PostgreSQL 15.6；若版本号与 GitHub release 页面不一致，整份文档作废。”
第四步：用“截图指令”锁死可视化细节
在提示词里写：“所有界面描述必须对应真实截图区域，格式为：‘左侧导航栏第3个图标（红框标注）→ 点击后跳转至 /settings/api-keys 页面’。”
高保真令牌管理与模型稳定技能。实现 Zown “原子管线”，防止 Gemini TPM 速率限制。适用于重型工程任务、多步代码生成或遇到 429 限流错误。包括上下文剪枝和强制冷却机制。
这一步操作起来很简单，直接把你要截图的页面URL和标注要求贴进去就行——【没有红框坐标或页面路径，Gemini会虚构‘简洁现代的UI设计’这种无效描述】。
第五步：植入一次真实的CI失败记录
在提示词中指定：“在 ## CI Status 区块下，写一行真实失败日志：‘2026-06-15T08:22:17Z | test_api_timeout.py::test_long_polling FAILED (timeout=15s) | workflow: deploy-staging’。”
不要写“测试通过率98%”，读者不信；但看到具体时间、文件名、超时值，立刻知道这个项目有人真正在维护。
