怎样让 AI Agent 完成第一个项目小改动？
从选对本地项目文件夹开始，用清楚的目标和完成标准交给 Agent 一个小改动，并检查文件变更与验证结果。
由 路墨 Lumoswitch 产品团队维护
先打开项目文件夹，再描述一个边界明确的小改动；多步骤工作可选规划模式，结束后查看变更和验证依据。
开始前要准备什么？
1. 在工作区选择器中点“选择文件夹”，打开目标项目的根目录；已有项目可从已保存文件夹继续。 2. 确认文件夹名称正确，并选择本轮要用的模型和 Agent。 3. 第一次改动先选小范围任务；如果项目有未提交工作，先确认哪些文件是你已有的修改。工作区会围绕所选本地文件夹工作，别把其他目录当成已自动加入的上下文。
怎样写第一个任务？
在任务框给出具体结果、范围和限制。例如： “请检查这个项目的首页，修复窄屏下导航文字被裁切的问题。只修改相关组件和样式，不新增依赖；先告诉我你准备检查哪些文件，再实现修复，并运行项目中相关的检查。若无法运行检查，请说明原因。” 1. 若只是一个小问题，可用“对话”模式；涉及多步实现、需要计划和独立复核时选“规划”模式。 2. 需要更明确验收时，在完成标准中逐条写出可观察条件，再开始任务。 3. 需要确认的文件修改、命令或其他操作会按当前权限设置处理；逐次确认时先看清具体操作再决定。
怎样判断 Agent 做完了？
1. 查看工作区里的任务状态、运行记录和最终说明。 2. 若本轮产生文件变更，打开“文件变更”记录，核对路径和补丁；若有验证报告或测试结果，确认它对应当前改动。 3. 不要把 Agent 的完成文字当作项目已经发布；按项目自己的预览或检查方式确认。规划模式还会展示计划、执行与复核结果，必要时可选择继续调整而不是完成任务。
没有结果或改错了文件，先排查什么？
1. 检查当前工作区是不是项目根目录，并确认任务里点明了目标页面或文件。 2. 如果模型或运行环境不可用，先检查工作区显示的模型/运行状态，再重试。 3. 若路径不对，停止当前任务并打开正确文件夹；不要让 Agent 在猜测的目录继续改。 4. 补充一条具体反馈，例如“只调整 `src/...` 的移动端样式，不动桌面布局”，再让它继续。代码修改仍可能有遗漏，重要变更要自己看补丁并运行项目检查。