新手应精准输入报错信息、Git提交信息或Code Review评论，避免模糊指令；需保留上下文、声明硬约束，否则易致重构失败。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
刚接触marscode重构功能的新手常把提示词写成“请优化这段代码”“让函数更清晰”，结果生成的代码要么跑不起来，要么和原逻辑脱节，甚至把关键参数名都改错了。用控制台报错当第一句
打开浏览器开发者工具→切换到Console标签页→找到最顶部那条红色错误（不是warning，不是堆栈末尾）→全选→复制→粘贴到MarsCode搜索框最开头。
这一步不能跳过，【MarsCode会优先匹配报错关键词来激活上下文锚点】。如果只写“用户数据加载失败”，它会默认扫描整个API层；但写成“TypeError: Cannot read property 'name' of undefined”，它立刻锁定useUserStore()里解构赋值那段。
删掉报错后面的括号内容（如“(at src/composables/useUserStore.ts:17:22)”），只留核心错误描述，用中文冒号接后续动作。
照搬Git提交信息里的原话
方法一：在VS Code中按Ctrl+Shift+G打开源代码管理→点击最近一次提交→看Commit Message正文→把里面带具体文件和行为的那句抄下来，前面加“修复”二字。
比如同事提交写了“临时删了token校验，否则登录页无限重定向”，你就搜：“修复登录页因token校验缺失导致无限重定向”。
方法二：右键当前分支→选择“Compare with Branch…”→选上一次稳定版本→在差异列表里找被删除的if判断或被注释的校验逻辑→把那行代码的关键变量名+操作动词组合成问题，例如：“修复useAuth.ts中removeToken调用后未清空localStorage导致下次登录残留旧态”。
直接抄Code Review评论中的技术实体
第一步：打开GitHub/GitLab页面→进入最近一次PR→下滑到Comments区域→找至少两条以上带具体位置的评论。
第二步：挑出其中一条含【文件路径+行号+函数/变量名】的，例如：“src/utils/format.ts第89行:formatDate应统一用Intl.DateTimeFormat，避免moment依赖”。
第三步：把整句话原封不动复制进搜索框，删掉句号，结尾不加问号——【MarsCode对句末标点敏感，加了问号会被识别为通用问答而非重构】。
新手最容易踩的三个坑
① 写“优化xxx”“提升可读性”这种模糊目标——MarsCode无法定位到哪一行要改，大概率生成教科书式伪代码。
② 只给函数片段不给上下文——比如只贴apply()方法，却不给ModificationContext定义，模型会虚构不存在的getQueueId()方法，导致重构后编译报错。
③ 忘记声明硬约束——像“不能新增init方法”“@Parameter变量名不能改”“必须兼容Protobuf Builder”，漏写一条就可能返工三遍。
