写一份能让运维同事直接照着执行的脚本部署说明，比写十页架构文档实在得多。但很多人在跟AI工具比如Trae沟通时，容易掉进“讲大道理”的陷阱——让Trae输出抽象的流程图或理论化的checklist，结果拿到手根本没法用。真正好用的部署说明，必须精确到“在哪台机器上、用哪个账号、执行哪条命令、看到什么输出才算成功、失败了去查哪行日志”。
那么，怎样跟Trae说清楚这些要求？几个关键思路值得记下来。
用角色+环境+动作三要素锁定部署上下文
在Trae对话框里，这样写：“你是一名刚接手SRE交接的值班工程师，需在阿里云华北2区的prod-app-03服务器（CentOS 7.9）上部署check_disk.py脚本，要求用deploy用户执行，不重启服务，不影响当前订单接口SLA。”
这段话里，身份、机器标识、操作系统、执行账号和业务约束一个都不能少。漏掉任何一项，Trae大概率会默认走Ubuntu+root+systemctl restart那条路——但你的生产环境根本没有systemd。另外特别提醒一点：prod-app-03服务器必须提前开通deploy用户SSH密钥登录权限。这个权限没开通，后面所有sudo命令都会卡在密码输入环节，整个部署流程直接中断。
强制列出5条可截图验证的部署成功标准
直接输入以下提示词，一字不改：
“请严格按以下两步回答：① 先用‘【成功标准】’为标题，只列出5条部署完成后必须满足的验收标准，每条必须含具体路径、命令、预期输出或可截图界面；② 再用‘【部署步骤】’为标题，逐项对照上述标准生成操作指令。现在只输出第一步。”
这里有个小技巧：最后那句“现在只输出第一步”是关键锁死指令。不加这句话，Trae会跳过成功标准直接写步骤，运维执行完了也没办法判断到底成功了没有。
需要特别注意的是，成功标准里必须包含【/opt/scripts/check_disk.py第12行必须为LOG_LEVEL = 'WARNING'】。这是硬编码的日志级别，如果写成INFO，磁盘告警会被海量日志淹没，线上故障定位至少延迟半小时。
按失败现象反推检查项
这个方法很实用，有两种操作路径。
方法一：贴真实报错日志片段。 比如粘贴“PermissionError: [Errno 13] Permission denied: '/var/log/disk_check.log'”，然后追加指令：“请基于此错误生成3条上线前必检项，每条含检查命令、预期结果、执行人、失败后果。”Trae会给你输出具体的检查项，每条都很清晰。
方法二：描述执行后的异常行为。 比如输入“脚本运行后进程存在但无日志输出，crontab -l显示已添加但实际未触发”。Trae会输出：【cron守护进程状态检查】→ systemctl is-active cron → 运维 → 返回inactive则阻断部署；【crontab文件权限检查】→ ls -l /var/spool/cron/deploy → 运维 → 权限非600则拒绝加载。看，问题立马定位到具体原因了。
绑定三方协作与回滚条件
部署往往不是一个人的事，跨团队协同和回滚机制必须提前说清楚。
第一步，明确标注协同方与动作。在提示词末尾追加：“本次部署需DBA同步执行ALTER TABLE disk_log ADD COLUMN created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP;前端需在飞书群确认监控看板数据刷新正常。”
第二步，定义不可逆操作的熔断阈值。直接写明：“若check_disk.py连续3次执行返回非零退出码，或/var/log/disk_check.log 5分钟内无新写入，则自动触发回滚：rm -f /opt/scripts/check_disk.py && systemctl reload crond。”
第三步，指定回滚验证方式。补充一句：“回滚后必须执行ps aux | grep check_disk.py | wc -l，结果必须为0，否则视为回滚失败。”
这样一来，不管是正常部署还是紧急回滚，所有人都知道该做什么、该看什么，整个流程清清楚楚。
【成功标准】① ssh deploy@prod-app-03执行ls -l /opt/scripts/check_disk.py，输出含deploy:deploy且权限为-rwxr-xr-x；② 执行python3 /opt/scripts/check_disk.py，返回码为0且stdout含“DISK OK”；③ tail -n1 /var/log/disk_check.log显示时间戳+“DISK OK”；④ crontab -u deploy -l含“/5 * /usr/bin/python3 /opt/scripts/check_disk.py >> /dev/null 2>&1”；⑤ /opt/scripts/check_disk.py第12行必须为LOG_LEVEL = 'WARNING'。
