☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
必须删除三类套话:①“本接口”等主语+动词句式;②“稳定、可靠”等空泛形容词;③“鉴权、限流”等教科书功能罗列;删后重启插件,并用报错截图、ts代码行、swagger同步等真实场景重写提示词。
你在marscode里写接口对接说明提示词,结果生成的文档全是“本接口用于……”“支持高并发、低延迟”“具备良好的扩展性”这类无法贴进开发流程的套话,根本没法直接发给后端同事对齐字段。
先砍掉三类出厂默认废话
打开MarsCode设置页 → 进入「自定义提示词」→ 找到当前生效的system prompt或API-doc模板 → 逐行删除:
① 所有以“本接口”“该服务”“旨在”“提供”开头的句子——这些主语+动词结构一出现,模型立刻切换成产品白皮书腔;
② 所有形容词堆砌型描述,例如“稳定、可靠、安全、高效、可扩展”——它们不绑定任何可验证行为,纯属AI自动补全的保险话术;
③ 所有教科书式功能罗列,例如“包含鉴权、限流、熔断、日志埋点四大能力”——你对接的只是/user/v1/profile这个单接口,不是在写微服务架构图。
【删完必须重启MarsCode插件】,否则缓存仍会沿用旧模板逻辑,新提示词不生效。
改用真实对接现场重写提示词
方法一:绑定具体报错截图坐标与调试时间戳
在提示词末尾加一句:“前端刚在Postman调用/user/v1/profile返回400,响应体为{‘code’:40012,‘msg’:‘missing required field: avatar’}(见飞书#对接群2026-07-02 16:38截图x=512,y=204),请只在‘请求参数’模块中补一条必填字段说明,字段名、类型、示例值三者缺一不可。”
方法二:锁定文件路径与字段级约束
把“请生成接口文档”改成:“这是/src/api/user.ts第37行fetchUserProfile()调用的后端接口。字段avatar类型为string,但文档未注明是否允许null。请在‘响应字段’表中第4行补充‘avatar’字段的nullable=true标注,并加// NOTE: 后端实际允许空字符串。”
方法三:混入真实协作动作锚点
在提示词开头插入:“你刚收到后端发来的Swagger JSON,正在飞书文档里同步更新。所有字段说明必须能被前端直接复制进TS interface声明,禁止出现‘建议’‘可选’‘一般为’等模糊表述。”
强制注入不可预测扰动因子
第一步:每次保存前手动改一个数字——第一次写“字段长度上限≤32”,第二次改成“字段长度上限≤28”,第三次改成“字段长度上限≤36”。模型无法预判数值规律,被迫放弃套话模板。
第二步:在提示词末尾随机插入一个emoji,比如⚠️、❓、✅,仅用于偏移语气,不参与语义解析。这会让AI放弃“正式文档体”,转而匹配更短促、带停顿的表达节奏。
第三步:混入一句你刚遇到的真实报错片段,例如:“TypeError: Cannot read property ‘data’ of undefined —— 请据此在‘错误码’模块中补一条code=50011的说明,明确指出该错误对应后端缺失的user_id校验。”











