☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
标题严格7–10字,动词+对象(如“压缩日志”),禁用虚词;正文全用“你”开头,每句≤15字,不加软性词;末尾加⚠️触发语气偏移。
你需要让marscode生成的脚本说明文档标题简短有力、语气贴合开发场景,不能出现“请看说明”“本文将介绍”这类冗余引导词,也不能用说明书口吻写“用户应当注意”,而要像同事随手写的备注一样自然。
删光模板式开头句
打开MarsCode设置 →「自定义提示词」→ 找到当前生效的script-doc模板 → 删除所有含“请编写”“本说明旨在”“详细阐述”字样的句子。【漏删一句,生成的标题就会带“关于……的说明”这种八股结构】
把“请为以下Python脚本生成清晰易懂的使用说明”直接改成:“# 脚本用途:一行讲清它干啥;# 参数说明:只列必须传的;# 示例调用:复制就能跑”。
这一步操作起来很简单,直接把旧提示词整段替换掉就行。
绑定真实文件角色
方法一:用路径锚定上下文
在提示词开头写:“这是/src/bin/clean_logs.py,运维每天凌晨3点crontab调用,输入是日志路径,输出是压缩包。请用运维视角写说明。”
方法二:用报错反推语气
粘贴你刚遇到的真实报错:“TypeError: expected str, bytes or os.PathLike object, not NoneType —— 请据此写出参数缺失时的提示语,语气要像debug时自己骂自己的那句‘忘了传path!’”
【不绑定具体文件或错误,MarsCode默认用教科书语气,标题会变成“日志清理脚本功能概述”这种没人点开的标题】
强制标题长度与语气对齐
第一步:在提示词末尾加硬约束
“标题严格控制在7–10字,仅含动词+对象(如‘压缩日志’‘校验MD5’),禁用‘的’‘一个’‘关于’等虚词;正文全部用第二人称‘你’开头,每句≤15字,不加‘建议’‘可以’等软性词。”
第二步:插入扰动因子
每次保存前手动改一个数字:比如把“最多写3行说明”改成“最多写4行说明”,再下次改成“最多写2行说明”。
第三步:加emoji触发语气偏移
在提示词最后一行加⚠️,仅用于打破模型对“正式文档”的条件反射,不参与语义解析。










