你是一名刚接手运维交接的python脚本支持工程师,正在为【windows server 2019 + python 3.9.18】环境编写./scripts/clean_logs.py的使用说明。所有路径必须以c:opsscripts开头,所有命令必须带完整可复制前缀,如powershell -executionpolicy bypass -file。traceback (most recent call last):file "c:opsscriptsclean_logs.py", line 42, in shutil.rmtree(path)permissionerror: [winerror 5] 拒绝访问: 'c:program filespplogs‚60615'请围绕此错误说明权限配置方式,不提‘建议检查权限’这类空话。【管理员】以管理员身份运行powershell执行c:opsscriptsset_log_perms.ps1 → 仅限首次部署时执行【运维】在ansible playbook中设置var: log_cleaner_script_path = "c:opsscriptsclean_logs.py" → 仅用于windows server 2019节点【开发】调用clean_logs.run_with_retention(days=7) → 仅在python 3.9.18环境中调用
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你想让Codeium生成的脚本使用说明不像是套用模板拼凑出来的说明书,而是像同事随手写在共享文档里的实操笔记——有具体路径、带真实报错截图位置、能一眼看出该在哪台机器上跑、谁来执行、出错了往哪查。
用真实执行环境锚定语言颗粒度
在提示词第一行直接声明:“你是一名刚接手运维交接的Python脚本支持工程师,正在为【Windows Server 2019 + Python 3.9.18】环境编写./scripts/clean_logs.py的使用说明。”
这句必须放在最顶行。Codeium识别到操作系统+Python小版本+脚本相对路径三要素后,会自动过滤掉Linux命令、macOS快捷键、conda虚拟环境等无关内容,也不会冒出“建议在虚拟环境中运行”这种泛泛而谈的废话。
紧接着补一句硬约束:“所有路径必须以C:opsscripts开头,所有命令必须带完整可复制前缀,如powershell -ExecutionPolicy Bypass -File。”
插入真实失败场景替代抽象警告
方法一:用错误日志片段触发具象表达
在提示词中粘贴一段真实报错(不要加引号或说明文字):
Traceback (most recent call last):
File "C:opsscriptsclean_logs.py", line 42, in
shutil.rmtree(path)
PermissionError: [WinError 5] 拒绝访问: 'C:\Program Files\App\logs\20260615'
然后紧跟一句:“请围绕此错误说明权限配置方式,不提‘建议检查权限’这类空话。”
【注意:报错必须含具体路径、行号、错误代码和中文系统提示,缺一则Codeium会回退到通用话术】
按执行角色分层输出内容
第一步:明确区分三类读者动作
• 管理员:需手动执行注册表修改、服务重启、防火墙放行;
• 运维人员:用Ansible批量部署,只关心playbook变量名;
• 开发人员:只调用函数接口,不碰命令行。
第二步:在提示词末尾强制指定输出结构
请分三块输出,每块标题为【管理员】【运维】【开发】,每块内仅包含该角色真正要做的一步操作,格式为“动词+宾语+条件状语”,例如:“导入C:ops eglog_cleaner.reg → 仅限首次部署时执行”。
第三步:禁用跨角色混写
禁止出现“所有人都应……”“建议各角色分别……”这类模糊主语句式,每个动作必须绑定唯一执行者。











