【project-x】是运维团队每天凌晨三点自动巡检K8s集群健康状态的脚本，值班同学只需ssh登录后运行一条命令；运行方式：python3 check_cluster.py --node prod-node-01 → 控制台打印‘✅ Core pods all Running’或报错退出。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你想让Codeium生成的项目README一开头就直击核心——不是堆砌技术栈名词，而是让新同事打开文档3秒内就知道“这玩意儿干啥用、怎么跑起来”，但每次提示词都写成“请写个README”，结果出来全是“本项目基于React构建”“支持SSR和CSR”这类无效信息，根本没法抄起终端就开干。

第一步：用角色+动作链锁定用途描述

在提示词最开头，用一句话定义“谁在什么场景下用这个项目解决什么问题”，主语必须是项目名。例如：“【project-x】是运维团队每天凌晨三点自动巡检K8s集群健康状态的脚本，值班同学只需ssh登录后运行一条命令，不打开Dashboard、不执行kubectl exec、不依赖任何插件。”

这句不能写成“这是一个用于K8s巡检的工具”，AI会默认按通用工具逻辑展开，输出一堆“支持多集群”“可扩展性强”之类虚话；必须绑定真实人、真实时间、真实动作链，才能逼它写出“运行curl -s http://localhost:9090/healthz → 返回200即表示API服务存活”这种可验证语句。

第二步：强制运行方式前置且唯一

在用途句之后，立刻接上运行方式，格式为：“运行方式：`命令行` → 触发现象”。例如：“运行方式：python3 check_cluster.py --node prod-node-01 → 控制台打印‘✅ Core pods all Running’或报错退出。”

【必须用反引号包裹完整命令，且命令中参数值要真实存在】。如果脚本实际只接受--node参数，提示词里写--host，Codeium会照搬错误参数名生成说明，新人复制粘贴直接报错。

这一步不写具体命令而只说“需安装依赖后运行”，AI就会虚构npm install && python main.py，而你的项目根本没package.json。

第三步：用三重锚点封死模板化倾向

方法一：绑定真实文件路径
在提示词中插入当前项目根目录的绝对路径，例如：“你正坐在路径【/opt/ops/checker-v2.1】下，已cd进该目录，check_cluster.py就在当前目录。”

方法二：注入真实失败日志
从终端历史中复制一行真实报错，例如：“Error: Connection refused to localhost:9090”，并加一句：“若未启动本地healthz服务，执行上述命令将触发此报错，请在运行方式说明中明确前置检查项。”

方法三：限定输出结构
结尾加指令：“输出仅含两段：① 用途（不超过35字，主语为项目名）；② 运行方式（含命令+→+可观察现象，禁用‘请先’‘建议’‘可以’等引导词）。”