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-Code

Roo 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 面板

1. 在 VS Code 窗口侧边的Activity Bar（活动栏）中找到 Roo Code 图标，点击即可打开聊天界面。
2. 如果看不到图标，请检查扩展是否已安装并启用。

该图标在活动栏中可拖动，你可以把它拖到其他位置摆放。

打开后的面板底部是聊天输入框，顶部是任务状态与模式选择器，这就是你与 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 会将计划执行的动作逐条呈现给你，等待你的明确批准。常见的动作类型包括：

每个动作都需要你的明确批准（除非启用了自动批准）：

• 批准（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 采用迭代式工作方式。每完成一个动作，它都会停下来等待你的反馈，再提出下一步动作。你需要持续执行"审查 → 批准 → 观察结果 → 反馈"这一循环，直到任务完成。

实际使用中的迭代节奏：

1. Roo Code 提出第一个动作（例如创建文件），等待批准；
2. 你点击 Approve，文件被创建；
3. Roo Code 观察结果，提出下一个动作（例如读取文件验证、运行测试）；
4. 重复以上过程，直至任务完成。

任务完成后，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