Skip to content

Quest Mode - 任务模式

概述

Quest Mode 是一个为复杂、长期运行的开发任务设计的 AI 辅助编程功能。通过用自然语言描述您的需求,您可以将功能开发、Bug 修复、重构和测试等任务委托给 AI,显著提高开发效率。

核心功能

AI 辅助规格说明 (Specs)

AI 助手分析您的项目并自动生成详细的技术设计文档(Spec)。这确保了对任务的共同理解,并使 AI 的执行与您的目标保持一致。

自主执行

一旦 Spec 完成并开始执行,AI 代理会异步执行任务。您可以通过 Action Flow 视图实时监控进度,该视图显示执行计划、正在进行的操作以及遇到的任何问题。

AI 辅助任务报告

完成后,AI 会生成任务报告,总结更改、测试结果和验证结果。这有助于您在决定接受或完善结果之前快速评估工作的质量和完整性。

如何创建任务

  1. 点击"新建任务"
  2. 选择相关上下文(如项目文件或代码片段)并用自然语言输入任务描述
  3. 点击"发送"或按 Enter 开始。AI 将开始根据您的输入起草详细的 Spec

可选:直接执行 如果您不需要正式的 Spec,在对话框中选择"直接执行"。AI 将跳过设计阶段并立即开始实现。

技术设计阶段

在设计阶段,AI 会:

  • 审查您的项目记忆和上下文
  • 分析代码库结构
  • 生成综合的 Spec 文档

生成 Spec 后,您可以编辑它或与 AI 一起完善它。它将自动保存在项目的 .qoder/quest 目录中。

一旦您对 Spec 满意,点击右上角的"立即开始"开始执行。

Action Flow - 执行流程

任务开始后,您将进入 Action Flow 视图,该视图显示:

  • AI 的执行计划
  • 实时输出和日志
  • 进度状态和任何阻塞问题

对于简单任务,AI 可能会跳过生成详细计划,直接进入实现阶段。

您可以随时添加新需求——即使在任务运行时——通过在聊天框中发送消息。AI 将调整其计划并继续工作。

典型的执行流程

  1. 任务分析:AI 分析任务需求和项目结构
  2. 计划制定:生成详细的执行计划和步骤
  3. 代码实现:根据计划编写和修改代码
  4. 测试验证:运行测试确保代码质量
  5. 文档更新:更新相关文档和注释
  6. 结果汇总:生成任务完成报告

实时监控

在 Action Flow 视图中,您可以:

  • 查看当前执行的步骤
  • 监控实时日志输出
  • 跟踪文件更改状态
  • 识别和解决阻塞问题
  • 与 AI 实时沟通调整需求

任务报告

任务完成时,系统切换到任务报告视图。AI 提供结构化摘要,包括:

  • 实现更改概述
  • 测试结果和验证结果
  • 更改文件的详细列表

您可以:

  • 逐个审查每个更改
  • 点击"接受"(右上角)保留更改并归档任务
  • 点击"放弃"撤销所有更改并结束任务

如果需要额外工作,返回 Action Flow 视图,发送新消息,AI 将从停止的地方继续。

支持的任务类型

功能开发

  • 新功能实现
  • API 端点开发
  • 用户界面组件
  • 数据库模式更改
  • 第三方集成

Bug 修复

  • 错误诊断和修复
  • 性能问题优化
  • 安全漏洞修复
  • 兼容性问题解决
  • 内存泄漏修复

代码重构

  • 代码结构优化
  • 设计模式应用
  • 性能改进
  • 代码规范统一
  • 技术债务清理

测试开发

  • 单元测试编写
  • 集成测试实现
  • 端到端测试
  • 性能测试
  • 测试覆盖率提升

文档编写

  • API 文档生成
  • 用户手册编写
  • 技术规范文档
  • 代码注释完善
  • README 文件更新

最佳实践

1. 清晰的任务描述

提供详细、具体的任务描述:

好的描述:
"为用户注册功能添加邮箱验证,包括发送验证邮件、验证链接处理和过期机制"

不够好的描述:
"添加邮箱验证"

2. 提供足够的上下文

  • 选择相关的项目文件
  • 包含相关的代码片段
  • 提供设计文档或规范
  • 说明技术约束和偏好

3. 分阶段执行

对于复杂任务,考虑分解为多个较小的任务:

  • 每个任务关注单一功能
  • 按依赖关系排序任务
  • 在前一个任务完成后再开始下一个

4. 及时反馈

  • 在 Action Flow 中实时监控进度
  • 及时提供反馈和调整
  • 遇到问题时主动沟通
  • 审查中间结果并提供指导

5. 充分测试

  • 确保 AI 包含测试计划
  • 要求覆盖边缘情况
  • 验证集成和端到端功能
  • 检查性能和安全性

配置和个性化

工作流偏好

您可以配置:

  • 默认的开发流程
  • 代码风格和规范
  • 测试框架偏好
  • 文档格式要求
  • 提交消息规范

项目特定设置

  • 技术栈配置
  • 架构模式偏好
  • 依赖管理策略
  • 部署流程设置
  • 质量检查标准

与其他功能的集成

Quest Mode 与 Qoder 的其他功能深度集成:

  • 记忆系统:利用项目记忆和用户偏好
  • 上下文工程:自动收集相关项目上下文
  • MCP 工具:使用外部工具和服务
  • 代码分析:基于静态分析结果进行优化
  • 版本控制:自动管理代码提交和分支

Quest Mode 将复杂的开发任务自动化,让您专注于高层次的设计和决策,而将繁重的实现工作交给 AI 完成。

📚 Qoder 中文学习指南 - 非官方文档站点 | 每天都有新发现 🎆