☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
codeium需以cli文档工程师身份为初学者写help文案，用生活化类比、主动句式、对比澄清和明确限制解释参数，禁用术语与变量名，每参数单行说明并标注误用后果与报错原文。
想让codeium在写命令行工具帮助文案时，把参数说明写得清晰易懂，不能只靠堆砌术语或照搬代码注释——它需要你用自然语言明确告诉它“参数对用户意味着什么”，而不是“这个变量在程序里叫什么”。
先告诉Codeium你写的工具类型和目标用户
在提示词开头用一句话点明：这是给谁用的什么工具。比如“这是一个面向Linux运维新手的轻量级日志过滤脚本，用户常混淆--since和--after的区别”。这步不加，Codeium容易默认按开发者视角写，冒出“接受time_t格式时间戳”这类用户根本看不懂的描述。
直接在提示词第一行写：“你是一名CLI文档工程师，正在为初学者编写help文案，所有参数说明必须用生活化类比，禁用技术缩写和内部变量名。”
用“用户动作+预期结果”结构描述每个参数
方法一：替换原始参数名，强制绑定行为解释
把--timeout 30写成“--timeout：等待服务器响应的最长时间（比如你泡一杯咖啡的时间，超时就自动放弃）”。Codeium看到括号里的具象参照，会主动避开“单位为秒”这种干瘪说明。
方法二：用对比句式消除歧义
针对易混参数，提示词中直接给出对比模板：“用‘A是…，B是…，别把A当B用’句式解释--verbose和--debug”。这能防止它把两个调试参数都写成“输出更多信息”。
【关键前提】必须在提示词里列出至少3个真实参数名及其常见误用场景，Codeium才不会自由发挥编造例子。例如：“--force（用户常以为能跳过所有确认，实际只跳过文件存在检查）”。
约束输出格式，砍掉冗余信息
第一步：要求每行只讲一个参数，格式固定为“参数名：说明（含类比/限制/后果）”。
第二步：禁止出现“该选项用于…”“此参数接受…”等被动句式，全部改为主动动词开头，如“跳过确认提示”“把错误写进error.log”。
第三步：遇到布尔型参数（如--quiet），强制追加一句副作用：“开启后将不再显示进度条，适合写入定时任务”。
最后在提示词末尾加一句硬性指令：“如果参数值有范围限制（如--level 1-5），必须用中文数字写出区间，并标注超出时的报错提示原文，例如‘仅支持一至五级，输六会提示‘level out of range’’”。
