Skip to main content
开始一个任务

常见开发任务

概述

这篇文档汇总了用 Qoder CLI 处理日常开发工作的常见做法——从探索陌生代码、修复缺陷、重构,到写测试、提交和审查。每一类都给出可以直接照着说的提示词示例,你可以在此基础上按自己的项目调整。 所有示例都在交互模式下进行。启动方式见 使用 CLI

探索与理解代码

面对陌生的代码库时,先让 Qoder 帮你建立整体认识:
帮我梳理这个项目的整体架构和主要模块
这个功能是在哪里实现的?涉及哪些文件?
从入口开始,讲清楚一次请求是怎么被处理的
这个函数被哪些地方调用?
Qoder 会自主搜索代码、读取相关文件,并给出带有文件位置的解释。你可以顺着它的回答继续追问,逐步深入。

修复缺陷

描述现象,让 Qoder 定位并修复:
这个测试为什么失败?帮我修复它
运行 npm test,找出报错原因并修复
这个接口在并发下会偶发报错,帮我排查
一个稳妥的做法是让 Qoder 先复现问题、说明原因,再动手修改。对于影响面较大的问题,可以先用 Plan 确认方案,见 先规划再执行(Plan)

重构

重构往往涉及多个文件,描述清楚目标和约束:
把 utils 里的日期处理函数抽成独立模块,并更新所有引用
统一这个目录下的错误处理方式,保持对外行为不变
给这些回调改造成 async/await,注意不要改变逻辑
重构前后建议配合测试和代码审查确认行为没有改变,见 查看和审查代码改动。范围较大的重构适合用 Plan 先规划。

实现功能

从需求出发让 Qoder 编码:
实现一个 Express 中间件,做请求频率限制
按这个接口文档,补全对应的客户端方法
给这个页面加上表单校验和错误提示
Qoder 支持多模态输入。你可以附加设计稿或截图,让它据此生成代码。

编写与运行测试

给这个模块补充单元测试,覆盖主要分支
为刚才的改动写一个回归测试
运行测试并修复失败的用例
让 Qoder 在写完代码后主动运行测试,可以形成"实现—验证—修正"的闭环。想让它持续修到全部通过,可以用 Goal,见 持续完成目标(Goal)

提交与 PR

帮我生成这次改动的提交信息
把相关改动分成几个语义清晰的提交
总结这个分支相对 main 的改动,写一段 PR 描述
涉及 Git 操作时,Qoder 会在执行前根据权限设置请求确认。权限控制见 权限

代码审查

在提交前对改动做一次审查:
审查我当前的改动,找出潜在问题
对比 main 分支,审查这个功能分支
也可以直接用 /review 选择审查范围,见 查看和审查代码改动

小贴士

  • 描述清楚目标和约束:说明你想要什么、不希望改动什么,能显著提升结果质量。
  • 一次聚焦一件事:复杂任务拆成几步,比一次性描述所有需求更可控。
  • 善用项目说明:把项目约定写进 AGENTS.md,Qoder 会在每次会话中遵守,见 记忆
  • 大型代码库:针对大仓库和 Monorepo 的做法,见 最佳实践与大型代码库