Roo Code 首个任务实战指南从打开面板到掌握审批驱动的迭代工作流【免费下载链接】Roo-CodeRoo Code gives you a whole dev team of AI agents in your code editor.项目地址: https://gitcode.com/GitHub_Trending/ro/Roo-CodeRoo Code 是一款运行在 VS Code 中的 AI 编程助手其核心理念是让 AI 处理繁琐的编码工作同时让开发者对每一步操作保持完全掌控。本文基于官方入门文档带领你完成与 Roo Code 的第一次完整交互从打开聊天面板、用自然语言描述需求到逐个审批 AI 提出的动作最后掌握这套审批 迭代工作流背后的实现原理。读完本文你将能独立跑通你的第一个任务并理解任务审批、自动批准等机制在源码中的落点为进一步使用高级模式与自动化功能打下基础。前置条件完成 API Provider 配置在开始你的第一个任务之前请确保已经完成了 AI Provider模型提供方的连接配置。Roo Code 本身不包含任何模型它需要借助外部推理服务来驱动详见 连接你的第一个 LLM Provider。对于刚上手的用户推荐从Claude Sonnet 4.5这类开箱即用的模型开始通过OpenRouter单一 API Key 访问多家实验室模型或Anthropic直接访问 Claude 模型族接入。配置完成后你就可以开始编码了。Step 1打开 Roo Code 面板在 VS Code 窗口侧边的Activity Bar活动栏中找到 Roo Code 图标点击即可打开聊天界面。如果看不到图标请检查扩展是否已安装并启用。该图标在活动栏中可拖动你可以把它拖到其他位置摆放。打开后的面板底部是聊天输入框顶部是任务状态与模式选择器这就是你与 Roo Code 交互的主界面。Step 2用自然语言描述你的任务在面板底部的聊天框中用清晰、简洁的自然语言描述你想让 Roo Code 完成的事情。不需要任何特殊命令或语法——直接说人话即可。官方文档给出的几个有效示例Create a file namedhello.txtcontaining Hello, world!.Write a Python function that adds two numbers.Create an HTML file for a simple website with the title Roo test写任务描述的技巧明确目标产物创建什么文件、实现什么功能说明关键约束文件名、内容、语言、标题等一次只聚焦一件事便于观察 Roo Code 的迭代过程。从源码结构看你输入的这条消息会进入src/core/task/Task.ts的任务队列最终作为用户消息user message发送给 LLM并触发一轮完整的模型产出动作 → 请求审批 → 执行循环。Step 3发送你的任务输入完成后按Enter键或点击输入框右侧的发送Send图标提交任务。提交后Roo Code 会分析你的请求并开始规划需要执行的动作。此时它并不会直接动手而是进入下一步的审批流程。Step 4审查并审批每个动作这是整个工作流中最关键的一步。Roo Code 会将计划执行的动作逐条呈现给你等待你的明确批准。常见的动作类型包括动作类型你会看到什么读取文件展示它需要访问的文件内容写入文件展示 diff 差异新增行标绿、删除行标红执行命令展示将在终端中运行的精确命令使用浏览器概述浏览器操作点击、输入等提问当信息不足时请求你澄清每个动作都需要你的明确批准除非启用了自动批准批准Approve点击 Approve 按钮执行该动作拒绝Reject点击 Reject 按钮如有需要可附上反馈。审批机制在源码中的落点在类型层packages/types/src/message.ts定义了ClineAsk联合类型列举了 LLM 可能请求用户交互的全部场景其中包括followup—— 提出澄清问题以获取完成任务所需的更多信息command—— 请求执行终端/Shell 命令的权限tool—— 请求使用工具读、写、搜索等文件操作的权限use_mcp_server—— 请求使用 MCP 服务器功能的权限completion_result—— 任务完成等待用户反馈或新任务。这五种交互式审批类型被归入interactiveAsks即需要用户实时响应的场景而completion_result、api_req_failed等则被归入idleAsks使任务进入空闲状态。正是这套类型系统驱动着前端审批按钮与后端任务状态机的联动。关于自动批准Auto-Approval如果你觉得逐个点击批准太繁琐Roo Code 提供了自动批准Auto-approve功能。它位于聊天输入框旁的 Auto-Approve 下拉菜单中可针对不同权限类别分别开启详情见 自动批准动作。从源码看src/core/auto-approval/AutoApprovalHandler.ts实现了自动批准的限制控制它会统计api_req_started消息的数量与累计 API 成本当超过allowedMaxRequests最大连续自动批准请求数或allowedMaxCost最大成本上限时通过askForApproval回调强制弹回手动审批确保自动模式也不会失控。⚠️ 安全提醒自动批准会跳过确认提示让 Roo Code 直接操作你的系统可能带来数据丢失、文件损坏等风险。命令行权限尤其危险。请只对完全信任的动作开启自动批准。Step 5迭代循环——审批、反馈、继续Roo Code 采用迭代式工作方式。每完成一个动作它都会停下来等待你的反馈再提出下一步动作。你需要持续执行审查 → 批准 → 观察结果 → 反馈这一循环直到任务完成。实际使用中的迭代节奏Roo Code 提出第一个动作例如创建文件等待批准你点击 Approve文件被创建Roo Code 观察结果提出下一个动作例如读取文件验证、运行测试重复以上过程直至任务完成。任务完成后Roo Code 会显示最终结果并等待你的下一条指令。此时你可以继续追问、要求修改或开始一个全新任务。小结你已掌握的核心能力通过完成第一个任务你已经掌握了 Roo Code 的三项基本功自然语言交互无需特殊语法用自然语言即可指挥 AI审批驱动的工作流每个动作都在你的掌控之中AI 不能擅自行动迭代式问题解决Roo Code 逐步推进、逐步验证而不是一次性盲目执行。这套迭代 审批的工作流是 Roo Code 的核心运行机制。在此基础上你可以继续探索模式Modes通过Code、Ask、Architect、Debug、Orchestrator等专用模式适配不同任务详见 使用模式自动批准为重复性任务提速详见 自动批准动作自定义模式为团队或特定场景定制行为与工具权限参见 自定义模式文档 中对应的说明。现在你已经可以开始处理更复杂的任务了。下一次试着让 Roo Code 写一个带测试的 Python 模块或者为你的项目搭一个 HTML 页面——你会发现审批与迭代的节奏会让每一次修改都可控、可追溯。【免费下载链接】Roo-CodeRoo Code gives you a whole dev team of AI agents in your code editor.项目地址: https://gitcode.com/GitHub_Trending/ro/Roo-Code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Roo Code 首个任务实战指南：从打开面板到掌握审批驱动的迭代工作流
Roo Code 首个任务实战指南从打开面板到掌握审批驱动的迭代工作流【免费下载链接】Roo-CodeRoo Code gives you a whole dev team of AI agents in your code editor.项目地址: https://gitcode.com/GitHub_Trending/ro/Roo-CodeRoo Code 是一款运行在 VS Code 中的 AI 编程助手其核心理念是让 AI 处理繁琐的编码工作同时让开发者对每一步操作保持完全掌控。本文基于官方入门文档带领你完成与 Roo Code 的第一次完整交互从打开聊天面板、用自然语言描述需求到逐个审批 AI 提出的动作最后掌握这套审批 迭代工作流背后的实现原理。读完本文你将能独立跑通你的第一个任务并理解任务审批、自动批准等机制在源码中的落点为进一步使用高级模式与自动化功能打下基础。前置条件完成 API Provider 配置在开始你的第一个任务之前请确保已经完成了 AI Provider模型提供方的连接配置。Roo Code 本身不包含任何模型它需要借助外部推理服务来驱动详见 连接你的第一个 LLM Provider。对于刚上手的用户推荐从Claude Sonnet 4.5这类开箱即用的模型开始通过OpenRouter单一 API Key 访问多家实验室模型或Anthropic直接访问 Claude 模型族接入。配置完成后你就可以开始编码了。Step 1打开 Roo Code 面板在 VS Code 窗口侧边的Activity Bar活动栏中找到 Roo Code 图标点击即可打开聊天界面。如果看不到图标请检查扩展是否已安装并启用。该图标在活动栏中可拖动你可以把它拖到其他位置摆放。打开后的面板底部是聊天输入框顶部是任务状态与模式选择器这就是你与 Roo Code 交互的主界面。Step 2用自然语言描述你的任务在面板底部的聊天框中用清晰、简洁的自然语言描述你想让 Roo Code 完成的事情。不需要任何特殊命令或语法——直接说人话即可。官方文档给出的几个有效示例Create a file namedhello.txtcontaining Hello, world!.Write a Python function that adds two numbers.Create an HTML file for a simple website with the title Roo test写任务描述的技巧明确目标产物创建什么文件、实现什么功能说明关键约束文件名、内容、语言、标题等一次只聚焦一件事便于观察 Roo Code 的迭代过程。从源码结构看你输入的这条消息会进入src/core/task/Task.ts的任务队列最终作为用户消息user message发送给 LLM并触发一轮完整的模型产出动作 → 请求审批 → 执行循环。Step 3发送你的任务输入完成后按Enter键或点击输入框右侧的发送Send图标提交任务。提交后Roo Code 会分析你的请求并开始规划需要执行的动作。此时它并不会直接动手而是进入下一步的审批流程。Step 4审查并审批每个动作这是整个工作流中最关键的一步。Roo Code 会将计划执行的动作逐条呈现给你等待你的明确批准。常见的动作类型包括动作类型你会看到什么读取文件展示它需要访问的文件内容写入文件展示 diff 差异新增行标绿、删除行标红执行命令展示将在终端中运行的精确命令使用浏览器概述浏览器操作点击、输入等提问当信息不足时请求你澄清每个动作都需要你的明确批准除非启用了自动批准批准Approve点击 Approve 按钮执行该动作拒绝Reject点击 Reject 按钮如有需要可附上反馈。审批机制在源码中的落点在类型层packages/types/src/message.ts定义了ClineAsk联合类型列举了 LLM 可能请求用户交互的全部场景其中包括followup—— 提出澄清问题以获取完成任务所需的更多信息command—— 请求执行终端/Shell 命令的权限tool—— 请求使用工具读、写、搜索等文件操作的权限use_mcp_server—— 请求使用 MCP 服务器功能的权限completion_result—— 任务完成等待用户反馈或新任务。这五种交互式审批类型被归入interactiveAsks即需要用户实时响应的场景而completion_result、api_req_failed等则被归入idleAsks使任务进入空闲状态。正是这套类型系统驱动着前端审批按钮与后端任务状态机的联动。关于自动批准Auto-Approval如果你觉得逐个点击批准太繁琐Roo Code 提供了自动批准Auto-approve功能。它位于聊天输入框旁的 Auto-Approve 下拉菜单中可针对不同权限类别分别开启详情见 自动批准动作。从源码看src/core/auto-approval/AutoApprovalHandler.ts实现了自动批准的限制控制它会统计api_req_started消息的数量与累计 API 成本当超过allowedMaxRequests最大连续自动批准请求数或allowedMaxCost最大成本上限时通过askForApproval回调强制弹回手动审批确保自动模式也不会失控。⚠️ 安全提醒自动批准会跳过确认提示让 Roo Code 直接操作你的系统可能带来数据丢失、文件损坏等风险。命令行权限尤其危险。请只对完全信任的动作开启自动批准。Step 5迭代循环——审批、反馈、继续Roo Code 采用迭代式工作方式。每完成一个动作它都会停下来等待你的反馈再提出下一步动作。你需要持续执行审查 → 批准 → 观察结果 → 反馈这一循环直到任务完成。实际使用中的迭代节奏Roo Code 提出第一个动作例如创建文件等待批准你点击 Approve文件被创建Roo Code 观察结果提出下一个动作例如读取文件验证、运行测试重复以上过程直至任务完成。任务完成后Roo Code 会显示最终结果并等待你的下一条指令。此时你可以继续追问、要求修改或开始一个全新任务。小结你已掌握的核心能力通过完成第一个任务你已经掌握了 Roo Code 的三项基本功自然语言交互无需特殊语法用自然语言即可指挥 AI审批驱动的工作流每个动作都在你的掌控之中AI 不能擅自行动迭代式问题解决Roo Code 逐步推进、逐步验证而不是一次性盲目执行。这套迭代 审批的工作流是 Roo Code 的核心运行机制。在此基础上你可以继续探索模式Modes通过Code、Ask、Architect、Debug、Orchestrator等专用模式适配不同任务详见 使用模式自动批准为重复性任务提速详见 自动批准动作自定义模式为团队或特定场景定制行为与工具权限参见 自定义模式文档 中对应的说明。现在你已经可以开始处理更复杂的任务了。下一次试着让 Roo Code 写一个带测试的 Python 模块或者为你的项目搭一个 HTML 页面——你会发现审批与迭代的节奏会让每一次修改都可控、可追溯。【免费下载链接】Roo-CodeRoo Code gives you a whole dev team of AI agents in your code editor.项目地址: https://gitcode.com/GitHub_Trending/ro/Roo-Code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
